Condividi tramite

Esercitazione su Databricks CLI

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 alla Licenza Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.

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. Consultare Databricks CLI.

Questo articolo illustra come installare e configurare rapidamente l'interfaccia della riga di comando di Databricks.

Confermare i requisiti della macchina locale

Il tutorial presuppone che:

Installare la CLI di Databricks

  1. Installare l'interfaccia della riga di comando di Databricks:

    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

    Windows

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

    Nota

    L'installazione della CLI 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

Configurare l'accesso all'area di lavoro

Configurare quindi l'accesso all'area di lavoro di Databricks.

Nota

Questa esercitazione usa l'autenticazione OAuth da utente a macchina (U2M) per autenticare l'accesso alla CLI usando il tuo 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:

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

    Per le operazioni a livello di workspace, nel comando seguente sostituire <workspace-url> con l'URL Azure Databricks per-workspace, 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 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 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 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 valori di --host e --account-id, potrebbe essere necessario specificare le opzioni --host, --account-ide -p insieme 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 sono presenti più profili con gli stessi valori di --host, potrebbe essere necessario specificare le opzioni di --host e -p insieme per consentire all'interfaccia della riga di comando di Databricks di trovare le informazioni corrette sul token OAuth corrispondente.

Passaggi successivi

  • Last updated on