Esercitazione dell'interfaccia della riga di comando di Databricks

Nota

Queste informazioni si applicano alle versioni dell'interfaccia della riga di comando di Databricks 0.205 e successive, disponibili in anteprima pubblica. Per trovare la versione dell'interfaccia della riga di comando di Databricks, eseguire databricks -v.

L'interfaccia della riga di comando di Databricks (nota anche come interfaccia della riga di comando di Databricks) offre un'interfaccia facile da usare per automatizzare la piattaforma Azure Databricks dal terminale, dal prompt dei comandi o dagli script di automazione.

Questo articolo illustra come usare il computer di sviluppo locale per iniziare rapidamente a usare l'interfaccia della riga di comando di Databricks. Vedere Che cos'è l'interfaccia della riga di comando di Databricks?.

L'esercitazione pratica seguente presuppone:

• Per Linux o macOS, è installato Homebrew .

  Nota

  Se non è possibile usare Homebrew, per altri modi per installare l'interfaccia della riga di comando, vedere Installare o aggiornare l'interfaccia della riga di comando di Databricks.

• Per Windows è installato winget, Chocolatey o sottosistema Windows per Linux (WSL). Per istruzioni sull'installazione, vedere la documentazione del sistema operativo.

  Nota

  L'installazione dell'interfaccia della riga di comando di Databricks con Chocolatey è Sperimentale.

  Se non è possibile usare winget, Chocolatey o WSL, per altri modi per installare l'interfaccia della riga di comando, vedere Installare o aggiornare l'interfaccia della riga di comando di Databricks.

Effettuare i passaggi seguenti:

1. Se non è già installato, installare l'interfaccia della riga di comando di Databricks come indicato di seguito:

   Linux, macOS

   Usare Homebrew per installare l'interfaccia della riga di comando di Databricks eseguendo i due comandi seguenti:

   brew tap databricks/tap
   brew install databricks
   

   Finestre

   È possibile usare winget, Chocolatey o sottosistema Windows per Linux (WSL) per installare l'interfaccia della riga di comando di Databricks. Se non è possibile usare winget, Chocolatey o WSL, è consigliabile ignorare questa procedura e usare il prompt dei comandi o PowerShell per installare l'interfaccia della riga di comando di Databricks dall'origine .

   Nota

   L'installazione dell'interfaccia della riga di comando di Databricks con Chocolatey è Sperimentale.

   Per usare winget per installare l'interfaccia della riga di comando di Databricks, eseguire i due comandi seguenti e quindi riavviare il prompt dei comandi:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

   Per usare Chocolatey per installare l'interfaccia della riga di comando di Databricks, eseguire il comando seguente:

   choco install databricks-cli
   

   Per usare WSL per installare l'interfaccia della riga di comando di Databricks:

   1. Installare curl e zip tramite WSL. Per altre informazioni, vedere la documentazione del sistema operativo.

   2. Usare WSL per installare l'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
      

2. Verificare che l'interfaccia della riga di comando di Databricks sia installata eseguendo il comando seguente, che visualizza la versione corrente dell'interfaccia della riga di comando di Databricks installata. Questa versione deve essere 0.205.0 o successiva:

   databricks -v
   

   Nota

   Se si esegue databricks ma viene visualizzato un errore, command not found: databricksad esempio , o se si esegue databricks -v e viene elencato il numero di versione 0.18 o di seguito, significa che il computer non riesce a trovare la versione corretta dell'eseguibile dell'interfaccia della riga di comando di Databricks. Per risolvere questo problema, vedere Verificare l'installazione dell'interfaccia della riga di comando.

Dopo aver installato l'interfaccia della riga di comando di Databricks, completare la procedura seguente:

Nota

Questa esercitazione presuppone che si voglia usare l'autenticazione da utente a computer (U2M) OAuth per autenticare l'interfaccia della riga di comando usando l'account utente di Azure Databricks. Per configurare l'interfaccia della riga di comando per l'uso di altri tipi di autenticazione di Databricks, vedere Autenticazione per l'interfaccia della riga di comando di Databricks.

1. Usare l'interfaccia della riga di comando di Databricks per avviare la gestione dei token OAuth in locale eseguendo il comando seguente per ogni account o area di lavoro di destinazione.

   Per le operazioni a livello di account, nel comando seguente sostituire i segnaposto seguenti:

   • Sostituire <account-console-url> con Azure Databricks https://accounts.azuredatabricks.net.
   • Sostituire <account-id> con l'ID dell'account Azure Databricks. Vedere Individuare l'ID account.

   databricks auth login --host <account-console-url> --account-id <account-id>
   

   Per le operazioni a livello di area di lavoro, nel comando seguente sostituire <workspace-url> con l'URL di Azure Databricks per area di lavoro, ad esempio https://adb-1234567890123456.7.azuredatabricks.net.

   databricks auth login --host <workspace-url>
   

2. L'interfaccia della riga di comando di Databricks richiede di salvare le informazioni immesse come profilo di configurazione di Azure Databricks. Premere Enter per accettare il nome del profilo suggerito oppure immettere il nome di un profilo nuovo o esistente. Qualsiasi profilo esistente con lo stesso nome viene sovrascritto con le informazioni immesse. È possibile usare i profili per cambiare rapidamente il contesto di autenticazione tra più account o aree di lavoro.

   Per ottenere un elenco di tutti i profili esistenti, in un terminale o un prompt dei comandi separato, usare l'interfaccia della riga di comando di Databricks per eseguire il comando databricks auth profiles. Per visualizzare le impostazioni esistenti di un profilo specifico, eseguire il comando databricks auth env --profile <profile-name>.

3. Nel Web browser completare le istruzioni visualizzate per accedere all'account o all'area di lavoro di Azure Databricks.

4. Per visualizzare il valore corrente del token OAuth di un profilo e il timestamp di scadenza imminente del token, eseguire uno dei comandi seguenti:

   Per le operazioni a livello di account, eseguire i comandi seguenti:

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url> --account-id <account-id>
   • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

   Se sono presenti più profili con gli stessi --host valori e --account-id , potrebbe essere necessario specificare insieme le --hostopzioni , --account-ide -p per consentire all'interfaccia della riga di comando di Databricks di trovare le informazioni corrette sul token OAuth corrispondente.

   Per le operazioni a livello di area di lavoro, eseguire i comandi seguenti:

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url>
   • databricks auth token --host <workspace-url> -p <profile-name>

   Se si dispone di più profili con gli stessi --host valori, potrebbe essere necessario specificare insieme le --host opzioni e -p per consentire all'interfaccia della riga di comando di Databricks di trovare le informazioni corrette corrispondenti sul token OAuth.

Passaggi successivi

Dopo aver configurato l'interfaccia della riga di comando di Databricks:

• Per informazioni su come usare l'interfaccia della riga di comando, vedere Utilizzo di base per l'interfaccia della riga di comando di Databricks.
• Per una panoramica dei comandi dell'interfaccia della riga di comando disponibili, vedere Comandi dell'interfaccia della riga di comando di Databricks.
• Se l'interfaccia della riga di comando non viene eseguita o produce risultati imprevisti, vedere Verificare l'installazione dell'interfaccia della riga di comando.