Konfigurationsprofiler för Databricks CLI

  • Artikel

Kommentar

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare, som finns i offentlig förhandsversion. Kör för att hitta din version av Databricks CLI databricks -v.

Den här artikeln beskriver hur du konfigurerar autentisering mellan Databricks CLI och dina Azure Databricks-konton och arbetsytor. Se Vad är Databricks CLI?.

Den här artikeln förutsätter att du redan har installerat Databricks CLI och konfigurerat CLI för autentisering. Se:

Hämta information om konfigurationsprofiler

Genom att lägga till .databrickscfg flera konfigurationsprofiler i filen kan du snabbt köra kommandon på olika arbetsytor genom att ange målkonfigurationsprofilens namn i kommandots --profile eller -p alternativet för de kommandon som stöder det här alternativet. Om du inte anger --profile alternativet eller -p i ett kommando som stöder det här alternativet använder kommandot konfigurationsprofilen DEFAULT som standard.

Dricks

Du kan trycka Tab efter --profile eller -p visa en lista över befintliga tillgängliga konfigurationsprofiler att välja mellan, i stället för att ange namnet på konfigurationsprofilen manuellt.

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. Du kan ändra standardsökvägen för .databrickscfg filen genom att ange miljövariabeln DATABRICKS_CONFIG_FILE. Information om hur du anger miljövariabler finns i dokumentationen för ditt operativsystem.

Kör kommandot för att få information om en befintlig konfigurationsprofil auth env :

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

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

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

Här är till exempel utdata för en profil som har konfigurerats med personlig åtkomsttokenautentisering i Azure Databricks:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

Kör kommandot för att få information om alla tillgängliga profiler auth profiles :

databricks auth profiles

Utdata (ellipserna representerar utelämnat innehåll, för korthet):

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

Kommandots auth profiles utdata visar inga åtkomsttoken. Om du vill visa en åtkomsttoken kör du föregående auth env kommando.

Viktigt!

Databricks CLI fungerar inte med en .netrc-fil. Du kan ha en .netrc fil i din miljö för andra ändamål, men Databricks CLI använder inte den .netrc filen.

Testa konfigurationsprofilkonfigurationen för STANDARD

Om du vill kontrollera om du konfigurerar autentiseringen korrekt kan du köra ett kommando, till exempel följande, som visar de tillgängliga Databricks Runtime-versionerna för Azure Databricks-arbetsytan som är associerad med din DEFAULT profil.

Följande anrop förutsätter att du inte har några särskilda miljövariabler angivna, vilket har företräde framför inställningarna i din DEFAULT profil. Mer information finns i Utvärderingsordning för autentisering.

databricks clusters spark-versions

Testa dina konfigurationsprofiler

Om du vill kontrollera om du konfigurerar konfigurationsprofiler korrekt kan du köra ett kommando, till exempel följande med något av konfigurationsprofilnamnen på arbetsytan. Det här kommandot visar tillgängliga Databricks Runtime-versioner för Azure Databricks-arbetsytan som är associerad med den angivna konfigurationsprofilen, som representeras här av platshållaren <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-profile-name>

Dricks

Du kan trycka Tab efter --profile eller -p visa en lista över befintliga tillgängliga konfigurationsprofiler att välja mellan, i stället för att ange namnet på konfigurationsprofilen manuellt.

Kör följande kommando för att visa information om en specifik profil:

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

Kör följande kommando för att visa information om alla tillgängliga profiler:

databricks auth profiles