Profili di configurazione per l'interfaccia della riga di comando di Databricks

Nota

L'uso di Databricks CLI è soggetto alla Licenza Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni relative ai Dati di utilizzo.

Questo articolo descrive come usare l'interfaccia della riga di comando di Databricks con i profili di configurazione. Si presuppone che sia già stata installata l'interfaccia della riga di comando di Databricks e che sia stato creato un file di profili di configurazione di Databricks. Vedere Installare o aggiornare l'interfaccia della riga di comando di Databricks e profili di configurazione di Azure Databricks.

Ottenere informazioni sui profili di configurazione

L'aggiunta di più profili di configurazione al .databrickscfg file consente di eseguire rapidamente comandi in varie aree di lavoro specificando il nome del profilo di configurazione di destinazione nel flag o --profile nel comando-p. Se non si specifica un profilo, l'interfaccia della riga di comando ne seleziona una nell'ordine seguente:

  1. Variabile DATABRICKS_CONFIG_PROFILE di ambiente, se impostata.
  2. L'impostazione default_profile nella sezione [__settings__] di .databrickscfg, se presente. È possibile impostare questo valore con databricks auth switch. Vedere l'opzione di autenticazione di Databricks.
  3. Il profilo DEFAULT.

Suggerimento

È possibile premere Tab dopo --profile o -p per visualizzare un elenco di profili di configurazione disponibili esistenti da cui scegliere.

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

Per impostazione predefinita, l'interfaccia della riga di comando di Databricks cerca il .databrickscfg file nella cartella (home page dell'utente) in ~ Unix, Linux o macOS o nella %USERPROFILE% cartella (home page dell'utente) in Windows. Per modificare il percorso predefinito del file .databrickscfg, impostare la variabile di ambiente DATABRICKS_CONFIG_FILE su un percorso diverso. Vedere campi specifici di .databrickscfg.

Per ottenere informazioni su un profilo di configurazione esistente, eseguire il comando auth describe:

databricks auth describe --profile <configuration-profile-name>

Ecco ad esempio l'output di un profilo configurato con l'autenticazione del token di accesso personale di Azure Databricks:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Nota

Il comando auth env è deprecato. Usare databricks auth describe per esaminare la configurazione di un profilo o databricks auth token recuperare un token di accesso OAuth memorizzato nella cache.

Per ottenere informazioni su tutti i profili disponibili, eseguire il comando auth profiles:

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

L'output del comando auth profiles non visualizza token di accesso. Per visualizzare i dettagli del token per un profilo specifico, eseguire databricks auth describe --profile <profile-name> o databricks auth token --profile <profile-name>.

Importante

L'interfaccia della riga di comando di Databricks non funziona con un file .netrc. È possibile avere un .netrc file nell'ambiente per altri scopi, ma l'interfaccia della riga di comando di Databricks non userà tale .netrc file.

Testare i profili di configurazione

Per testare i profili di configurazione e verificare di aver configurato correttamente l'autenticazione, eseguire un comando che si connette a un'area di lavoro.

Se non si specifica un profilo, viene usato il profilo predefinito. Ad esempio, il comando seguente elenca le versioni di Databricks Runtime disponibili per l'area di lavoro di Azure Databricks associata al profilo di DEFAULT.

Nota

Questo comando presuppone che non siano impostate variabili di ambiente che hanno la precedenza sulle impostazioni nel profilo di DEFAULT. Per altre informazioni, vedere Ordine di autenticazione della valutazione.

databricks clusters spark-versions

Per verificare un profilo di configurazione specifico, specificare il nome del profilo usando il flag -p.

databricks clusters spark-versions -p PROD
  • Last updated on