configure-Befehlsgruppe

Hinweis

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Mit der Befehlsgruppe configure in der Databricks CLI können Sie die Databricks CLI mit Azure Databricks authentifizieren, indem Sie persönliche Azure Databricks-Zugriffstoken oder Microsoft Entra ID-Token (ehemals Azure Active Directory) verwenden.

Hinweis

Als bewährte Methode für die Sicherheit empfiehlt Databricks, dass Sie bei der Authentifizierung mit automatisierten Tools, Systemen, Skripten und Anwendungen persönliche Zugriffstoken verwenden, die zu Dienstprinzipalen und nicht zu Benutzern des Arbeitsbereichs gehören. Informationen zum Erstellen von Token für Dienstprinzipale finden Sie unter Verwalten von Token für einen Dienstprinzipal.

Beachten Sie, dass dieser Artikel nur das persönliche Zugriffstoken von Azure Databricks und die Microsoft Entra ID-Tokenauthentifizierung zum Aktivieren des Aufrufens von Befehlen auf Arbeitsbereichsebene behandelt. Weitere Konfigurationsoptionen für die Authentifizierung finden Sie unter Authentifizierung für die Databricks-CLI.

Wichtig

Bevor Sie diesen Befehl ausführen, müssen Sie die Databricks CLI einrichten.

Sie führen configure-Befehle aus, indem Sie sie an databricks configure anfügen. Führen Sie databricks configure -h aus, um Hilfe zum configure-Befehl anzuzeigen.

Erstellen eines Konfigurationsprofils

Ein Konfigurationsprofil ist eine Sammlung von Einstellungen, die Authentifizierungsinformationen wie eine Azure Databricks-Arbeitsbereichs-URL und einen Zugriffstokenwert enthält. Ein Konfigurationsprofil verfügt über einen programmgesteuerten Namen, z. B. DEFAULT, DEV oder PROD.

Führen Sie den Befehl configure wie folgt aus, um ein Konfigurationsprofil zu erstellen:

databricks configure --host <workspace-url>

Geben Sie die arbeitsbereichsspezifische URL für <workspace-url> im Format https://adb-<workspace-id>.<random-number>.azuredatabricks.net ein. Informationen zum Abrufen der arbeitsbereichsspezifischen URL finden Sie unter URL pro Arbeitsbereich.

Der Befehl fordert Sie auf, Ihr persönliches Azure Databricks-Zugriffstoken oder Microsoft Entra ID-Token (ehemals Azure Active Directory) einzugeben, das dem angegebenen <workspace-url>-Element zugeordnet ist:

✔ Databricks Token:

Nachdem Sie Ihr Zugriffstoken eingegeben haben, wird es standardmäßig in der Datei ~/.databrickscfg unter Linux oder macOS bzw. %USERPROFILE%\.databrickscfg unter Windows gespeichert. Die Datei enthält einen standardmäßigen Verbindungsprofileintrag namens DEFAULT:

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

Um anstelle von DEFAULT einen anderen Namen für Ihr Verbindungsprofil zu verwenden, fügen Sie dem Befehl configure die Option --profile hinzu, z. B.:

databricks configure --host <workspace-url> --profile <profile-name>

Tipp

Für die Databricks-CLI, Version 0.201.0 und höher können Sie Tab nach --profile oder -p drücken, um eine Liste der vorhandenen verfügbaren Konfigurationsprofile anzuzeigen, aus der Sie auswählen können, anstatt den Namen des Konfigurationsprofils manuell einzugeben.

Alle vorhandenen Host- und Tokeninformationen innerhalb des angegebenen Verbindungsprofils werden mit den neuen Host- und Tokeninformationen überschrieben.

Wenn Sie der Datei .databrickscfg mehrere Verbindungsprofile hinzufügen, können Sie Befehle schnell in verschiedenen Arbeitsbereichen ausführen, indem Sie den Namen des Zielverbindungsprofils in der Option --profile des Befehls angeben. Wenn Sie die Option --profile nicht in einem Befehl angeben, der diese Option unterstützt, verwendet der Befehl standardmäßig das DEFAULT-Verbindungsprofil.

Beispielsweise könnten Sie ein Verbindungsprofil namens DEV haben, das auf einen Azure Databricks-Arbeitsbereich verweist, den Sie für Entwicklungsworkloads verwenden, und ein separates Verbindungsprofil namens PROD, das auf einen anderen Azure Databricks-Arbeitsbereich verweist, den Sie für Produktionsworkloads verwenden.

Sie können den Standardpfad dieser Datei vom Typ .databrickscfg ändern, indem Sie die Umgebungsvariable DATABRICKS_CONFIG_FILE festlegen. Informationen zum Festlegen von Umgebungsvariablen finden Sie in der Dokumentation Ihres Betriebssystems.

Verwenden Sie die Authentifizierungsbefehlsgruppe, um Informationen zu vorhandenen Konfigurationsprofilen abzurufen.