Utilizzo di base per l'interfaccia della riga di comando di Databricks

Nota

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 dell'interfaccia della riga di comando di Databricks è soggetto all'Informativa sulla privacy di Databricks e databricks, incluse eventuali disposizioni sui dati di utilizzo.

Questo articolo illustra come elencare i gruppi e i comandi dell'interfaccia della riga di comando di Databricks, visualizzare la Guida dell'interfaccia della riga di comando di Databricks e usare l'output dell'interfaccia della riga di comando di Databricks. Consultare Che cos'è il Databricks CLI?.

Questo articolo presuppone che sia già stata installata l'interfaccia della riga di comando di Databricks e che sia stata configurata l'interfaccia della riga di comando per l'autenticazione. Consultare Installare o aggiornare l'interfaccia della riga di comando di Databricks e l'autenticazione per l'interfaccia della riga di comando di Databricks.

Elencare i gruppi di comandi dell'interfaccia della riga di comando

È possibile elencare i gruppi di comandi usando l'opzione --help o -h . Ad esempio:

databricks -h

Elencare i comandi dell'interfaccia della riga di comando

È possibile elencare i comandi per qualsiasi gruppo di comandi usando l'opzione --help o -h . Ad esempio, per elencare i clusters comandi:

databricks clusters -h

Visualizzare la Guida dei comandi dell'interfaccia della riga di comando

Per visualizzare la Guida per un comando, usare l'opzione --help o -h . Ad esempio, per visualizzare la Guida per il clusters list comando:

databricks clusters list -h

Eseguire un comando

Le informazioni complete sull'utilizzo e la sintassi per i singoli comandi sono disponibili nella Guida della riga di comando, ma i comandi dell'interfaccia della riga di comando di Databricks sono generalmente conformi alla sintassi seguente:

databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]

Non tutti i comandi hanno sottocomandi aggiuntivi. Sono disponibili flag globali e alcuni comandi hanno flag aggiuntivi. Ad esempio, il comando seguente restituisce i cluster disponibili usando un flag specifico del comando:

databricks clusters list --can-use-client JOBS

Suggerimento

È possibile eseguire i comandi dell'interfaccia della riga di comando di Databricks dall'interno di un'area di lavoro di Databricks usando il terminale Web. Il terminale Web può essere usato da molti utenti in un ambiente di calcolo e non richiede la configurazione delle chiavi. Vedere Eseguire i comandi della shell nel terminale Web di Azure Databricks.

Usare jq per filtrare l'output JSON

Alcuni comandi dell'interfaccia della riga di comando di Databricks generano json, il che significa che è possibile usare jq per filtrare l'output. Ad esempio, per elencare solo il nome visualizzato di un cluster Azure Databricks con l'ID cluster specificato:

databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name

My-11.3-LTS-Cluster

È possibile eseguire l'installazione jq in macOS usando Homebrew con brew install jq o in Windows usando Chocolatey con choco install jq. Per altre informazioni su jq, vedere il manuale di jq.

Parametri della stringa JSON

Il formato dei parametri stringa viene gestito in modo diverso in JSON a seconda del sistema operativo:

Linux o macOS

È necessario racchiudere i parametri di stringa JSON tra virgolette doppie ed è necessario racchiudere l'intero payload JSON tra virgolette singole. Alcuni esempi:

'{"cluster_id": "1234-567890-abcde123"}'

'["20230323", "Amsterdam"]'

Finestre

È necessario racchiudere i parametri della stringa JSON e l'intero payload JSON tra virgolette doppie e i caratteri tra virgolette doppie all'interno del payload JSON devono essere preceduti da \. Alcuni esempi:

"{\"cluster_id\": \"1234-567890-abcde123\"}"

"[\"20230323\", \"Amsterdam\"]"

Configurazione del server proxy

Per instradare le richieste e le risposte dell'interfaccia della riga di comando di Databricks tramite un server proxy, impostare la HTTPS_PROXY variabile di ambiente nel computer in cui è installata l'interfaccia della riga di comando di Databricks nell'URL del server proxy.

Per impostare le variabili di ambiente, si veda la documentazione relativa al sistema operativo Windows utilizzato.