Konfigurationsprofile für die Databricks-CLI

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.

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 datei .databrickscfg mehrere Konfigurationsprofile hinzufügen, können Sie Befehle schnell in verschiedenen Arbeitsbereichen ausführen, indem Sie den Namen des Zielkonfigurationsprofils im --profile- oder -p-Flag des Befehls angeben. Wenn sie nicht angegeben ist, wird das DEFAULT Konfigurationsprofil verwendet.

Tipp

Sie können Tab nach --profile oder -p drücken, um eine Liste der vorhandenen verfügbaren Konfigurationsprofile anzuzeigen, aus denen Sie auswählen möchten.

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 Umgebungsvariablen und Felder.

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

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

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

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

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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 ein Zugriffstoken anzuzeigen, führen Sie den vorherigen Befehl auth env aus.

Wichtig

Die Databricks CLI kann nicht mit einer NETRC-Datei verwendet werden. Sie können eine .netrc-Datei in Ihrer Umgebung für andere Zwecke verwenden, aber die Databricks CLI verwendet diese .netrc-Datei nicht.

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.

Hinweis

Bei diesem Befehl wird davon ausgegangen, dass Sie keine Umgebungsvariablen festgelegt haben, die Vorrang vor den Einstellungen in Ihrem DEFAULT Profil haben. Weitere Informationen finden Sie unter Authentifizierungsreihenfolge der Auswertung.

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