Freigeben über

Databricks CLI-Tutorial

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.

Die Databricks-Befehlszeilenschnittstelle (auch als Databricks CLI bezeichnet) ist ein Hilfsprogramm und bietet eine benutzerfreundliche Schnittstelle zum Automatisieren der Azure Databricks-Plattform über Ihr Terminal, Ihre Eingabeaufforderung oder über Automatisierungsskripts. Weitere Informationen finden Sie unter Was ist die Databricks-CLI?.

In diesem Artikel wird veranschaulicht, wie Sie die Databricks CLI schnell installieren und konfigurieren.

Bestätigen der Anforderungen des lokalen Computers

In diesem Lernprogramm wird davon ausgegangen, dass:

Installieren der Databricks CLI

  1. Installieren Sie die Databricks CLI:

    Linux, macOS

    Verwenden Sie Homebrew, um die Databricks CLI zu installieren, indem Sie die folgenden beiden Befehle ausführen:

    brew tap databricks/tap
brew install databricks

    Fenster

    Sie können Winget, Chocolatey oder das Windows Subsystem für Linux (WSL) verwenden, um die Databricks CLI zu installieren. Wenn Sie winget, Chocolatey oder das WSL nicht verwenden können, sollten Sie dieses Verfahren überspringen und stattdessen die Eingabeaufforderung oder PowerShell verwenden, um die Databricks CLI aus der Quelle zu installieren.

    Hinweis

    Die Installation der Databricks CLI mit Chocolatey befindet sich in der experimentellen Phase.

    Um winget zum Installieren der Databricks CLI zu verwenden, führen Sie die folgenden beiden Befehle aus, und starten Sie dann die Eingabeaufforderung neu:

    winget search databricks
winget install Databricks.DatabricksCLI

    Um Chocolatey zum Installieren der Databricks CLI zu verwenden, führen Sie den folgenden Befehl aus:

    choco install databricks-cli

    So installieren Sie die Databricks CLI mit dem WSL

    1. Installieren Sie curl und zip über das WSL. Weitere Informationen finden Sie in der Dokumentation Ihres Betriebssystems.

    2. Verwenden Sie WSL, um die Databricks CLI zu installieren, indem Sie den folgenden Befehl ausführen:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

  2. Vergewissern Sie sich, dass die Databricks CLI installiert ist, indem Sie den folgenden Befehl ausführen, der die aktuelle Version der installierten Databricks CLI anzeigt. Diese Version sollte 0.205.0 oder höher sein:

    databricks -v

Konfigurieren des Zugriffs auf Ihren Arbeitsbereich

Konfigurieren Sie als Nächstes den Zugriff auf Ihren Databricks-Arbeitsbereich.

Hinweis

In diesem Lernprogramm wird die OAuth-Benutzer-zu-Computer-Authentifizierung (U2M) verwendet, um die CLI mit Ihrem Azure Databricks-Benutzerkonto zu authentifizieren. Informationen zum Konfigurieren der CLI für das Verwenden anderer Databricks-Authentifizierungstypen finden Sie unter Authentifizierung für die Databricks-CLI.

  1. Verwenden Sie die Databricks CLI, um die OAuth-Tokenverwaltung lokal zu initiieren, indem Sie den folgenden Befehl für jedes Zielkonto oder jeden Arbeitsbereich ausführen.

    Ersetzen Sie bei Vorgängen auf Kontoebene im folgenden Befehl die folgenden Platzhalter:

    databricks auth login --host <account-console-url> --account-id <account-id>

    Bei Vorgängen auf Arbeitsbereichsebene ersetzen Sie im folgenden Befehl <workspace-url> durch Ihre arbeitsbereichsspezifische Azure Databricks-URL, z. B. https://adb-1234567890123456.7.azuredatabricks.net.

    databricks auth login --host <workspace-url>

  2. Die Databricks CLI fordert Sie auf, die Informationen zu speichern, die Sie als Azure Databricks-Konfigurationsprofil eingegeben haben. Drücken Sie die EINGABETASTE (Enter), um den vorgeschlagenen Profilnamen zu übernehmen, oder geben Sie den Namen eines neuen oder bereits vorhandenen Profils ein. Jedes vorhandene Profil mit demselben Namen wird mit den von Ihnen eingegebenen Informationen überschrieben. Sie können Profile verwenden, um Ihren Authentifizierungskontext schnell zwischen mehreren Konten oder Arbeitsbereichen zu wechseln.

    Verwenden Sie zum Abrufen einer Liste vorhandener Profile in einem separaten Terminal oder einer separaten Eingabeaufforderung die Databricks CLI, um den Befehl databricks auth profiles auszuführen. Um die vorhandenen Einstellungen eines bestimmten Profils anzuzeigen, führen Sie den Befehl databricks auth env --profile <profile-name>aus.

  3. Füllen Sie in Ihrem Webbrowser die Anweisungen auf dem Bildschirm aus, um sich bei Ihrem Azure Databricks-Konto oder -Arbeitsbereich anzumelden.

  4. Um den aktuellen OAuth-Tokenwert eines Profils und den bevorstehenden Ablaufzeitstempel eines Profils anzuzeigen, führen Sie einen der folgenden Befehle aus:

    Führen Sie bei Vorgängen auf Kontoebene die folgenden Befehle aus:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url> --account-id <account-id>
    • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

    Wenn Sie mehrere Profile mit denselben --host und --account-id-Werten haben, müssen Sie möglicherweise die Optionen --host, --account-id und -p zusammen angeben, damit die Databricks-CLI die richtigen passenden OAuth-Token-Informationen findet.

    Führen Sie bei Vorgängen auf Arbeitsbereichsebene die folgenden Befehle aus:

    • databricks auth token -p <profile-name>
    • databricks auth token --host <workspace-url>
    • databricks auth token --host <workspace-url> -p <profile-name>

    Wenn Sie über mehrere Profile mit denselben --host-Werten verfügen, müssen Sie möglicherweise die --host und -p-Optionen zusammen angeben, damit die Databricks CLI die richtigen übereinstimmenden OAuth-Token-Informationen finden kann.

Nächste Schritte

  • Last updated on