安装或更新 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、适用于 Linux 的 Windows 子系统 (WSL) 或源内部版本。

也可从 Azure Databricks 工作区用户界面中获取 Databricks CLI。请参阅运行 Databricks CLI 命令。

更新

若要更新以前安装的 Databricks CLI 0.205 或更高版本，请执行以下操作：

Linux 或 macOS：使用 Homebrew、curl 或源代码生成。
Windows：使用 WinGet、Chocolatey、适用于 Linux 的 Windows 子系统 (WSL) 或源内部版本。

适用于 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 将 GitHub 中的 databricks/homebrew-tap 存储库添加到可用 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 身份验证。

适用于 Linux、macOS 和 Windows 的 curl 安装

如果选择此安装方法，请使用 curl 下载并安装最新的 Databricks CLI 可执行文件版本。

对于 Windows，Databricks 建议使用适用于 Linux 的 Windows 子系统 (WSL)。你还必须安装 unzip。有关安装说明，请参阅操作系统的文档。如果无法使用 WSL，请跳过此过程，改为使用命令提示符或 PowerShell 从源安装 Databricks CLI。

必须安装 curl。你可以通过从 Linux shell 提示符、macOS 终端或 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
```
注意

若要在运行脚本之前查看脚本的内容，请参阅 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 CLI 身份验证。

适用于 Linux、macOS 和 Windows 的源安装

如果选择此安装方法，需要手动下载 .zip 文件，然后从下载的 .zip 文件中手动提取 Databricks CLI 可执行文件。

将最新的 Databricks CLI .zip 文件下载到本地开发计算机上，如 GitHub 上 Databricks CLI 存储库的发布部分所列。最新版本在版本列表中带有一个 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 图标菜单 >，选择 “关于此 Mac”，或使用终端命令 uname -m。
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 存储库的版本部分。最新版本在版本列表中带有一个 Latest 标签。

提示

若要降级 Databricks CLI 的版本，请参阅 GitHub 中 databricks/homebrew-tap 存储库中的说明。

Windows 的 WinGet 更新

对于此更新选项，请使用 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 存储库的版本部分。最新版本在版本列表中带有一个 Latest 标签。

适用于 Windows 的 Chocolatey 更新

注意

使用 Chocolatey 更新 Databricks CLI 是试验性的。

对于此更新选项，请使用 Chocolatey 自动下载最新的 Databricks CLI 版本并将以前安装的 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 存储库的版本部分。最新版本在版本列表中带有一个 Latest 标签。

适用于 Linux、macOS 和 Windows 的 curl 更新

对于此更新选项，请使用 curl 自动下载并将以前安装的 Databricks CLI 0.205 或更高版本更新到最新版本。

对于 Windows，Databricks 建议使用适用于 Linux 的 Windows 子系统 (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
```
注意

若要在运行脚本之前查看脚本的内容，请参阅 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 是否已正确更新。为此，请从终端使用 -v 选项或运行 version 命令查看 Databricks CLI 可执行文件的版本：
```
databricks -v

# Or:
databricks version
```
如果输出的版本是 0.205.0 或更高，那么 Databricks CLI 已成功安装。

有关 Databricks CLI 版本的列表，请查看 GitHub 中的 Databricks CLI 存储库的版本部分。最新版本在版本列表中带有一个 Latest 标签。

适用于 Linux、macOS 和 Windows 的源更新

对于此更新选项，请手动下载 .zip 文件，然后从下载的 .zip 文件中手动提取 Databricks CLI 可执行文件。

（可选）从以前的任何手动源安装过程中删除 Databricks CLI 可执行文件、.zip 文件和 .zip 文件的提取文件夹。
按照适用于 Linux、macOS 和 Windows 的源安装中的说明继续操作。

Last updated on 2026-06-08