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

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 all'Informativa sulla privacy di Databricks e databricks, incluse eventuali disposizioni sui 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 update l'interfaccia della riga di comando di Databricks e profili di configurazione di Azure Databricks.

Get informazioni sui profili di configurazione

L'aggiunta di più profili di configurazione al file di .databrickscfg consente di eseguire rapidamente i comandi in varie aree di lavoro specificando il nome del profilo di configurazione di destinazione nel flag --profile o -p del comando. Se non viene specificato, viene usato il profilo di configurazione DEFAULT.

Suggerimento

È possibile premere Tab dopo --profile o -p per visualizzare un list 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 di .databrickscfg, set la variabile di ambiente DATABRICKS_CONFIG_FILE in un percorso diverso. Vedere variabili di ambiente specifiche di .databrickscfg e campi.

Per le get informazioni su un profilo di configurazione esistente, eseguire il comando auth env:

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

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

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

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

Per get 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 un token di accesso, eseguire il comando precedente auth env .

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 avere set l'autenticazione correttamente, 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 presenti variabili di ambiente set 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