configure kommandogrupp
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.
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 set upp 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. För att se get URL:en för per arbetsyta, se URL per arbetsyta.
Kommandot uppmanar dig att ange din personliga Åtkomsttoken för Azure Databricks
✔ 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 på Tab efter --profile eller -p för att visa en list av 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. Mer information om hur du set miljövariabler finns i dokumentationen till operativsystemet.
Om du vill get information om befintliga konfigurationsprofiler använder du kommandogruppen auth.