configure gruppo di comandi

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.

Il configure gruppo di comandi 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 token di accesso personali di Azure Databricks o token di Accesso Microsoft Entra (in precedenza Azure Active Directory).

Nota

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 token di Microsoft Entra ID (in precedenza Azure Active Directory) 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.

Importante

Prima di eseguire questo comando, assicurarsi di configurare l'interfaccia della riga di comando di Databricks.

I comandi vengono eseguiti configure aggiungendoli a databricks configure. Per visualizzare la Guida per il configure comando, eseguire databricks configure -h.

Creare un profilo di configurazione

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.

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

databricks configure --host <workspace-url>

Per <workspace-url>immettere 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.

Il comando richiede di immettere il token di accesso personale di Azure Databricks o l'ID Microsoft Entra (in precedenza Azure Active Directory) che esegue il mapping all'oggetto specificato<workspace-url>:

✔ 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>

Suggerimento

È 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.

L'aggiunta di più profili di connessione 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.

È possibile modificare il percorso predefinito di questo .databrickscfg file impostando la variabile DATABRICKS_CONFIG_FILEdi ambiente . Per informazioni su come impostare le variabili di ambiente, vedere la documentazione del sistema operativo.

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