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