Installare o aggiornare l'interfaccia della riga di comando di Databricks

Nota

L'uso dell'interfaccia della riga di comando di Databricks è soggetto alla Licenza Databricks e all'Informativa sulla Privacy di Databricks, incluse eventuali disposizioni sui Dati di utilizzo.

Questa pagina descrive come installare o aggiornare l'interfaccia della riga di comando di Databricks. Consultare Databricks CLI. Per configurare l'autenticazione il Databricks CLI, consultare Autenticazione per il Databricks CLI.

Installa

Per installare la Databricks CLI versione 0.205 o successiva:

L'interfaccia della riga di comando di Databricks è disponibile anche all'interno dell'area di lavoro Azure Databricks. Consulta Eseguire i comandi dell'interfaccia a riga di comando Databricks.

Aggiornare

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

Installazione homebrew per macOS

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

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

brew tap databricks/tap
brew trust databricks/tap
brew install databricks

Il brew trust comando è obbligatorio a partire da Homebrew 6.0.0, che richiede l'attendibilità esplicita dei tap di terze parti prima che Homebrew caricherà la formula. Anche gli utenti esistenti che hanno toccato prima di eseguire l'aggiornamento a Homebrew 6.0.0 devono eseguire brew trust databricks/tap.

È anche possibile installare in un unico passaggio senza ritenere attendibile l'intero tap:

brew install databricks/tap/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 nel GitHub all'elenco dei repository Homebrew Tap disponibili eseguendo il comando seguente:

    brew tap databricks/tap

  4. Fidati del tocco. A partire da Homebrew 6.0.0, i tap di terze parti devono essere esplicitamente autorizzati prima che Homebrew ne carichi le relative formule. Esegui questo comando:

    brew trust databricks/tap

    Anche gli utenti esistenti che hanno toccato prima di eseguire l'aggiornamento a Homebrew 6.0.0 devono eseguire questo comando.

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

    brew install databricks

  6. Verificare se il CLI di Databricks è installato correttamente. A tale scopo, visualizzare la versione 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 superiore, l'interfaccia della riga di comando di Databricks viene installata correttamente.

  7. 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'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 il CLI di Databricks è installato correttamente. A tale scopo, visualizzare la versione dell'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

    databricks -v

# Or:
databricks version

Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

Installazione di Chocolatey per Windows

Nota

L'installazione della CLI di Databricks con Chocolatey è Sperimentale.

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

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

    choco install databricks-cli

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

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

installazione di curl per Linux, macOS e Windows

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

Per Windows, Databricks consiglia di usare sottosistema Windows per Linux (WSL). Bisogna avere anche unzip installato. Per istruzioni sull'installazione, vedere la documentazione del sistema operativo. Se non è possibile usare WSL, saltare questa procedura e usare il prompt dei comandi o PowerShell per installare Databricks CLI dal sorgente.

  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 versione curl.

    curl -V

  3. Usare curl per scaricare e installare l'interfaccia della riga di comando di Databricks eseguendo il comando seguente. Questo comando fa distinzione tra maiuscole e minuscole.

    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'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 Databricks CLI dal percorso sopra indicato e quindi eseguire di nuovo il comando curl.

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

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

installazione di Source per Linux, macOS e Windows

Con questa opzione di installazione, si scarica manualmente un file .zip e quindi si estrae manualmente Databricks CLI dal file .zip scaricato.

  1. Scarica sul tuo computer di sviluppo locale il file più recente del Databricks CLI .zip, come indicato nella sezione Releases del repository GitHub del Databricks CLI. La versione più recente ha un'etichetta Latest accanto a essa nell'elenco delle versioni. La versione preliminare più recente ha un'etichetta Pre-release ed è più adatta alla sperimentazione e agli early adopter. Il file .zip scaricato dalla sezione Assets per il rilascio deve corrispondere al sistema operativo e all'architettura della macchina di sviluppo:

    Nome del file Architettura
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS, Intel 64 bit / x86_64
    databricks_cli_X.Y.Z_darwin_arm64.zip macOS, Apple Silicon / M Serie / arm64
    databricks_cli_X.Y.Z_linux_amd64.zip Linux, Intel 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 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 -m.
    • Windows: il prompt dei comandi o il comando di PowerShell echo %PROCESSOR_ARCHITECTURE%.

    Se è necessario verificare l'integrità di uno di questi file .zip, Databricks fornisce un file di checksum denominato databricks_cli_X.Y.Z_SHA256SUMS nello stesso elenco dei file .zip. Per eseguire un controllo del checksum, consulta la documentazione del tuo 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 Databricks CLI. Puoi lasciare la CLI di Databricks lì, oppure copiarla o spostarla in un'altra posizione.

  4. Verificare se il CLI di Databricks è installato correttamente. A tale scopo, da un prompt della shell di Linux, dal Terminale di macOS o dal Prompt dei comandi di Windows, visualizzare la versione della CLI di Databricks usando l'opzione -v o eseguendo il comando version:

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

    Nota

    Per macOS, potrebbe essere necessario prima autorizzare il sistema per poter eseguire 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, si usa 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'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'interfaccia della riga di comando di Databricks usando l'opzione -v o eseguendo il version comando :

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

Suggerimento

Per effettuare il downgrade della versione dell'interfaccia della riga di comando di Databricks, vedere le istruzioni nel repository databricks/homebrew-tap in GitHub.

aggiornamento di 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'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

    winget upgrade Databricks.DatabricksCLI

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

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

aggiornamento di Concolatey per Windows

Nota

L'aggiornamento della CLI 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'interfaccia della riga di comando di Databricks eseguendo il comando seguente:

    choco upgrade databricks-cli

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

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

aggiornamento di 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 puoi usare WSL, dovresti saltare questa procedura e usare il prompt dei comandi o PowerShell per aggiornare l'interfaccia della riga di comando di Databricks dalla sorgente invece.

  1. Elimina l'installazione esistente della CLI di Databricks dal percorso /usr/local/bin/databricks su macOS e Linux, o C:\Windows\databricks.exe su Windows.

  2. Da un prompt della shell Linux, dal Terminale di macOS o dal Prompt dei comandi di Windows, usa curl per scaricare e installare la versione più recente di Databricks CLI eseguendo il comando seguente (tieni presente che devi specificare correttamente i caratteri maiuscoli e minuscoli 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'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 il seguente errore, è necessario eliminare manualmente la CLI di Databricks dal percorso indicato sopra e quindi eseguire di nuovo il comando curl: "Il percorso di destinazione <path> esiste già."

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

    databricks -v

# Or:
databricks version

    Se l'output è versione 0.205.0 o successiva, l'interfaccia della riga di comando (CLI) di Databricks viene installata correttamente.

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

aggiornamento di Source per Linux, macOS e Windows

Per questa opzione di aggiornamento, scarica manualmente un file di .zip e quindi estrai manualmente l'eseguibile dell'interfaccia a riga di comando di Databricks dal file scaricato .zip.

  1. Facoltativamente, eliminare l'eseguibile della CLI di Databricks, il file .zip e la cartella estratta del file .zip da una qualsiasi precedente installazione manuale dal codice sorgente.
  2. Continuare seguendo le istruzioni riportate in installazione di Source per Linux, macOS e Windows.
  • Last updated on