安裝或 update Databricks CLI

發行項
12/27/2024

注意

此資訊適用於 Databricks CLI 0.205 版和更新版本。 Databricks CLI 處於公開預覽狀態。

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

本文說明如何安裝或 update Databricks CLI。請參閱什麼是 Databricks CLI？。若要設定 Databricks CLI 的驗證，請參閱 Databricks CLI 的驗證。

安裝

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

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

您也可以從 Azure Databricks 工作區使用者介面內取得 Databricks CLI。請參閱執行 Databricks CLI 命令。

Update

若要 update 舊版 Databricks CLI 0.205 版或更新版本：

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

適用於 Linux 或 macOS 的 Homebrew 安裝

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

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

brew tap databricks/tap
brew install databricks

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

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

從 Linux 殼層提示字元或 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 執行下列命令，將 GitHub 中 databricks/homebrew-tap 存放庫新增至可用 Homebrew Tap 存放庫的 list：
```
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 但遇到 get 之類的錯誤，例如 command not found: databricks，或者如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦無法找到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 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 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 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 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。
繼續進行 Databricks CLI 的驗證。

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

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

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

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

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

若要在執行腳本之前檢視腳本的內容，請參閱 GitHub 中 Databricks CLI 安裝程式存放庫中的 install.sh 檔案。

針對 Windows，您應該以系統管理員身分執行此命令。

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

此命令會在macOS和Linux /usr/local/bin/databricks 和 Windows 的路徑中C:\Windows\databricks.exe下載並安裝 Databricks CLI 可執行檔。

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

# Or:
databricks version
```
如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

注意

如果您執行 databricks 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。
繼續進行 Databricks CLI 的驗證。

Linux、macOS 和 Windows 的來源安裝

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

下載到本機開發計算機最新的 Databricks CLI 檔案，如 GitHub 中 Databricks CLI .zip 存放庫的 Releases 區段所列。最新版本在發行列表 list 中，其旁邊有 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` Series / `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`

若要 get 您機器的架構，請參閱作業系統的文件。例如：

Linux：終端機 uname -m命令、 lscpu或 sudo lshw -c cpu。
macOS：Appleuname -m
Windows：命令提示字元或 PowerShell 命令 echo %PROCESSOR_ARCHITECTURE%。

如果您需要確認這其中一個 .zip 檔案的完整性，Databricks 會在與 .zip 檔案相同的 list 中提供名為 databricks_cli_X.Y.Z_SHA256SUMS 的總和檢查碼檔案。若要執行總和檢查碼驗證，請參閱作業系統的檔。

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

# Or:
databricks version
```
如果列出 0.205.0 或更新版本號碼，表示 Databricks CLI 已正確安裝。

注意

如果您執行 databricks 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。

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

Homebrew update 適用於 Linux 或 macOS

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

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

# Or:
databricks version
```
如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

如需 Databricks CLI 的 list 版本，請參閱 GitHub 中 Databricks CLI 存放庫中的 Releases 章節。最新版本在發行清單 list 中，旁邊附有 Latest 標籤。

注意

如果您執行 databricks 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。

提示

若要降級 Databricks CLI 的版本，請參閱 GitHub 中 databricks/homebrew-tap 存放庫中的指示。

適用於 Windows 的 WinGet update

針對此 update 選項，您可以使用 winget 自動下載及 update 舊版 Databricks CLI 0.205 版或更新版本至最新版本。

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

# Or:
databricks version
```
如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

若要查看 Databricks CLI 各版本的 list，請參閱 GitHub 上 Databricks CLI 存放庫的 Releases 部分。最新版本在發行 list 中，其旁邊有 Latest 標籤。

注意

如果您執行 databricks 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。

適用於 Windows 的 Chocolatey update

注意

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

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

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

# Or:
databricks version
```
如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

如需 Databricks CLI 版本的 list，請參閱 GitHub 中 Databricks CLI 存放庫的 Releases 一節。最新版本在 list 的發行中，其旁邊有 Latest 標籤。

注意

如果您執行 databricks 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。

適用於Linux、macOS和 Windows 的 curl update

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

針對 Windows，Databricks 建議您使用 Windows 子系統 Linux 版（WSL）。您必須安裝 unzip 。如需安裝指示，請參閱作業系統的檔。如果您無法使用 WSL，您應略過此程序，而應使用命令提示字元或 PowerShell，改為從來源來安裝 Databricks CLI。

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

若要在執行腳本之前檢視腳本的內容，請參閱 GitHub 中 Databricks CLI 安裝程式存放庫中的 install.sh 檔案。

針對 Windows，您應該以系統管理員身分執行此命令。

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

此命令會在macOS和Linux /usr/local/bin/databricks 和 Windows 的路徑中C:\Windows\databricks.exe下載並安裝 Databricks CLI 可執行檔。

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

# Or:
databricks version
```
如果預期的更新版本號碼顯示，則會正確安裝 Databricks CLI。

如需查詢 Databricks CLI 版本的 list，請參閱 GitHub 上 Databricks CLI 資源庫中的 Releases 部分。最新版本在發行 list 中，其旁邊有 Latest 標籤。

注意

如果您執行 databricks 但 getcommand not found: databricks之類的錯誤，或如果您執行 databricks -v 且版本號碼為 0.18 或以下，這表示您的電腦找不到正確的 Databricks CLI 可執行檔版本。若要修正此問題，請參閱確認 CLI 安裝。

適用於 Linux、macOS 和 Windows 的來源 update

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

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

共用方式為

安裝或 update Databricks CLI

安裝

Update

適用於 Linux 或 macOS 的 Homebrew 安裝

適用於 Windows 的 WinGet 安裝

適用於 Windows 的 Chocolatey 安裝

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

Linux、macOS 和 Windows 的來源安裝

Homebrew update 適用於 Linux 或 macOS

適用於 Windows 的 WinGet update

適用於 Windows 的 Chocolatey update

適用於Linux、macOS和 Windows 的 curl update

適用於 Linux、macOS 和 Windows 的來源 update

意見反應

其他資源

共用方式為

安裝或 update Databricks CLI

安裝

Update

適用於 Linux 或 macOS 的 Homebrew 安裝

適用於 Windows 的 WinGet 安裝

適用於 Windows 的 Chocolatey 安裝

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

Linux、macOS 和 Windows 的來源安裝

Homebrew update 適用於 Linux 或 macOS

適用於 Windows 的 WinGet update

適用於 Windows 的 Chocolatey update

適用於Linux、macOS和 Windows 的 curl update

適用於 Linux、macOS 和 Windows 的 來源 update

意見反應

其他資源

適用於 Linux、macOS 和 Windows 的來源 update