安装或更新 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、适用于 Linux 的 Windows 子系统（WSL）或 source builds。

Databricks CLI 也可以在Azure Databricks工作区中使用。请参阅运行 Databricks CLI 命令。

更新

要更新先前安装的 Databricks CLI 0.205 或更高版本：

macOS：使用 Homebrew。
Linux：使用 curl 或源版本。
Windows：使用 WinGet， Chocolatey、适用于 Linux 的 Windows 子系统（WSL）或 source builds。

macOS 上的 Homebrew 安装

对于此安装选项，请使用 Homebrew 自动下载并安装最新的 Databricks CLI 版本。

在终端中，运行以下 Homebrew 命令以安装 CLI：

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

从 Homebrew 6.0.0 开始，必须执行 brew trust 命令，因为该版本要求在 Homebrew 加载第三方源的配方之前，必须明确信任该源。在升级到 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 将 GitHub 中的 databricks/homebrew-tap 存储库添加到可用 Homebrew Tap 存储库列表中：
```
brew tap databricks/tap
```
信任该源。从 Homebrew 6.0.0 开始，必须明确信任第三方 tap，Homebrew 才会加载其配方。运行下面的命令：
```
brew trust databricks/tap
```
在升级到 Homebrew 6.0.0 之前执行过 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。此命令区分大小写。
```
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 存储库的 Releases 部分所列。最新版本在版本列表中带有一个 Latest 标签。最新预发行版带有 Pre-release 标签，它更适合试验和早期采用者。从发布的 Assets 部分下载的 .zip 文件必须与开发计算机的操作系统和体系结构匹配：

文件名	体系结构
`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 图标菜单 >“关于本机”，或使用终端命令 uname -m。
Windows：命令提示符或 PowerShell 命令echo %PROCESSOR_ARCHITECTURE%。

如果需要验证其中一个 .zip 文件的完整性，Databricks 会在与 .zip 文件相同的列表中提供一个名为 databricks_cli_X.Y.Z_SHA256SUMS 的校验和文件。要运行校验和验证，请参阅操作系统的文档。

提取下载的 .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 存储库中的说明。

适用于 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 存储库的 Releases 部分。最新版本在版本列表中带有一个 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 存储库的 Releases 部分。最新版本在版本列表中带有一个 Latest 标签。

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

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

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

在 macOS 和 Linux 上，从路径 /usr/local/bin/databricks 中删除 Databricks CLI 的现有安装；在 Windows 上，则从路径 C:\Windows\databricks.exe 中删除。
在 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 存储库的 Releases 部分。最新版本在版本列表中带有一个 Latest 标签。

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

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

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

反馈

此页面是否有帮助？

Last updated on 2026-06-25