environments gruppo di comandi

Note

Queste informazioni si applicano all'interfaccia della riga di comando di Databricks versione 0.205 e successive. L'interfaccia della riga di comando di Databricks è disponibile in anteprima pubblica.

L'uso della CLI di Databricks è soggetto alla Licenza di Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.

Il environments gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di gestire le risorse dell'ambiente. L'API Ambienti offre funzionalità di gestione per diversi tipi di ambienti, inclusi gli ambienti di base a livello di area di lavoro che definiscono la versione e le dipendenze dell'ambiente da usare nei notebook e nei processi serverless.

ambienti databricks create-workspace-base-environment

Creare un nuovo ambiente di base dell'area di lavoro. Si tratta di un'operazione a esecuzione prolungata che genera in modo asincrono un ambiente materializzato per ottimizzare la risoluzione delle dipendenze.

databricks environments create-workspace-base-environment DISPLAY_NAME [flags]

Argomenti

DISPLAY_NAME

    Nome visualizzato leggibile per l'ambiente di base dell'area di lavoro.

Options

--base-environment-type BaseEnvironmentType

    Tipo di ambiente di base (CPU o GPU). Valori supportati: CPU, GPU

--filepath string

    Il percorso dei file dell'area di lavoro o dei volumi del catalogo Unity per il file YAML dell'ambiente.

--json JSON

    La stringa JSON inline o il @path nel file JSON che contiene il corpo della richiesta.

--name string

    Nome della risorsa dell'ambiente di base dell'area di lavoro.

--no-wait

    Non attendere di raggiungere DONE lo stato.

--request-id string

    Identificatore univoco per questa richiesta.

--timeout duration

    Quantità massima di tempo per raggiungere DONE lo stato.

--workspace-base-environment-id string

    ID da usare per l'ambiente di base dell'area di lavoro, che diventerà il componente finale del nome della risorsa.

Flag globali

Examples

L'esempio seguente crea un ambiente di base dell'area di lavoro CPU:

databricks environments create-workspace-base-environment "My Python Env" --base-environment-type CPU --filepath /Workspace/environments/env.yaml

ambienti databricks delete-workspace-base-environment

Eliminare un ambiente di base dell'area di lavoro. L'eliminazione di un ambiente di base può influire su notebook e processi collegati. questa operazione è irreversibile.

databricks environments delete-workspace-base-environment NAME [flags]

Argomenti

NAME

    Obbligatorio. Nome della risorsa dell'ambiente di base dell'area di lavoro da eliminare. Formato: workspace-base-environments/{workspace_base_environment}.

Options

Flag globali

Examples

Nell'esempio seguente viene eliminato un ambiente di base dell'area di lavoro:

databricks environments delete-workspace-base-environment workspace-base-environments/my-env-id

Ambienti databricks get-default-workspace-base-environment

Ottenere la configurazione predefinita dell'ambiente di base dell'area di lavoro. Restituisce le impostazioni correnti dell'ambiente di base predefinito per il calcolo della CPU e della GPU.

databricks environments get-default-workspace-base-environment NAME [flags]

Argomenti

NAME

    Nome di risorsa statica dell'ambiente di base dell'area di lavoro predefinito. Formato: default-workspace-base-environment.

Options

Flag globali

Examples

L'esempio seguente ottiene l'ambiente di base dell'area di lavoro predefinito:

databricks environments get-default-workspace-base-environment default-workspace-base-environment

Operazioni get-operation degli ambienti databricks

Ottenere lo stato di un'operazione a esecuzione prolungata. I client possono usare questo metodo per eseguire il polling del risultato dell'operazione.

databricks environments get-operation NAME [flags]

Argomenti

NAME

    Nome della risorsa dell'operazione.

Options

Flag globali

Examples

L'esempio seguente ottiene lo stato di un'operazione a esecuzione prolungata:

databricks environments get-operation operations/1234567890

ambienti databricks get-workspace-base-environment

Ottenere un ambiente di base dell'area di lavoro in base al nome.

databricks environments get-workspace-base-environment NAME [flags]

Argomenti

NAME

    Obbligatorio. Nome della risorsa dell'ambiente di base dell'area di lavoro da recuperare. Formato: workspace-base-environments/{workspace_base_environment}.

Options

Flag globali

Examples

L'esempio seguente ottiene un ambiente di base dell'area di lavoro:

databricks environments get-workspace-base-environment workspace-base-environments/my-env-id

ambienti databricks list-workspace-base-environments

Elencare tutti gli ambienti di base dell'area di lavoro nell'area di lavoro.

databricks environments list-workspace-base-environments [flags]

Argomenti

Nessuno

Options

--page-size int

    Numero massimo di ambienti da restituire per pagina.

--page-token string

    Token di pagina per la paginazione.

Flag globali

Examples

L'esempio seguente elenca tutti gli ambienti di base dell'area di lavoro:

databricks environments list-workspace-base-environments

Ambienti databricks refresh-workspace-base-environment

Aggiornare l'ambiente materializzato per un ambiente di base dell'area di lavoro. Si tratta di un'operazione a esecuzione prolungata che rigenera in modo asincrono l'ambiente materializzato. L'ambiente materializzato esistente rimane disponibile fino alla scadenza.

databricks environments refresh-workspace-base-environment NAME [flags]

Argomenti

NAME

    Obbligatorio. Nome della risorsa dell'ambiente di base dell'area di lavoro da aggiornare. Formato: workspace-base-environments/{workspace_base_environment}.

Options

--no-wait

    Non attendere di raggiungere DONE lo stato.

--timeout duration

    Quantità massima di tempo per raggiungere DONE lo stato.

Flag globali

Examples

L'esempio seguente aggiorna un ambiente di base dell'area di lavoro:

databricks environments refresh-workspace-base-environment workspace-base-environments/my-env-id

Ambienti databricks update-default-workspace-base-environment

Aggiornare la configurazione dell'ambiente di base dell'area di lavoro predefinita. Imposta gli ambienti di base specificati come impostazioni predefinite dell'area di lavoro per il calcolo della CPU e/o della GPU.

databricks environments update-default-workspace-base-environment NAME UPDATE_MASK [flags]

Argomenti

NAME

    Nome della risorsa singleton. Formato: default-workspace-base-environment.

UPDATE_MASK

    Maschera di campo che specifica i campi da aggiornare. Percorsi di campo validi: cpu_workspace_base_environment, gpu_workspace_base_environment. Usare * per aggiornare tutti i campi.

Options

--cpu-workspace-base-environment string

    Ambiente di base dell'area di lavoro predefinito per il calcolo della CPU.

--gpu-workspace-base-environment string

    Ambiente di base dell'area di lavoro predefinito per il calcolo GPU.

--json JSON

    La stringa JSON inline o il @path nel file JSON che contiene il corpo della richiesta.

--name string

    Nome della risorsa singleton.

Flag globali

Examples

L'esempio seguente imposta l'ambiente di base dell'area di lavoro CPU predefinito:

databricks environments update-default-workspace-base-environment default-workspace-base-environment cpu_workspace_base_environment --cpu-workspace-base-environment workspace-base-environments/my-cpu-env

Ambienti databricks update-workspace-base-environment

Aggiornare un ambiente di base dell'area di lavoro esistente. Si tratta di un'operazione a esecuzione prolungata che rigenera in modo asincrono l'ambiente materializzato. L'ambiente materializzato esistente rimane disponibile fino alla scadenza.

databricks environments update-workspace-base-environment NAME DISPLAY_NAME [flags]

Argomenti

NAME

    Nome della risorsa dell'ambiente di base dell'area di lavoro. Formato: workspace-base-environments/{workspace_base_environment}.

DISPLAY_NAME

    Nome visualizzato leggibile per l'ambiente di base dell'area di lavoro.

Options

--base-environment-type BaseEnvironmentType

    Tipo di ambiente di base (CPU o GPU). Valori supportati: CPU, GPU

--filepath string

    Il percorso dei file dell'area di lavoro o dei volumi del catalogo Unity del file YAML dell'ambiente.

--json JSON

    La stringa JSON inline o il @path nel file JSON che contiene il corpo della richiesta.

--name string

    Nome della risorsa dell'ambiente di base dell'area di lavoro.

--no-wait

    Non attendere di raggiungere DONE lo stato.

--timeout duration

    Quantità massima di tempo per raggiungere DONE lo stato.

Flag globali

Examples

L'esempio seguente aggiorna un ambiente di base dell'area di lavoro:

databricks environments update-workspace-base-environment workspace-base-environments/my-env-id "Updated Python Env" --filepath /Workspace/environments/updated-env.yaml

Bandiere globali

--debug

  Indica se abilitare la registrazione di debug.

-h oppure --help

    Mostra la guida per il Databricks CLI, il gruppo di comandi correlato o il comando correlato.

--log-file stringa

    Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.

--log-format formato

    Tipo di formato del log, text o json. Il valore predefinito è text.

--log-level stringa

    Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.

tipo

    Tipo di output del comando, text o json. Il valore predefinito è text.

-p, --profile stringa

    Nome del profilo nel ~/.databrickscfg file da usare per eseguire il comando . Se questo flag non viene specificato, se esiste, viene usato il profilo denominato DEFAULT .

--progress-format formato

    Formato per visualizzare i log di stato: default, append, inplaceo json

-t, --target stringa

    Se applicabile, la destinazione del bundle da utilizzare