configure comando

Note

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

Il configure comando all'interno dell'interfaccia della riga di comando di Databricks consente di autenticare l'interfaccia della riga di comando di Databricks con Azure Databricks usando i token di accesso personale di Azure Databricks o i token di Microsoft Entra ID (in precedenza Azure Active Directory).

Note

Come procedura consigliata per la sicurezza, quando si esegue l'autenticazione con strumenti automatizzati, sistemi, script e app, Databricks consiglia di usare token di accesso personali appartenenti alle entità servizio anziché agli utenti dell'area di lavoro. Per creare token per le entità servizio, vedere Gestire i token per un'entità servizio.

Si noti che questo articolo illustra solo il token di accesso personale di Azure Databricks e l'autenticazione del token ID di Microsoft Entra per abilitare la chiamata di comandi a livello di area di lavoro . Per altre opzioni di configurazione dell'autenticazione, vedere Autenticazione per l'interfaccia della riga di comando di Databricks.

Configurazione di databricks

Configurare un profilo nel ~/.databrickscfg file. Un profilo di configurazione è una raccolta di impostazioni che contiene informazioni di autenticazione, ad esempio un URL dell'area di lavoro di Azure Databricks e un valore del token di accesso.

Un profilo di configurazione ha un nome programmatico, ad esempio DEFAULT, DEVo PROD. L'aggiunta di più profili al .databrickscfg file consente di eseguire rapidamente comandi in varie aree di lavoro specificando il nome del profilo di connessione di destinazione nell'opzione del --profile comando. Se non si specifica l'opzione --profile in un comando che supporta questa opzione, il comando userà il DEFAULT profilo di connessione per impostazione predefinita.

Ad esempio, è possibile avere un profilo di connessione denominato DEV che fa riferimento a un'area di lavoro di Azure Databricks usata per i carichi di lavoro di sviluppo e un profilo di connessione separato denominato PROD profilo di connessione che fa riferimento a un'area di lavoro di Azure Databricks diversa usata per i carichi di lavoro di produzione.

Per ottenere informazioni sui profili di configurazione esistenti, usare il auth gruppo di comandi.

È possibile modificare il percorso predefinito del .databrickscfg file impostando la variabile DATABRICKS_CONFIG_FILEdi ambiente .

Se questo comando viene richiamato in modalità non interattiva, leggerà il token da stdin. L'host deve essere specificato con il --host flag o la DATABRICKS_HOST variabile di ambiente.

databricks configure [flags]

Options

--configure-cluster

    Suggerimenti per configurare il cluster

--host string

    URL dell'host dell'area di lavoro Databricks

L'URL host dell'area di lavoro è l'URL per area di lavoro, con il formato https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Per ottenere l'URL per area di lavoro, vedere URL per area di lavoro.

--profile string

    Nome del profilo di connessione da configurare. (impostazione predefinita "DEFAULT")

Flag globali

Examples

L'esempio seguente configura l'autenticazione per il profilo predefinito:

databricks configure

L'esempio seguente configura l'autenticazione per un profilo specifico:

databricks configure --profile my-profile

L'esempio seguente configura l'autenticazione con un host specifico:

databricks configure --host https://my-workspace.cloud.databricks.com

L'esempio seguente configura l'autenticazione con la configurazione del cluster:

databricks configure --configure-cluster

Bandiere globali

--debug

  Indica se abilitare la registrazione di debug.

-h oppure --help

    Mostra la guida per il Databricks CLI, il gruppo di comandi correlato o il comando correlato.

--log-file stringa

    Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.

--log-format formato

    Tipo di formato del log, text o json. Il valore predefinito è text.

--log-level stringa

    Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.

tipo

    Tipo di output del comando, text o json. Il valore predefinito è text.

-p, --profile stringa

    Nome del profilo nel ~/.databrickscfg file da usare per eseguire il comando . Se questo flag non viene specificato, se esiste, viene usato il profilo denominato DEFAULT .

--progress-format formato

    Formato per visualizzare i log di stato: default, append, inplaceo json

-t, --target stringa

    Se applicabile, la destinazione del bundle da utilizzare

Creare un profilo di configurazione

Per creare un profilo di configurazione, eseguire il configure comando :

databricks configure --host <workspace-url>

Il comando richiede di immettere il token di accesso personale di Azure Databricks oppure il token ID Microsoft Entra (in precedenza Azure Active Directory) che corrisponde al parametro specificato:

✔ Databricks Token:

Dopo aver immesso il token di accesso, il token di accesso viene archiviato nel file ~/.databrickscfg in Linux o macOS o %USERPROFILE%\.databrickscfg in Windows per impostazione predefinita. Il file contiene una voce del profilo di connessione predefinita denominata DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Per usare un nome diverso per il profilo di connessione invece di DEFAULT, aggiungere l'opzione --profile al configure comando, ad esempio:

databricks configure --host <workspace-url> --profile <profile-name>

Tip

È possibile premere Tab dopo --profile o -p per visualizzare un elenco di profili di configurazione disponibili esistenti tra cui scegliere, anziché immettere manualmente il nome del profilo di configurazione.

Tutte le informazioni sull'host e sul token esistenti all'interno del profilo di connessione specificato vengono sovrascritte con le informazioni sul nuovo host e sul token.