Installieren oder Aktualisieren der Databricks-CLI

In diesem Artikel wird beschrieben, wie Sie die Databricks-CLI installieren oder aktualisieren. Weitere Informationen finden Sie unter Was ist die 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:

• Linux oder macOS: Verwenden Sie Homebrew, curl oder Quellbuilds.
• Windows: Verwenden Sie WinGet, Chocolatey, Windows-Subsystem für Linux (WSL) oder Quellbuilds.

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

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

• Linux oder macOS: Verwenden Sie Homebrew, curl oder Quellbuilds.
• Windows: Verwenden Sie WinGet, Chocolatey, Windows-Subsystem für Linux (WSL) oder Quellbuilds.

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 der 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. 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. 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.

Installieren von Chocolatey für Windows

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 an 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 die Verwendung des Windows-Subsystems für Linux (WSL). 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 install.sh Datei im Databricks CLI Setup-Repository in GitHub.

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

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

   Mit diesem Befehl wird die ausführbare Databricks CLI-Datei im Pfad /usr/local/bin/databricks unter macOS und Linux sowie unter C:\Windows\databricks.exe 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.

Quellinstallation 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 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. 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. Dazu können Sie über eine Linux-Shell-Eingabeaufforderung, ein macOS-Terminal oder eine Windows-Eingabeaufforderung 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.

   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 über eine Linux-Eingabeaufforderung oder das macOS-Terminal, um die neueste Version der ausführbaren Databricks-CLI-Datei herunterzuladen und die Schnittstelle 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 des Databricks-CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

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 an der Eingabeaufforderung winget, um die neueste Version der ausführbaren Databricks CLI-Datei herunterzuladen, und aktualisieren Sie die Version, 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 des Databricks-CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

Aktualisieren von Chocolatey für Windows

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 an der Eingabeaufforderung choco, um die neueste Version der ausführbaren Databricks CLI-Datei herunterzuladen, und aktualisieren Sie die Version, 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 des Databricks-CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

curl-Aktualisierung 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 die Verwendung des Windows-Subsystems für Linux (WSL). 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 unter Windows.

2. Verwenden Sie curl über eine Linux-Eingabeaufforderung, das macOS-Terminal oder die Windows-Eingabeaufforderung, um die neueste Version der ausführbaren Databricks-CLI-Datei herunterzuladen und zu installieren, indem Sie den folgenden Befehl ausführen (beachten Sie, dass Sie die richtigen 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 install.sh Datei im Databricks CLI Setup-Repository in GitHub.

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

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

   Mit diesem Befehl wird die ausführbare Databricks CLI-Datei im Pfad /usr/local/bin/databricks unter macOS und Linux sowie unter C:\Windows\databricks.exe 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 des Databricks-CLI-Repositorys in GitHub. Neben dem neuesten Release steht die Bezeichnung Latest in der Liste der Releases.

Quellaktualisierung 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. Fahren Sie fort, indem Sie die Anleitung im Abschnitt Quellinstallation für Linux, macOS und Windows befolgen.