Freigeben über


Installieren oder Aktualisieren der 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 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 über die benutzeroberfläche des Azure Databricks Arbeitsbereichs verfügbar. Weitere Informationen finden Sie unter Databricks CLI-Befehle ausführen.

Aktualisieren

Um eine frühere Installation der Databricks-CLI-Version 0.205 oder höher zu aktualisieren:

Homebrew-Installation für Linux oder macOS

Für diese Installationsoption verwenden Sie Homebrew, um das neueste Release der ausführbaren Databricks-CLI-Datei automatisch herunterzuladen und zu installieren.

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

brew tap databricks/tap
brew install 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. Verwenden Sie Homebrew, um das databricks/homebrew-tap-Repository anzuweisen, die ausführbare Databricks CLI-Datei herunterzuladen und zu installieren, indem Sie den folgenden Befehl ausführen:

    brew install databricks
    
  5. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung des Befehls version an.

    databricks -v
    
    # Or:
    databricks version
    

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

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

WinGet-Installation für Windows

Für diese Installationsoption verwenden Sie Winget, um das neueste Release der ausführbaren Databricks-CLI-Datei automatisch herunterzuladen und zu installieren.

  1. Öffnen Sie die Eingabeaufforderung und führen Sie 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. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung 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.

  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 automatisch das neueste Release der ausführbaren Databricks CLI-Datei 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. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung 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.

  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 das neueste Release der ausführbaren Databricks-CLI-Datei herunterzuladen und zu installieren.

Für Windows empfiehlt Databricks, Windows Subsystem for 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 ausführbare Datei für die Databricks CLI herunterzuladen und zu installieren, indem Sie den folgenden Befehl ausführen (beachten Sie, dass Sie unter allen Betriebssystemen die Groß- und Kleinschreibung für -fsSL einhalten 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.

    Mit diesem Befehl wird die ausführbare Datei der Databricks CLI im Pfad /usr/local/bin/databricks auf macOS und Linux sowie im Pfad C:\Windows\databricks.exe unter Windows heruntergeladen und installiert.

    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 ausführbare Databricks CLI-Datei aus dem vorherigen Pfad manuell löschen und dann den Befehl curl erneut ausführen.

  4. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung 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.

  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 manuell eine .zip-Datei herunter und extrahieren dann manuell die ausführbare Databricks CLI-Datei aus der heruntergeladenen .zip-Datei.

  1. Laden Sie die aktuelle Databricks CLI-.zip-Datei herunter, wie im Releases-Abschnitt des Databricks CLI-Repositorys 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. In diesem Ordner befindet sich die ausführbare Databricks CLI-Datei. Sie können die ausführbare Databricks CLI-Datei dort belassen, oder Sie können sie kopieren oder an einen anderen Speicherort verschieben.

  4. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Um dies zu tun, zeigen Sie in einer Eingabeaufforderung von Linux-Shell, macOS Terminal oder Windows Command Prompt die Version des ausführbaren Databricks CLI mithilfe der Option -v an oder führen Sie den Befehl version aus.

    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 dem macOS-Terminal, um die neueste Version der ausführbaren Datei Databricks CLI herunterzuladen und zu aktualisieren, indem Sie den folgenden Befehl ausführen:

    brew upgrade databricks
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß aktualisiert wurde. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung 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.

    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 in der Eingabeaufforderung winget, um die neueste Version des ausführbaren Databricks CLI-Programms herunterzuladen und zu aktualisieren, indem Sie den folgenden Befehl ausführen:

    winget upgrade Databricks.DatabricksCLI
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung 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.

    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 der Eingabeaufforderung choco, um die neueste Version des ausführbaren Databricks CLI-Programms herunterzuladen und zu aktualisieren, indem Sie den folgenden Befehl ausführen:

    choco upgrade databricks-cli
    
  2. Überprüfen Sie, ob die Databricks CLI ordnungsgemäß installiert ist. Dazu zeigen Sie die Version des ausführbaren Databricks CLI mithilfe der -v Option oder durch Ausführung 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.

    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 for 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 ausführbaren Databricks CLI aus dem Pfad /usr/local/bin/databricks unter macOS und Linux, oder C:\Windows\databricks.exe auf Windows.

  2. Verwenden Sie an einer Eingabeaufforderung der Linux-Shell, des macOS Terminal oder der Windows-Eingabeaufforderung curl, um die neueste Version der Databricks CLI-Programmdatei herunterzuladen und zu installieren, indem Sie den folgenden Befehl ausführen (beachten Sie, dass Sie die richtigen Zeichen in Groß- und Kleinschreibung 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.

    Mit diesem Befehl wird die ausführbare Datei der Databricks CLI im Pfad /usr/local/bin/databricks auf macOS und Linux sowie im Pfad C:\Windows\databricks.exe unter Windows heruntergeladen und installiert.

    Wenn der folgende Fehler angezeigt wird, müssen Sie die ausführbare Databricks CLI-Datei aus dem vorherigen Pfad manuell 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 vom Terminal aus die Ausführbare 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 einem vorherigen manuellen Quellinstallationsverfahren.
  2. Folgen Sie den Anweisungen in Source-Installation für Linux, macOS und Windows.