Konfigurationsprofile für die Databricks-CLI

In diesem Artikel wird beschrieben, wie Sie die Databricks CLI mit Konfigurationsprofilen verwenden. Es wird davon ausgegangen, dass Sie die Databricks CLI bereits installiert und eine Databricks-Konfigurationsprofil-Datei erstellt haben. Siehe Installieren oder Aktualisieren der Databricks CLI- und Azure Databricks-Konfigurationsprofile.

Abrufen von Informationen zu Konfigurationsprofilen

Wenn Sie der .databrickscfg Datei mehrere Konfigurationsprofile hinzufügen, können Sie Befehle schnell in verschiedenen Arbeitsbereichen ausführen, indem Sie den Namen des Zielkonfigurationsprofils im Befehls --profile - oder -p Flag angeben. Wenn Sie kein Profil angeben, wählt die CLI ein Profil in der folgenden Reihenfolge aus:

1. Die DATABRICKS_CONFIG_PROFILE-Umgebungsvariable, falls gesetzt.
2. Die default_profile Einstellung im [__settings__] Abschnitt von .databrickscfg, falls vorhanden. Sie können dies mit databricks auth switch festlegen. Siehe databricks auth switch.
3. Das DEFAULT Profil.

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

Standardmäßig sucht die Databricks CLI nach der .databrickscfg-Datei in Ihrem ~-Ordner (Ihre Benutzerstartseite) unter Unix, Linux oder macOS oder in Ihrem %USERPROFILE%-Ordner (Ihre Benutzerstartseite) unter Windows. Um den Standardpfad der datei .databrickscfg zu ändern, legen Sie die Umgebungsvariable DATABRICKS_CONFIG_FILE auf einen anderen Pfad fest. Siehe .databrickscfg-spezifische Felder.

Führen Sie den auth describe-Befehl aus, um Informationen zu einem vorhandenen Konfigurationsprofil abzurufen:

databricks auth describe --profile <configuration-profile-name>

Hier sehen Sie beispielsweise die Ausgabe für ein Profil, das mit der Authentifizierung mit persönlichem Azure Databricks-Zugriffstoken konfiguriert ist:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Führen Sie den Befehl auth profiles aus, um Informationen zu allen verfügbaren Profilen abzurufen:

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

Die Ausgabe des auth profiles-Befehls zeigt keine Zugriffstoken an. Um Tokendetails für ein bestimmtes Profil anzuzeigen, führen Sie databricks auth describe --profile <profile-name> aus oder databricks auth token --profile <profile-name>.

Testen Ihrer Konfigurationsprofile

Um Ihre Konfigurationsprofile zu testen und zu überprüfen, ob Sie die Authentifizierung ordnungsgemäß eingerichtet haben, führen Sie einen Befehl aus, der eine Verbindung mit einem Arbeitsbereich herstellt.

Wenn Sie kein Profil angeben, wird das Standardprofil verwendet. Der folgende Befehl listet beispielsweise die verfügbaren Databricks-Runtime-Versionen für den Azure Databricks-Arbeitsbereich auf, der Ihrem DEFAULT-Profil zugeordnet ist.

databricks clusters spark-versions

Um ein bestimmtes Konfigurationsprofil zu überprüfen, geben Sie den Profilnamen mithilfe des -p Flags an.

databricks clusters spark-versions -p PROD