Dela via

configure kommandogrupp

  • 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.

Med configure kommandogruppen i Databricks CLI kan du autentisera Databricks CLI med Azure Databricks med hjälp av personliga åtkomsttoken för Azure Databricks eller Microsoft Entra ID-token (tidigare Azure Active Directory).

Kommentar

När du autentiserar med automatiserade verktyg, system, skript och appar rekommenderar Databricks att du använder personliga åtkomsttoken som tillhör tjänstens huvudnamn i stället för arbetsyteanvändare. Information om hur du skapar token för tjänstens huvudnamn finns i Hantera token för tjänstens huvudnamn.

Observera att den här artikeln endast omfattar personlig åtkomsttoken för Azure Databricks och autentisering med Microsoft Entra-ID-token för att aktivera anrop av kommandon på arbetsytenivå . Ytterligare konfigurationsalternativ för autentisering finns i Autentisering för Databricks CLI.

Viktigt!

Innan du kör det här kommandot måste du konfigurera Databricks CLI.

Du kör configure kommandon genom att lägga till dem i databricks configure. Om du vill visa hjälp för configure kommandot kör du databricks configure -h.

Skapa en konfigurationsprofil

En konfigurationsprofil är en samling inställningar som innehåller autentiseringsinformation, till exempel en URL för Azure Databricks-arbetsytan och ett åtkomsttokenvärde. En konfigurationsprofil har ett programmatiskt namn, till exempel DEFAULT, DEVeller PROD.

Om du vill skapa en konfigurationsprofil kör configure du kommandot på följande sätt:

databricks configure --host <workspace-url>

För <workspace-url>anger du url:en per arbetsyta med formatet https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Information om hur du hämtar URL:en per arbetsyta finns i URL:en per arbetsyta.

Kommandot uppmanar dig att ange din personliga Åtkomsttoken för Azure Databricks eller Microsoft Entra ID-token (tidigare Azure Active Directory) som mappar till den angivna <workspace-url>:

✔ Databricks Token:

När du har angett din åtkomsttoken lagras din åtkomsttoken i filen ~/.databrickscfg på Linux eller macOS eller %USERPROFILE%\.databrickscfg i Windows som standard. Filen innehåller en standardpost för anslutningsprofilen med namnet DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Om du vill använda ett annat namn för anslutningsprofilen i stället DEFAULTför lägger du till --profile alternativet i configure kommandot, till exempel:

databricks configure --host <workspace-url> --profile <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.

All befintlig värd- och tokeninformation i den angivna anslutningsprofilen skrivs över med den nya värd- och tokeninformationen.

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

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

Du kan ändra standardsökvägen för den hä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.

Om du vill få information om befintliga konfigurationsprofiler använder du kommandogruppen auth.