Dela via


Konfigurationsprofiler för Databricks CLI

Kommentar

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

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 update konfigurationsprofilerna för Databricks CLI och Azure Databricks.

Get 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-flagga. Om den inte har angetts används DEFAULT konfigurationsprofilen.

Dricks

Du kan trycka på Tab efter --profile eller -p för att visa en list av befintliga tillgängliga konfigurationsprofiler som du vill välja mellan.

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. Ändra standardsökvägen för .databrickscfg-filen genom att set miljövariabeln DATABRICKS_CONFIG_FILE till en annan sökväg. Se .databrickscfg-specifika miljövariabler och fält.

Om du vill get information om en befintlig konfigurationsprofil kör du kommandot 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": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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

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 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 dina konfigurationsprofiler

Om du vill testa konfigurationsprofilerna och kontrollera att du har set autentisering 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.

Kommentar

Det här kommandot förutsätter att du inte har några miljövariabler set som 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

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

databricks clusters spark-versions -p PROD