安裝或更新 Databricks CLI

注意

此資訊適用於 Databricks CLI 0.205 版和更新版本。 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 Subsystem for Linux （WSL），或source builds。

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

更新

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

Linux 或 macOS：使用 Homebrew、 curl 或來源組建。
Windows：使用 WinGet、Chocolatey、Windows Subsystem for 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 Subsystem for 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 Subsystem for 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-04-19