Installare o aggiornare l'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.

Questo articolo descrive come installare o aggiornare l'interfaccia della riga di comando di Databricks. Vedere Che cos'è l'interfaccia della riga di comando di Databricks?.

Installare

Per installare l'interfaccia della riga di comando di Databricks versione 0.205 o successiva:

• Linux o macOS: usare homebrew, curl o build di origine.
• Windows: usare WinGet, Chocolatey, sottosistema Windows per Linux (WSL) o compilazioni di origine.

L'interfaccia della riga di comando di Databricks è disponibile anche dall'interfaccia utente dell'area di lavoro di Azure Databricks. Vedere Eseguire l'interfaccia della riga di comando di Databricks dall'interno di un'area di lavoro di Azure Databricks.

Aggiornamento

Per aggiornare un'installazione precedente dell'interfaccia della riga di comando di Databricks versione 0.205 o successiva:

• Linux o macOS: usare homebrew, curl o build di origine.
• Windows: usare WinGet, Chocolatey, sottosistema Windows per Linux (WSL) o compilazioni di origine.

Installazione homebrew per Linux o macOS

Per questa opzione di installazione, usare Homebrew per scaricare e installare automaticamente la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks.

Dal terminale eseguire i due comandi Homebrew seguenti per installare l'interfaccia della riga di comando:

brew tap databricks/tap
brew install databricks

Continuare quindi con l'autenticazione per l'interfaccia della riga di comando di Databricks.

Se non si è certi se Homebrew è installato o se i comandi homebrew precedenti hanno esito negativo, seguire queste istruzioni più lunghe:

1. Controllare se Homebrew è già installato eseguendo il comando seguente da un prompt della shell Linux o da un terminale macOS. Se Homebrew è installato, viene visualizzato il numero di versione homebrew:

   brew -v
   

2. Se Homebrew non è già installato, installarlo eseguendo il comando seguente:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   Eseguire quindi il comando seguente per verificare l'installazione di Homebrew, che visualizza il numero di versione homebrew:

   brew -v
   

3. Usare Homebrew per aggiungere il repository databricks/homebrew-tap in GitHub all'elenco dei repository Homebrew Tap disponibili eseguendo il comando seguente:

   brew tap databricks/tap
   

4. Usare Homebrew per indicare al databricks/homebrew-tap repository di scaricare e installare l'eseguibile dell'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

   brew install databricks
   

5. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se è elencato un numero di versione 0.205.0 o versione successiva, significa che l'interfaccia della riga di comando di Databricks è installata correttamente.

   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.

6. Continuare con l'autenticazione per l'interfaccia della riga di comando di Databricks.

Installazione di WinGet per Windows

Per questa opzione di installazione, si usa winget per scaricare e installare automaticamente la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks.

1. Dal prompt dei comandi eseguire i due winget comandi seguenti per installare l'interfaccia della riga di comando e quindi riavviare il prompt dei comandi:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

2. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se è elencato un numero di versione 0.205.0 o versione successiva, significa che l'interfaccia della riga di comando di Databricks è installata correttamente.

   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.

3. Continuare con l'autenticazione per l'interfaccia della riga di comando di Databricks.

Installazione di Chocolatey per Windows

Nota

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

Per questa opzione di installazione, si usa Chocolatey per scaricare e installare automaticamente la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks.

1. Dal prompt dei comandi eseguire il comando seguente choco per installare l'interfaccia della riga di comando:

   choco install databricks-cli
   

2. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se è elencato un numero di versione 0.205.0 o versione successiva, significa che l'interfaccia della riga di comando di Databricks è installata correttamente.

   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.

3. Continuare con l'autenticazione per l'interfaccia della riga di comando di Databricks.

installazione curl per Linux, macOS e Windows

Per questa opzione di installazione, usare curl per scaricare e installare la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks.

Per Windows, Databricks consiglia di usare sottosistema Windows per Linux (WSL). È necessario aver unzip installato anche . Per istruzioni sull'installazione, vedere la documentazione del sistema operativo. Se non è possibile usare WSL, ignorare questa procedura e usare il prompt dei comandi o PowerShell per installare l'interfaccia della riga di comando di Databricks dall'origine .

1. curl deve essere installato. È possibile verificare se curl è già installato eseguendo il comando seguente da un prompt della shell Linux, da un terminale macOS o Bash in WSL. Se curl è installato, viene visualizzato il numero di curl versione:

   curl -V
   

2. Se curl non è già installato, installarlo seguendo le istruzioni nella curlpagina Versioni e download per il sistema operativo e l'architettura. Per ottenere l'architettura del computer, vedere la documentazione del sistema operativo.

   Eseguire quindi il comando seguente per verificare l'installazione curl , che visualizza il numero di curl versione:

   curl -V
   

3. Usare curl per scaricare e installare l'eseguibile dell'interfaccia della riga di comando di Databricks eseguendo il comando seguente . Si noti che è necessario specificare i caratteri maiuscoli e minuscoli corretti per -fsSL in tutti i sistemi operativi:

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

   Nota

   Per visualizzare il contenuto dello script prima di eseguirlo, vedere il file install.sh nel repository di installazione dell'interfaccia della riga di comando di Databricks in GitHub.

   Per Windows, è necessario eseguire questo comando come amministratore.

   Per Linux e macOS, se un messaggio di errore indica che /usr/local/bin non è scrivibile, eseguire di nuovo il comando con sudo.

   Questo comando scarica e installa l'eseguibile dell'interfaccia della riga di comando di Databricks nel percorso /usr/local/bin/databricks in macOS e Linux e C:\Windows\databricks.exe in Windows.

   Se per qualche motivo l'interfaccia della riga di comando di Databricks è già installata, viene visualizzato l'errore seguente: "Percorso <path> di destinazione già esistente". Per risolvere questo problema, è necessario eliminare manualmente l'eseguibile dell'interfaccia della riga di comando di Databricks dal percorso precedente e quindi eseguire di nuovo il curl comando.

4. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se è elencato un numero di versione 0.205.0 o versione successiva, significa che l'interfaccia della riga di comando di Databricks è installata correttamente.

   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.

5. Continuare con l'autenticazione per l'interfaccia della riga di comando di Databricks.

Installazione di origine per Linux, macOS e Windows

Per questa opzione di installazione, scaricare manualmente un .zip file e quindi estrarre manualmente l'eseguibile dell'interfaccia della riga di comando di Databricks dal file scaricato .zip .

1. Scaricare nel computer di sviluppo locale il file dell'interfaccia della riga di comando di Databricks .zip più recente, come indicato nella sezione Versioni del repository dell'interfaccia della riga di comando di Databricks in GitHub. La versione più recente include un'etichetta Latest accanto all'etichetta nell'elenco delle versioni. La versione preliminare più recente ha un'etichetta Pre-release ed è più adatta alla sperimentazione e agli early adopter. Il .zip file scaricato dalla Assets sezione per la versione deve corrispondere al sistema operativo e all'architettura del computer di sviluppo:

   Filename	Architettura
   databricks_cli_X.Y.Z_darwin_amd64.zip	macOS, Intel a 64 bit/ x86_64
   databricks_cli_X.Y.Z_darwin_arm64.zip	macOS, Apple Silicon / M Series / arm64
   databricks_cli_X.Y.Z_linux_amd64.zip	Linux, Intel a 64 bit/ x86_64
   databricks_cli_X.Y.Z_linux_arm64.zip	Linux, ARM a 64 bit/ arm64
   databricks_cli_X.Y.Z_windows_386.zip	Windows, Intel a 32 bit/ x86
   databricks_cli_X.Y.Z_windows_amd64.zip	Windows, Intel a 64 bit/ AMD64
   databricks_cli_X.Y.Z_windows_arm64.zip	Windows, ARM a 64 bit/ ARM64

   Per ottenere l'architettura del computer, vedere la documentazione del sistema operativo. Ad esempio:

   • Linux: comandi del uname -mterminale , lscpuo sudo lshw -c cpu.
   • macOS: menu> icona Apple Informazioni su Questo Mac o il comando uname -mTerminale .
   • Windows: il prompt dei comandi o il comando echo %PROCESSOR_ARCHITECTURE%di PowerShell .

   Se è necessario verificare l'integrità di uno di questi .zip file, Databricks fornisce un file di checksum denominato databricks_cli_X.Y.Z_SHA256SUMS nello stesso elenco dei .zip file. Per eseguire una verifica checksum, vedere la documentazione del sistema operativo.

2. Estrarre il contenuto del file scaricato .zip . Per estrarre il .zip file, vedere la documentazione del sistema operativo.

3. Nel contenuto estratto viene visualizzata una cartella con lo stesso nome del .zip file. All'interno di questa cartella è presente l'eseguibile dell'interfaccia della riga di comando di Databricks. È possibile lasciare il file eseguibile dell'interfaccia della riga di comando di Databricks oppure copiarlo o spostarlo in un'altra posizione.

4. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, da un prompt della shell Linux, dal terminale macOS o dal prompt dei comandi di Windows, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se è elencato un numero di versione 0.205.0 o versione successiva, significa che l'interfaccia della riga di comando di Databricks è installata correttamente.

   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.

   Per macOS, potrebbe essere necessario autorizzare il sistema a poter eseguire prima l'interfaccia della riga di comando di Databricks. Vedi Aprire un'app Mac da uno sviluppatore non identificato.

5. Continuare con l'autenticazione per l'interfaccia della riga di comando di Databricks.

Aggiornamento homebrew per Linux o macOS

Per questa opzione di aggiornamento, usare Homebrew per aggiornare automaticamente un'installazione precedente dell'interfaccia della riga di comando di Databricks versione 0.205 o successiva alla versione più recente.

1. Da un prompt della shell Linux o da un terminale macOS, usare Homebrew per scaricare e aggiornare la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

   brew upgrade databricks
   

2. Verificare se l'interfaccia della riga di comando di Databricks è stata aggiornata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se viene visualizzato il numero di versione aggiornato previsto, l'interfaccia della riga di comando di Databricks viene installata correttamente.

   Per un elenco delle versioni dell'interfaccia della riga di comando di Databricks, vedere la sezione Versioni del repository dell'interfaccia della riga di comando di Databricks in GitHub. La versione più recente include un'etichetta Latest accanto all'etichetta nell'elenco delle versioni.

   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.

Aggiornamento WinGet per Windows

Per questa opzione di aggiornamento, si usa winget per scaricare e aggiornare automaticamente una versione precedente dell'interfaccia della riga di comando di Databricks versione 0.205 o successiva alla versione più recente.

1. Dal prompt dei comandi usare winget per scaricare e aggiornare la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

   winget upgrade Databricks.DatabricksCLI
   

2. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se viene visualizzato il numero di versione aggiornato previsto, l'interfaccia della riga di comando di Databricks viene installata correttamente.

   Per un elenco delle versioni dell'interfaccia della riga di comando di Databricks, vedere la sezione Versioni del repository dell'interfaccia della riga di comando di Databricks in GitHub. La versione più recente include un'etichetta Latest accanto all'etichetta nell'elenco delle versioni.

   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.

Aggiornamento di Chocolatey per Windows

Nota

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

Per questa opzione di aggiornamento, si usa Chocolatey per scaricare e aggiornare automaticamente una versione precedente dell'interfaccia della riga di comando di Databricks versione 0.205 o successiva alla versione più recente.

1. Dal prompt dei comandi usare choco per scaricare e aggiornare la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

   choco upgrade databricks-cli
   

2. Verificare se l'interfaccia della riga di comando di Databricks è installata correttamente. A tale scopo, visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se viene visualizzato il numero di versione aggiornato previsto, l'interfaccia della riga di comando di Databricks viene installata correttamente.

   Per un elenco delle versioni dell'interfaccia della riga di comando di Databricks, vedere la sezione Versioni del repository dell'interfaccia della riga di comando di Databricks in GitHub. La versione più recente include un'etichetta Latest accanto all'etichetta nell'elenco delle versioni.

   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.

aggiornamento curl per Linux, macOS e Windows

Per questa opzione di aggiornamento, si usa curl per scaricare e aggiornare automaticamente un'installazione precedente dell'interfaccia della riga di comando di Databricks versione 0.205 o successiva alla versione più recente.

Per Windows, Databricks consiglia di usare sottosistema Windows per Linux (WSL). È necessario aver unzip installato . Per istruzioni sull'installazione, vedere la documentazione del sistema operativo. Se non è possibile usare WSL, ignorare questa procedura e usare il prompt dei comandi o PowerShell per aggiornare l'interfaccia della riga di comando di Databricks dall'origine .

1. Eliminare l'installazione esistente dell'eseguibile dell'interfaccia della riga di comando di Databricks dal percorso /usr/local/bin/databricks in macOS e Linux o C:\Windows\databricks.exe in Windows.

2. Da un prompt della shell linux, un terminale macOS o un prompt dei comandi di Windows, usare curl per scaricare e installare la versione più recente dell'eseguibile dell'interfaccia della riga di comando di Databricks eseguendo il comando seguente (si noti che è necessario specificare i caratteri maiuscoli e minuscoli corretti per -fsSL):

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

   Nota

   Per visualizzare il contenuto dello script prima di eseguirlo, vedere il file install.sh nel repository di installazione dell'interfaccia della riga di comando di Databricks in GitHub.

   Per Windows, è necessario eseguire questo comando come amministratore.

   Per Linux e macOS, se un messaggio di errore indica che /usr/local/bin non è scrivibile, eseguire di nuovo il comando con sudo.

   Questo comando scarica e installa l'eseguibile dell'interfaccia della riga di comando di Databricks nel percorso /usr/local/bin/databricks in macOS e Linux e C:\Windows\databricks.exe in Windows.

   Se viene visualizzato l'errore seguente, è necessario eliminare manualmente l'eseguibile dell'interfaccia della riga di comando di Databricks dal percorso precedente e quindi eseguire di nuovo il curl comando : "Percorso <path> di destinazione già esistente".

3. Verificare se l'interfaccia della riga di comando di Databricks è stata aggiornata correttamente. A tale scopo, dal terminale visualizzare la versione dell'eseguibile dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

   databricks -v
   
   # Or:
   databricks version
   

   Se viene visualizzato il numero di versione aggiornato previsto, l'interfaccia della riga di comando di Databricks viene installata correttamente.

   Per un elenco delle versioni dell'interfaccia della riga di comando di Databricks, vedere la sezione Versioni del repository dell'interfaccia della riga di comando di Databricks in GitHub. La versione più recente include un'etichetta Latest accanto all'etichetta nell'elenco delle versioni.

   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.

Aggiornamento di origine per Linux, macOS e Windows

Per questa opzione di aggiornamento, scaricare manualmente un .zip file e quindi estrarre manualmente l'eseguibile dell'interfaccia della riga di comando di Databricks dal file scaricato .zip .

1. Facoltativamente, eliminare l'eseguibile dell'interfaccia della riga di comando di Databricks, il .zip file e la .zip cartella estratta del file da qualsiasi procedura di installazione manuale precedente dell'origine.
2. Continuare seguendo le istruzioni riportate in Installazione di origine per Linux, macOS e Windows.

Eseguire l'interfaccia della riga di comando di Databricks dall'interno di un'area di lavoro di Azure Databricks

È possibile accedere all'interfaccia della riga di comando di Databricks dal terminale Web all'interno di un notebook connesso a un cluster in esecuzione o direttamente dal terminale Web per un cluster in esecuzione. L'interfaccia della riga di comando disponibile è sempre la versione più recente e l'autenticazione si basa sull'utente corrente. Il cluster deve soddisfare i requisiti seguenti:

• Nel cluster deve essere installato Databricks Runtime 15.0 o versione successiva.
• Il cluster deve usare una modalità di accesso al cluster di Utente singolo o Nessun isolamento condiviso. La modalità di accesso al cluster condiviso non è supportata.
• L'ambiente di calcolo serverless non è supportato.
• L'area di lavoro non deve essere abilitata per collegamento privato.

Per accedere all'interfaccia della riga di comando dal terminale Web per un notebook, eseguire le operazioni seguenti:

1. Connessione il notebook a un cluster che soddisfi i requisiti precedenti.

2. Nella parte inferiore della barra laterale destra del notebook fare clic sull'icona Apri pannello inferiore.

3. Usare l'interfaccia della riga di comando nel riquadro Terminale visualizzato. Ad esempio, il comando seguente stampa informazioni sull'utente corrente:

   databricks current-user me
   

Per accedere all'interfaccia della riga di comando dal terminale Web per un cluster, eseguire le operazioni seguenti:

1. Nella barra laterale dell'area di lavoro fare clic su Calcolo.

2. Nella scheda Calcolo tutto scopo fare clic sul nome di un cluster che soddisfa i requisiti precedenti.

3. Fare clic su Inizia.

4. Dopo l'avvio del cluster, nella scheda App fare clic su Terminale Web.

5. Usare l'interfaccia della riga di comando nel terminale Web di Databricks visualizzato. Ad esempio, il comando seguente stampa informazioni sull'utente corrente:

   databricks current-user me