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 configurare l'autenticazione tra il Databricks CLI e gli account e le aree di lavoro di Azure Databricks. Consultare Che cos'è il Databricks CLI?.

Questo articolo presuppone che sia già stata installata l'interfaccia della riga di comando di Databricks e che sia stata configurata l'interfaccia della riga di comando per l'autenticazione. Vedere:

• Installare o aggiornare l'interfaccia della riga di comando di Databricks
• Autenticazione per l'interfaccia della riga di comando di 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 --profile configurazione di destinazione nell'opzione o -p del comando, per i comandi che supportano questa opzione. Se non si specifica l'opzione --profile o -p in un comando che supporta questa opzione, il comando userà il DEFAULT profilo di configurazione per impostazione predefinita.

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.

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. È possibile modificare il percorso predefinito del .databrickscfg file impostando la variabile DATABRICKS_CONFIG_FILEdi ambiente . Per informazioni su come impostare le variabili d’ambiente, consultare la documentazione del sistema operativo.

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

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": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

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

databricks auth profiles

Output (i puntini di sospensione rappresentano il contenuto omesso, per brevità):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

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 la configurazione del profilo di configurazione PREDEFINITa

Per verificare se l'autenticazione è stata configurata correttamente, è possibile eseguire un comando come il seguente, che elenca le versioni di Databricks Runtime disponibili per l'area di lavoro di Azure Databricks associata al DEFAULT profilo.

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

databricks clusters spark-versions

Testare i profili di configurazione

Per verificare se si configurano correttamente profili di configurazione, è possibile eseguire un comando come il seguente con uno dei nomi dei profili di configurazione a livello di area di lavoro. Questo comando elenca le versioni di Databricks Runtime disponibili per l'area di lavoro di Azure Databricks associata al profilo di configurazione specificato, rappresentato qui dal segnaposto <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-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.

Per elencare i dettagli di un profilo specifico, eseguire il comando seguente:

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

Per elencare i dettagli per tutti i profili disponibili, eseguire il comando seguente:

databricks auth profiles