Freigeben über

Installieren oder Aktualisieren der Databricks-CLI

  • Artikel

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

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:

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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die Versionsnummer 0.205.0 oder höher aufgeführt ist, bedeutet dies, dass die Databricks-CLI ordnungsgemäß installiert ist.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

  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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die Versionsnummer 0.205.0 oder höher aufgeführt ist, bedeutet dies, dass die Databricks-CLI ordnungsgemäß installiert ist.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

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

Installieren von Chocolatey 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 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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die Versionsnummer 0.205.0 oder höher aufgeführt ist, bedeutet dies, dass die Databricks-CLI ordnungsgemäß installiert ist.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

  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 zu Ihrem Betriebssystem. 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 curl Releases 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

    Informationen zum Anzeigen des Skriptinhalts vor der Ausführung finden Sie in der Datei install.sh im Repository der Databricks-CLI 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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die Versionsnummer 0.205.0 oder höher aufgeführt ist, bedeutet dies, dass die Databricks-CLI ordnungsgemäß installiert ist.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

  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 Abschnitt Assets des Releases heruntergeladen haben, muss mit dem Betriebssystem und der Architektur Ihres Entwicklungscomputers übereinstimmen:

    Filename 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 .zip-Datei finden Sie in der 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. Zeigen Sie hierzu über eine Linux-Eingabeaufforderung, das macOS-Terminal oder die Windows-Eingabeaufforderung die Version der ausführbaren Databricks-CLI-Datei an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die Versionsnummer 0.205.0 oder höher aufgeführt ist, bedeutet dies, dass die Databricks-CLI ordnungsgemäß installiert ist.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

    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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die erwartete aktualisierte Versionsnummer angezeigt wird, wurde 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.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

Tipp

Informationen zum Downgrade der Version 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 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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die erwartete aktualisierte Versionsnummer angezeigt wird, wurde 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.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

Aktualisieren von Chocolatey 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 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. Um dies zu tun, zeigen Sie die Version der ausführbaren Databricks CLI an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die erwartete aktualisierte Versionsnummer angezeigt wird, wurde 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.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

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 zu Ihrem Betriebssystem. 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

    Informationen zum Anzeigen des Skriptinhalts vor der Ausführung finden Sie in der Datei install.sh im Repository der Databricks-CLI 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. Zeigen Sie hierzu über Ihr Terminal die Version der ausführbaren Databricks-CLI-Datei an, indem Sie die Option -v verwenden oder den Befehl version ausführen:

    databricks -v

# Or:
databricks version

    Wenn die erwartete aktualisierte Versionsnummer angezeigt wird, wurde 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.

    Hinweis

    Wenn Sie databricks ausführen, aber einen Fehler wie command not found: databricks erhalten, oder wenn Sie databricks -v ausführen und eine Versionsnummer von 0.18 oder niedriger aufgeführt ist, bedeutet dies, dass Ihr Computer nicht die richtige Version der ausführbaren Databricks-CLI-Datei finden kann. Weitere Informationen zum Beheben dieses Problems finden Sie unter Überprüfen Ihrer CLI-Installation.

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. Optional können Sie die ausführbare Databricks-CLI-Datei, die .zip-Datei und den extrahierten Ordner der .zip-Datei aus jedem vorherigen manuellen Quellinstallationsvorgang löschen.
  2. Fahren Sie fort, indem Sie die Anleitung im Abschnitt Quellinstallation für Linux, macOS und Windows befolgen.