Konfigurationsprofiler för Databricks CLI

Den här artikeln beskriver hur du använder Databricks CLI med konfigurationsprofiler. Det förutsätter att du redan har installerat Databricks CLI och skapat en Databricks-konfigurationsprofilfil. Se Installera eller uppdatera konfigurationsprofilerna för Databricks CLI och Azure Databricks.

Hämta information om konfigurationsprofiler

Genom att lägga till flera konfigurationsprofiler i .databrickscfg filen kan du snabbt köra kommandon på olika arbetsytor genom att ange målkonfigurationsprofilens namn i kommandots --profile eller -p flaggan. Om du inte anger någon profil väljer CLI en i följande ordning:

1. Miljövariabeln DATABRICKS_CONFIG_PROFILE , om den anges.
2. Inställningen default_profile i avsnittet [__settings__] i .databrickscfg, om den finns. Du kan ange detta med databricks auth switch. Se databricks auth switch.
3. DEFAULT-profilen.

Du kan till exempel ha en konfigurationsprofil med namnet DEV som refererar till en Azure Databricks-arbetsyta som du använder för utvecklingsarbetsbelastningar och en separat konfigurationsprofil med namnet PROD som refererar till en annan Azure Databricks-arbetsyta som du använder för produktionsarbetsbelastningar.

Som standard letar .databrickscfg Databricks CLI efter filen i mappen ~ (ditt användarhem) i Unix, Linux eller macOS eller mappen %USERPROFILE% (ditt användarhem) i Windows. Om du vill ändra standardsökvägen för filen .databrickscfg anger du miljövariabeln DATABRICKS_CONFIG_FILE till en annan sökväg. Se .databrickscfg-specifika fält.

Om du vill få information om en befintlig konfigurationsprofil kör du kommandot auth describe:

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

Här är till exempel utdata för en profil som har konfigurerats med personlig åtkomsttokenautentisering i 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

Om du vill få information om alla tillgängliga profiler kör du kommandot 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

Kommandots auth profiles utdata visar inga åtkomsttoken. Om du vill visa tokeninformation för en specifik profil, kör databricks auth describe --profile <profile-name> eller databricks auth token --profile <profile-name>.

Testa dina konfigurationsprofiler

Om du vill testa konfigurationsprofilerna och kontrollera att du har konfigurerat autentiseringen korrekt kör du ett kommando som ansluter till en arbetsyta.

Om du inte anger någon profil används standardprofilen. Följande kommando visar till exempel tillgängliga Databricks Runtime-versioner för Azure Databricks-arbetsytan som är associerad med din DEFAULT profil.

databricks clusters spark-versions

Om du vill verifiera en specifik konfigurationsprofil anger du profilnamnet med hjälp av flaggan -p.

databricks clusters spark-versions -p PROD