安裝或更新 Databricks CLI

注意

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

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

安裝

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

macOS：使用 Homebrew。
Linux：使用 curl 或原始碼編譯。
Windows：使用 WinGet、Chocolatey、Windows 子系統 Linux 版（WSL），或source builds。

Databricks CLI 也可在 Azure Databricks 工作空間內使用。請參閱執行 Databricks CLI 命令。

更新

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

macOS：使用 Homebrew。
Linux：使用 curl 或原始碼編譯。
Windows：使用 WinGet、Chocolatey、Windows 子系統 Linux 版（WSL），或source builds。

適用於 macOS 的 Homebrew 安裝

此安裝選項是使用 Homebrew 自動下載並安裝最新的 Databricks CLI 版本。

從終端機執行以下 Homebrew 指令來安裝 CLI：

brew tap databricks/tap
brew trust databricks/tap
brew install databricks

自 brew trust 起，必須使用指令，因為 Homebrew 要求必須先明確信任第三方 taps，才會載入其公式。在升級到 Homebrew 6.0.0 前已點選的現有用戶也必須執行 brew trust databricks/tap。

你也可以一次安裝，不用完全信任整個水龍頭：

brew install databricks/tap/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 6.0.0 起，第三方 tap 必須先明確設為受信任，Homebrew 才會載入其配方。執行以下命令：
```
brew trust databricks/tap
```
在升級到 Homebrew 6.0.0 前已點選的現有使用者也必須執行此指令。
使用 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。此指令會區分大小寫。
```
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 /usr/local/bin/databricks 以及 Windows 上，將 Databricks CLI 下載並安裝於路徑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 shell 提示字元或 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 /usr/local/bin/databricks 以及 Windows 上，將 Databricks CLI 下載並安裝於路徑C:\Windows\databricks.exe中。

如果出現以下錯誤，您必須手動刪除前一路徑中的 Databricks CLI，然後再次執行 curl 指令：「目標路徑 <path> 已存在。」
確認 Databricks CLI 是否已正確更新。若要這麼做，請在終端機中使用 -v 選項，或執行 version 指令來檢視 Databricks CLI 的版本：
```
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-06-25