Installieren oder Aktualisieren der Databricks-CLI

Hinweis

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

Auf dieser Seite wird beschrieben, wie Sie die Databricks CLI installieren oder aktualisieren. Siehe Databricks CLI. Informationen zum Konfigurieren der Authentifizierung für die Databricks CLI finden Sie unter Authentifizierung für die Databricks CLI.

Installieren

So installieren Sie die Databricks-CLI-Version 0.205 oder höher:

Die Databricks CLI ist auch innerhalb des Azure Databricks Arbeitsbereichs verfügbar. Weitere Informationen finden Sie unter Databricks CLI-Befehle ausführen.

Aktualisieren

So aktualisieren Sie eine frühere Installation von Databricks CLI, Version 0.205 oder höher:

Homebrew-Installation für macOS

Für diese Installationsoption verwenden Sie Homebrew , um die neueste Databricks CLI-Version automatisch herunterzuladen und zu installieren.

Führen Sie in Ihrem Terminal die folgenden Homebrew-Befehle aus, um die CLI zu installieren:

brew tap databricks/tap
brew trust databricks/tap
brew install databricks

Der brew trust Befehl ist ab Homebrew 6.0.0 erforderlich, was erfordert, dass Tippen von Drittanbietern explizit als vertrauenswürdig eingestuft werden, bevor Homebrew ihre Formel lädt. Bestehende Benutzer, die vor dem Upgrade auf Homebrew 6.0.0 getippt haben, müssen auch brew trust databricks/tap ausführen.

Sie können auch in einem Schritt installieren, ohne dem gesamten Tap vertrauen zu müssen:

brew install databricks/tap/databricks

Fahren Sie dann mit der Authentifizierung der Databricks-CLI fort.

Wenn Sie nicht sicher sind, ob Homebrew installiert ist, oder wenn die vorherigen Homebrew-Befehle fehlschlagen, befolgen Sie diese ausführliche Anleitung:

  1. Überprüfen Sie, ob Homebrew bereits installiert ist, indem Sie den folgenden Befehl über eine Linux-Shelleingabeaufforderung oder das macOS-Terminal ausführen. Wenn Homebrew installiert ist, wird die Homebrew-Versionsnummer angezeigt:

    brew -v
    
  2. Wenn Homebrew noch nicht installiert ist, können Sie die Installation mit dem folgenden Befehl durchführen:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    

    Führen Sie dann den folgenden Befehl aus, um die Homebrew-Installation zu überprüfen, die die Homebrew-Versionsnummer anzeigt:

    brew -v
    
  3. Verwenden Sie Homebrew, um das Repository databricks/homebrew-tap in GitHub ihrer Liste der verfügbaren Homebrew Tap-Repositorys hinzuzufügen, indem Sie den folgenden Befehl ausführen:

    brew tap databricks/tap
    
  4. Vertrauen Sie dem Tippen. Ab Homebrew 6.0.0 müssen Taps von Drittanbietern explizit als vertrauenswürdig markiert werden, bevor Homebrew ihre Formeln lädt. Führen Sie den folgenden Befehl aus:

    brew trust databricks/tap
    

    Vorhandene Benutzer, die vor dem Upgrade auf Homebrew 6.0.0 getippt haben, müssen auch diesen Befehl ausführen.

  5. Verwenden Sie Homebrew, um das databricks/homebrew-tap Repository anzuweisen, die Databricks CLI herunterzuladen und zu installieren, indem Sie den folgenden Befehl ausführen:

    brew install databricks
    
  6. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Dazu können Sie die Version der Databricks CLI mit der Option -v oder durch Ausführen des Befehls version anzeigen:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn eine Versionsnummer von 0.205.0 oder höher aufgeführt ist, wird die Databricks CLI ordnungsgemäß installiert.

  7. Fahren Sie mit der Authentifizierung für die Databricks-CLI fort.

WinGet-Installation für Windows

Für diese Installationsoption verwenden Sie winget , um die neueste Databricks CLI-Version automatisch herunterzuladen und zu installieren.

  1. Führen Sie an der Eingabeaufforderung die folgenden beiden winget Befehle aus, um die CLI zu installieren, und starten Sie dann die Eingabeaufforderung neu:

    winget search databricks
    winget install Databricks.DatabricksCLI
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Zeigen Sie dazu die Version der Databricks CLI mithilfe der -v Option oder durch Ausführen des version Befehls an:

    databricks -v
    
    # Or:
    databricks version
    

Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

  1. Fahren Sie mit der Authentifizierung für die Databricks-CLI fort.

Chocolatey-Installation für Windows

Hinweis

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

Für diese Installationsoption verwenden Sie Chocolatey , um die neueste Databricks CLI-Version automatisch herunterzuladen und zu installieren.

  1. Führen Sie in der Eingabeaufforderung den folgenden choco-Befehl aus, um die CLI zu installieren:

    choco install databricks-cli
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Zeigen Sie dazu die Version der Databricks CLI mithilfe der -v Option oder durch Ausführen des version Befehls an:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

  3. Fahren Sie mit der Authentifizierung für die Databricks-CLI fort.

curl-Installation für Linux, macOS und Windows

Für diese Installationsoption verwenden Sie curl , um ein Skript herunterzuladen und aufzurufen, um die neueste Databricks CLI-Version zu installieren.

Für Windows empfiehlt Databricks, Windows-Subsystem für Linux (WSL) zu verwenden. unzip muss ebenfalls installiert werden. Installationsanweisungen finden Sie in der Dokumentation Ihres Betriebssystems. Wenn Sie das WSL nicht verwenden können, überspringen Sie dieses Verfahren, und verwenden Sie stattdessen die Eingabeaufforderung oder PowerShell, um die Databricks CLI aus der Quelle zu installieren.

  1. curl muss installiert werden. Sie können überprüfen, ob curl bereits installiert ist, indem Sie den folgenden Befehl über eine Linux-Shell, das macOS-Terminal oder die Bash im WSL ausführen. Wenn curl installiert ist, wird die curl-Versionsnummer angezeigt:

    curl -V
    
  2. Wenn curl noch nicht installiert ist, installieren Sie es, indem Sie die Anweisungen auf der Seite curlReleases und Downloads für Ihr Betriebssystem und Ihre Architektur befolgen. Informationen zur Architektur Ihres Computers finden Sie in der Dokumentation Ihres Betriebssystems.

    Führen Sie dann den folgenden Befehl aus, um die curl-Installation zu überprüfen, der die curl-Versionsnummer anzeigt:

    curl -V
    
  3. Verwenden Sie curl, um die Databricks CLI mit dem folgenden Befehl herunterzuladen und zu installieren. Bei diesem Befehl wird die Groß-/Kleinschreibung beachtet.

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

    Hinweis

    Wenn Sie den Inhalt des Skripts anzeigen möchten, bevor Sie es ausführen, lesen Sie die Datei install.sh im Databricks CLI Setup-Repository in GitHub.

    Für Windows sollten Sie diesen Befehl als Administrator ausführen.

    Wenn eine Fehlermeldung für Linux und macOS besagt, dass /usr/local/bin nicht beschreibbar ist, führen Sie den Befehl erneut mit sudo aus.

    Dieser Befehl lädt die Databricks CLI im Pfad /usr/local/bin/databricks unter macOS und Linux und C:\Windows\databricks.exe auf Windows herunter und installiert sie.

    Wenn die Databricks CLI aus irgendeinem Grund bereits installiert ist, wird der folgende Fehler angezeigt: „Zielpfad <path> ist bereits vorhanden.“ Um dies zu beheben, müssen Sie die Databricks CLI manuell aus dem vorherigen Pfad löschen und dann den curl Befehl erneut ausführen.

  4. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Zeigen Sie dazu die Version der Databricks CLI mithilfe der -v Option oder durch Ausführen des version Befehls an:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

  5. Fahren Sie mit der Authentifizierung für die Databricks-CLI fort.

Source-Installation für Linux, macOS und Windows

Für diese Installationsoption laden Sie eine .zip Datei manuell herunter und extrahieren dann die Databricks CLI manuell aus der heruntergeladenen .zip Datei.

  1. Laden Sie die neueste .zip-Datei der Databricks-CLI auf Ihren lokalen Entwicklungscomputer herunter, wie im Abschnitt Releases des Repositorys „Databricks/cli“ in GitHub aufgeführt. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases. Die neueste Vorabversion verfügt über eine Pre-release-Bezeichnung und eignet sich besser für Experimente und Early Adopter. Die .zip Datei, die Sie aus dem Assets Versionsabschnitt herunterladen, muss mit dem Betriebssystem und der Architektur Ihres Entwicklungscomputers übereinstimmen.

    Dateiname Aufbau
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS, Intel 64-Bit/x86_64
    databricks_cli_X.Y.Z_darwin_arm64.zip macOS, Apple Silicon/M Series/arm64
    databricks_cli_X.Y.Z_linux_amd64.zip Linux, Intel 64-Bit / x86_64
    databricks_cli_X.Y.Z_linux_arm64.zip Linux, ARM 64-Bit/arm64
    databricks_cli_X.Y.Z_windows_386.zip Windows, Intel 32-Bit / x86
    databricks_cli_X.Y.Z_windows_amd64.zip Windows, Intel 64-Bit / AMD64
    databricks_cli_X.Y.Z_windows_arm64.zip Windows, ARM 64-Bit /ARM64

    Informationen zur Architektur Ihres Computers finden Sie in der Dokumentation Ihres Betriebssystems. Beispiel:

    • Linux: die Terminalbefehle uname -m, lscpu oder sudo lshw -c cpu
    • macOS: das Apple-Symbolmenü >Über diesen Mac oder der Terminalbefehl uname -m
    • Windows: Der Eingabeaufforderungs- oder PowerShell-Befehl echo %PROCESSOR_ARCHITECTURE%.

    Wenn Sie die Integrität einer dieser .zip-Dateien überprüfen müssen, stellt Databricks eine Prüfsummendatei mit dem Namen databricks_cli_X.Y.Z_SHA256SUMS in derselben Liste wie die .zip-Dateien bereit. Informationen zum Ausführen einer Prüfsummenüberprüfung finden Sie in der Dokumentation Ihres Betriebssystems.

  2. Extrahieren Sie die Inhalte der heruntergeladenen .zip-Datei. Informationen zum Extrahieren der Datei finden Sie in der .zip Dokumentation Ihres Betriebssystems.

  3. Im extrahierten Inhalt wird ein Ordner mit demselben Namen wie die .zip-Datei angezeigt. Innerhalb dieses Ordners befindet sich die Databricks CLI. Sie können die Databricks CLI dort verlassen, oder Sie können sie an einen anderen Speicherort kopieren oder verschieben.

  4. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Dazu zeigen Sie in einer Linux-Shell, im macOS-Terminal oder in der Windows-Eingabeaufforderung die Version der Databricks CLI mithilfe der Option -v oder durch Ausführen des Befehls version an:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

    Hinweis

    Für macOS müssen Sie Ihrem System möglicherweise erlauben, die Databricks-CLI zuerst auszuführen. Weitere Informationen finden Sie unter Öffnen der Mac-App eines nicht verifizierten Entwicklers.

  5. Fahren Sie mit der Authentifizierung für die Databricks-CLI fort.

Homebrew-Aktualisierung für Linux und macOS

Verwenden Sie für diese Aktualisierungsoption Homebrew, um eine vorherige Installation der Databricks-CLI-Version 0.205 oder höher automatisch auf die neueste Version zu aktualisieren.

  1. Verwenden Sie homebrew von einer Linux-Shell-Eingabeaufforderung oder einem macOS-Terminal, um homebrew herunterzuladen und auf die neueste Version der Databricks CLI zu aktualisieren, indem Sie den folgenden Befehl ausführen:

    brew upgrade databricks
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß aktualisiert wurde. Zeigen Sie dazu die Version der Databricks CLI mithilfe der -v Option oder durch Ausführen des version Befehls an:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

    Eine Liste der Databricks CLI-Versionen finden Sie im Abschnitt Releases Abschnitt des Databricks CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

Tipp

Informationen zum Downgrade der Databricks CLI finden Sie in den Anweisungen im databricks/homebrew-tap Repository in GitHub.

WinGet-Update für Windows

Für diese Aktualisierungsoption verwenden Sie Winget, um eine vorherige Installation der Databricks CLI-Version 0.205 oder höher automatisch herunterzuladen und auf die neueste Version zu aktualisieren.

  1. Verwenden Sie von der Eingabeaufforderung aus winget, um durch Ausführen des folgenden Befehls die neueste Version der Databricks CLI herunterzuladen und auf sie zu aktualisieren:

    winget upgrade Databricks.DatabricksCLI
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Zeigen Sie dazu die Version der Databricks CLI mithilfe der -v Option oder durch Ausführen des version Befehls an:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

    Eine Liste der Databricks CLI-Versionen finden Sie im Abschnitt Releases Abschnitt des Databricks CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

Chocolatey Update für Windows

Hinweis

Das Aktualisieren der Databricks CLI mit Chocolatey befindet sich in der experimentellen Phase.

Für diese Aktualisierungsoption verwenden Sie Chocolatey, um eine vorherige Installation der Databricks CLI-Version 0.205 oder höher automatisch herunterzuladen und auf die neueste Version zu aktualisieren.

  1. Verwenden Sie in Ihrer Eingabeaufforderung choco, um die Databricks CLI herunterzuladen und auf die neueste Version zu aktualisieren, indem Sie den folgenden Befehl ausführen:

    choco upgrade databricks-cli
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Zeigen Sie dazu die Version der Databricks CLI mithilfe der -v Option oder durch Ausführen des version Befehls an:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

    Eine Liste der Databricks CLI-Versionen finden Sie im Abschnitt Releases Abschnitt des Databricks CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

curl-Update für Linux, macOS und Windows

Für diese Aktualisierungsoption verwenden Sie curl, um eine vorherige Installation der Databricks-CLI-Version 0.205 oder höher automatisch herunterzuladen und auf die neueste Version zu aktualisieren.

Für Windows empfiehlt Databricks, Windows-Subsystem für Linux (WSL) zu verwenden. unzip muss bereits installiert sein. Installationsanweisungen finden Sie in der Dokumentation Ihres Betriebssystems. Wenn Sie 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 aktualisieren.

  1. Löschen Sie die vorhandene Installation der Databricks CLI aus dem Pfad /usr/local/bin/databricks unter macOS und Linux oder C:\Windows\databricks.exe auf Windows.

  2. Geben Sie an einer Linux-Shell-Eingabeaufforderung, im macOS-Terminal oder an der Windows-Eingabeaufforderung curl ein, um die neueste Version der Databricks CLI herunterzuladen und zu installieren, indem Sie den folgenden Befehl ausführen (beachten Sie, dass Sie die korrekten Groß- und Kleinbuchstaben für -fsSL angeben müssen):

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

    Hinweis

    Wenn Sie den Inhalt des Skripts anzeigen möchten, bevor Sie es ausführen, lesen Sie die Datei install.sh im Databricks CLI Setup-Repository in GitHub.

    Für Windows sollten Sie diesen Befehl als Administrator ausführen.

    Wenn eine Fehlermeldung für Linux und macOS besagt, dass /usr/local/bin nicht beschreibbar ist, führen Sie den Befehl erneut mit sudo aus.

    Dieser Befehl lädt die Databricks CLI im Pfad /usr/local/bin/databricks unter macOS und Linux und C:\Windows\databricks.exe auf Windows herunter und installiert sie.

    Wenn der folgende Fehler angezeigt wird, müssen Sie die Databricks CLI manuell aus dem vorherigen Pfad löschen und dann den curl Befehl erneut ausführen: "Zielpfad <path> ist bereits vorhanden."

  3. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß aktualisiert wurde. Dazu können Sie von Ihrem Terminal aus die Version der Databricks CLI anzeigen, indem Sie die -v Option verwenden oder den version Befehl ausführen:

    databricks -v
    
    # Or:
    databricks version
    

    Wenn die Ausgabe Version 0.205.0 oder höher ist, wird die Databricks CLI ordnungsgemäß installiert.

    Eine Liste der Databricks CLI-Versionen finden Sie im Abschnitt Releases Abschnitt des Databricks CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

Source-Update für Linux, macOS und Windows

Für diese Aktualisierungsoption laden Sie eine .zip-Datei manuell herunter und extrahieren die ausführbare Databricks-CLI-Datei aus der heruntergeladenen .zip-Datei.

  1. Löschen Sie optional die ausführbare Datei Databricks CLI, die .zip Datei und den extrahierten Ordner der .zip Datei aus einer früheren manuellen Quellinstallation.
  2. Folgen Sie den Anweisungen in Source-Installation für Linux, macOS und Windows.