安裝或更新 Databricks CLI

注意

Databricks CLI 的使用受限於 Databricks 授權和 Databricks 隱私權注意事項，包括任何使用數據規定。

本文說明如何安裝或更新 Databricks CLI。請參見 Databricks CLI。若要設定 Databricks CLI 的驗證，請參閱 Databricks CLI 的驗證。

安裝

若要安裝 Databricks CLI 0.205 版或更新版本：

Linux 或 macOS：使用 Homebrew、 curl 或來源組建。
Windows：使用 WinGet、Chocolatey、Windows 子系統 Linux 版（WSL），或source builds。

Databricks CLI 也可在 Azure Databricks 工作空間的使用者介面中使用。請參閱執行 Databricks CLI 命令。

更新

若要更新 Databricks CLI 版本 0.205 或以上之先前安裝：

Linux 或 macOS：使用 Homebrew、 curl 或來源組建。
Windows：使用 WinGet、Chocolatey、Windows 子系統 Linux 版（WSL），或source builds。

適用於 Linux 或 macOS 的 Homebrew 安裝

針對此安裝選項，您可以使用 Homebrew 來自動下載並安裝最新的 Databricks CLI 可執行檔版本。

從終端機中，只要執行下列兩個 Homebrew 命令來安裝 CLI：

brew tap databricks/tap
brew install databricks

然後繼續進行 Databricks CLI 的驗證。

如果您不確定是否已安裝 Homebrew，或先前的 Homebrew 命令失敗，請遵循下列較長的指示：

從 Linux Shell 或在 macOS 終端機上執行下列命令，檢查 Homebrew 是否已安裝。如果已安裝 Homebrew，則會顯示 Homebrew 版本號碼：
```
brew -v
```
如果尚未安裝 Homebrew，請執行下列命令加以安裝：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
然後執行下列命令來驗證 Homebrew 安裝，其中顯示 Homebrew 版本號碼：
```
brew -v
```
使用 Homebrew 將 databricks/homebrew-tap 倉庫加入GitHub的可用 Homebrew Tap 倉庫清單，方法是執行以下指令：
```
brew tap databricks/tap
```
使用 Homebrew 執行以下命令，指示 databricks/homebrew-tap 儲存庫下載並安裝 Databricks CLI 執行檔：
```
brew install databricks
```
確認是否已正確安裝 Databricks CLI。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果列出版本號碼為 0.205.0 或更新版本，則 Databricks CLI 已正確安裝。
繼續進行 Databricks CLI 的驗證。

Windows 的 WinGet 安裝

針對此安裝選項，您可以使用 winget 來自動下載並安裝最新的 Databricks CLI 可執行檔版本。

從命令提示字元中，執行下列兩 winget 個命令來安裝 CLI，然後重新啟動命令提示字元：
```
winget search databricks
winget install Databricks.DatabricksCLI
```
確認是否已正確安裝 Databricks CLI。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```

如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。

繼續進行 Databricks CLI 的驗證。

Windows 的 Chocolatey 安裝

注意

使用 Chocolatey 安裝 Databricks CLI 是實驗性的。

針對此安裝選項，您可以使用 Chocolatey 自動下載並安裝最新的 Databricks CLI 可執行檔版本。

從命令提示字元中，執行下列 choco 命令以安裝 CLI：
```
choco install databricks-cli
```
確認是否已正確安裝 Databricks CLI。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。
繼續進行 Databricks CLI 的驗證。

curl 的安裝適用於 Linux、macOS 及 Windows

針對此安裝選項，您可以使用 curl 下載並安裝最新的 Databricks CLI 可執行檔版本。

對於Windows，Databricks 建議你使用 Windows 子系統 Linux 版（WSL）。您必須安裝 unzip。如需安裝說明，請參閱您的作業系統的文件。如果您無法使用 WSL，請略過此程式，並使用命令提示字元或 PowerShell 來改為從來源安裝 Databricks CLI。

curl 必須安裝。您可以在 Linux Shell 提示字元、macOS Terminal 或 WSL 上的 Bash 中執行下列命令，以檢查 curl 是否已經安裝。如果已安裝 curl，則會顯示 curl 的版本號碼：
```
curl -V
```
如果curl尚未安裝，請依照操作系統和架構的 [curl發行與下載] 頁面上的指示進行安裝。若要取得機器的架構，請參考作業系統的文件。

然後執行下列命令來驗證 curl 安裝，其中顯示 curl 版本號碼：
```
curl -V
```
使用 curl 執行下列命令來下載並安裝 Databricks CLI 可執行檔（請注意，您必須在所有作業系統上指定正確的大寫和小寫字元 -fsSL ）：
```
curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
```
注意

若要在執行前查看腳本內容，請參考 Databricks CLI 設定庫中的 install.sh 檔案，GitHub 中。

在 Windows 上，你應該以管理員身份執行這個指令。

若為Linux和macOS，如果錯誤訊息指出 /usr/local/bin 無法寫入，請使用再次 sudo執行命令。

此指令在 macOS 與 Linux 的路徑中下載並安裝 Databricks CLI 執行檔 /usr/local/bin/databricks，Windows 則為 C:\Windows\databricks.exe。

如果因為某些原因而已安裝 Databricks CLI，則會顯示以下錯誤訊息：「目標路徑 <path> 已經存在」。若要修正此問題，您必須從上述路徑手動刪除 Databricks CLI 可執行檔，然後再次執行 curl 命令。
確認是否已正確安裝 Databricks CLI。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。
繼續進行 Databricks CLI 的驗證。

在 Linux、macOS 及 Windows 上進行 Source 安裝

在此安裝選項中，您會手動下載 .zip 檔案，然後從下載 .zip 的檔案手動擷取 Databricks CLI 可執行檔。

請將最新的 Databricks CLI .zip 檔案下載到您的本地開發機器，該檔案列於 GitHub 年版 Databricks CLI 倉庫的 Releases 區塊中。最新版本在發行清單中顯示其旁邊有 Latest 標籤。最新的發行前版本有一個 Pre-release 標籤，更適合實驗和早期採用者。 .zip 檔案您從版本發行的 Assets 區段下載時，必須與您的開發電腦作業系統及架構相符。

檔案名稱	架構
`databricks_cli_X.Y.Z_darwin_amd64.zip`	macOS、Intel 64 位 / `x86_64`
`databricks_cli_X.Y.Z_darwin_arm64.zip`	macOS、Apple Silicon、`M` 系列、`arm64`
`databricks_cli_X.Y.Z_linux_amd64.zip`	Linux、Intel 64 位 / `x86_64`
`databricks_cli_X.Y.Z_linux_arm64.zip`	Linux、ARM 64 位 / `arm64`
`databricks_cli_X.Y.Z_windows_386.zip`	Windows，Intel 32位元 / `x86`
`databricks_cli_X.Y.Z_windows_amd64.zip`	Windows，Intel 64位元 / `AMD64`
`databricks_cli_X.Y.Z_windows_arm64.zip`	Windows，ARM 64位元 / `ARM64`

若要取得機器的架構，請參考作業系統的文件。例如：

Linux：終端機命令uname -m、lscpu或sudo lshw -c cpu。
macOS：點擊 Apple 圖示選單，選擇 >，或者使用 Terminal 指令。
Windows：命令提示字元或 PowerShell 指令 echo %PROCESSOR_ARCHITECTURE%。

如果您需要驗證其中.zip一個檔案的完整性，Databricks 會在與databricks_cli_X.Y.Z_SHA256SUMS檔案相同的清單中提供名為 .zip 的總和檢查碼檔案。欲執行校驗碼驗證，請參閱您的操作系統文件。

擷取下載 .zip 文件的內容。若要擷取 .zip 檔案，請檢視作業系統的文件。
在擷取的內容中，資料夾會出現與檔案相同的名稱 .zip 。此資料夾內部是 Databricks CLI 可執行檔。您可以將 Databricks CLI 可執行檔留在該處，也可以複製或移動至另一個位置。
確認是否已正確安裝 Databricks CLI。要做到這點，可以從 Linux shell 提示字元、macOS 終端機或 Windows 命令提示字元，透過使用 -v 選項或執行 version 指令來查看 Databricks CLI 執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。

注意

針對macOS，您可能需要授權系統能夠先執行 Databricks CLI。請參閱開啟來自不明開發人員的 Mac 應用程式。
繼續進行 Databricks CLI 的驗證。

適用於 Linux 或 macOS 的 Homebrew 軟體更新

針對此更新選項，您可以使用 Homebrew ，將 Databricks CLI 0.205 版或更新版本的先前安裝自動更新為最新版本。

從 Linux 殼層提示字元或 macOS 終端機，執行下列命令，使用 Homebrew 下載並更新至最新版的 Databricks CLI 可執行檔：
```
brew upgrade databricks
```
確認 Databricks CLI 是否已正確更新。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。

如需 Databricks CLI 版本列表，請參閱 GitHub 中 Databricks CLI 儲存庫的 Releases 區塊。最新版本在發行清單中顯示其旁邊有 Latest 標籤。

提示

要降級 Databricks CLI 版本，請參閱 GitHub databricks/homebrew-tap 倉庫中的說明。

WinGet 更新給Windows

針對此更新選項，您可以使用 winget 自動下載並將先前版本的 Databricks CLI 0.205 或更高版本更新為最新版本。

從命令提示字元中，執行下列命令，使用 winget 下載並更新至最新版的 Databricks CLI 可執行檔：
```
winget upgrade Databricks.DatabricksCLI
```
確認是否已正確安裝 Databricks CLI。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。

如需 Databricks CLI 版本列表，請參閱 GitHub 中 Databricks CLI 儲存庫的 Releases 區塊。最新版本在發行清單中顯示其旁邊有 Latest 標籤。

適用於 Windows 的 Chocolatey 更新

注意

使用 Chocolatey 更新 Databricks CLI 是實驗性的。

針對此更新選項，您可以使用 Chocolatey 自動下載並從舊版 Databricks CLI 0.205 或以上的版本更新至最新版本。

從命令提示字元中，執行下列命令，使用 choco 下載並更新至最新版的 Databricks CLI 可執行檔：
```
choco upgrade databricks-cli
```
確認是否已正確安裝 Databricks CLI。若要這樣做，請使用 -v 選項或執行 version 命令來檢視 Databricks CLI 可執行檔的版本：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。

如需 Databricks CLI 版本列表，請參閱 GitHub 中 Databricks CLI 儲存庫的 Releases 區塊。最新版本在發行清單中顯示其旁邊有 Latest 標籤。

curl 更新，適用於 Linux、macOS 和 Windows

針對此更新選項，您可以使用 curl 自動下載並將先前安裝的 Databricks CLI 版本 0.205 或更高版本更新至最新版本。

對於Windows，Databricks 建議你使用 Windows 子系統 Linux 版（WSL）。您必須安裝 unzip 。如需安裝說明，請參閱您的作業系統的文件。如果您無法使用 WSL，您應該跳過這個步驟，改用命令提示字元或 PowerShell 從來源更新 Databricks CLI。

刪除在 macOS 和 Linux 的路徑 /usr/local/bin/databricks 或 Windows 的路徑 C:\Windows\databricks.exe 中的現有 Databricks CLI 執行檔安裝。
從 Linux shell 提示字元、macOS 終端機或Windows命令提示字元，使用 curl 執行以下指令下載並安裝最新版本的 Databricks CLI 執行檔（請注意，您必須指定正確的大寫與小寫字元作為 -fsSL）：
```
curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
```
注意

若要在執行前查看腳本內容，請參考 Databricks CLI 設定庫中的 install.sh 檔案，GitHub 中。

在 Windows 上，你應該以管理員身份執行這個指令。

若為Linux和macOS，如果錯誤訊息指出 /usr/local/bin 無法寫入，請使用再次 sudo執行命令。

此指令在 macOS 與 Linux 的路徑中下載並安裝 Databricks CLI 執行檔 /usr/local/bin/databricks，Windows 則為 C:\Windows\databricks.exe。

如果出現下列錯誤，您必須從上述路徑手動刪除 Databricks CLI 可執行檔，然後再次執行 curl 命令：「目標路徑 <path> 已經存在」。
確認 Databricks CLI 是否已正確更新。若要這樣做，請從終端機檢視 Databricks CLI 可執行檔的版本，方法是使用 -v 選項或執行 version 命令：
```
databricks -v

# Or:
databricks version
```
如果輸出是 0.205.0 版或更新版本，則會正確安裝 Databricks CLI。

如需 Databricks CLI 版本列表，請參閱 GitHub 中 Databricks CLI 儲存庫的 Releases 區塊。最新版本在發行清單中顯示其旁邊有 Latest 標籤。

Source 更新，適用於 Linux、macOS 及 Windows

針對此更新選項，您會手動下載檔案 .zip ，然後從下載 .zip 的檔案手動擷取 Databricks CLI 可執行檔。

或者，從任何先前的手動來源安裝程式中刪除 Databricks CLI 可執行檔、 .zip 檔案和 .zip 檔案的解壓縮資料夾。
繼續按照Linux、macOS 和 Windows 的Source安裝中的指示進行操作。

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-05-21