注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
通过 configureDatabricks CLI 中的命令，可以使用 Azure Databricks 个人访问令牌 或 Microsoft Entra ID（前 Azure Active Directory）令牌通过 Azure Databricks 对 Databricks CLI 进行身份验证。
注释
作为安全最佳做法，在使用自动化工具、系统、脚本和应用进行身份验证时，Databricks 建议使用属于服务主体（而不是工作区用户）的个人访问令牌。 若要为服务主体创建令牌，请参阅管理服务主体的令牌。
请注意，本文仅介绍用于启用工作区级命令调用的 Azure Databricks 个人访问令牌和 Microsoft Entra ID 令牌身份验证。 有关其他身份验证配置选项，请参阅为 Databricks CLI 设置身份验证。
databricks 配置
在 ~/.databrickscfg 文件中配置配置文件。 配置文件是一个设置集合，其中包含 Azure Databricks 工作区 URL 和访问令牌值等身份验证信息。
配置文件具有编程名称，例如 DEFAULT、DEV 或 PROD。 将多个配置文件添加到 .databrickscfg 文件后，可以通过在命令的选项中指定目标连接配置文件的名称，在各个工作区中快速运行命令 --profile 。 如果你不在支持 --profile 选项的命令中指定该选项，该命令默认将使用 DEFAULT 连接配置文件。
例如，你有一个名为 DEV 的连接配置文件引用用于开发工作负载的 Azure Databricks 工作区，以及一个名为 PROD 的独立连接配置文件，该连接配置文件引用用于生产工作负载的不同 Azure Databricks 工作区。
若要获取有关现有配置文件的信息，请使用 auth 命令组。
可以通过设置环境变量 .databrickscfg 来更改 DATABRICKS_CONFIG_FILE 文件的默认路径。
如果在非交互模式下调用此命令，它将从 stdin 读取令牌。 必须使用--host标志或DATABRICKS_HOST环境变量来指定主机。
databricks configure [flags]
选项
--configure-cluster
配置群集的提示
--host string
Databricks 工作区主机 URL
工作区主机 URL 是用于每个工作区的 URL，其格式为 https://adb-<workspace-id>.<random-number>.databricks.azure.cn。 若要获取每工作区 URL，请参阅每工作区 URL。
--profile string
要配置的连接配置文件的名称。 （默认值“DEFAULT”）
例子
以下示例为默认配置文件配置身份验证：
databricks configure
以下示例为特定配置文件配置身份验证：
databricks configure --profile my-profile
以下示例使用特定主机配置身份验证：
databricks configure --host https://my-workspace.cloud.databricks.com
以下示例使用群集配置配置身份验证：
databricks configure --configure-cluster
全局标志
--debug
是否启用调试日志记录。
-h 或 --help
显示 Databricks CLI、相关命令组或相关命令的帮助。
--log-file 字符串
一个字符串，表示要将输出日志写入到的文件。 如果未指定此标志，则默认会将输出日志写入到 stderr。
--log-format 格式
日志格式类型，text 或 json。 默认值是 text。
--log-level 字符串
一个表示日志格式级别的字符串。 如果未指定，则禁用日志格式级别。
-o, --output 类型
命令输出类型为 text 或 json。 默认值是 text。
-p, --profile 字符串
要用于运行命令的 ~/.databrickscfg 文件中的配置文件名称。 如果未指定此标志，并且存在命名为 DEFAULT 的配置文件，则使用该配置文件。
--progress-format 格式
显示进度日志的格式： default、 append、 inplace或 json
-t, --target 字符串
如果适用，要使用的捆绑包目标
创建配置文件
若要创建配置文件，请运行 configure 命令：
databricks configure --host <workspace-url>
该命令会提示你输入映射到指定 的 Azure Databricks 个人访问令牌或 <workspace-url>：
✔ Databricks Token:
输入访问令牌后，该访问令牌默认会存储在 Linux 或 macOS 上的 ~/.databrickscfg 文件中，或 Windows 上的 %USERPROFILE%\.databrickscfg 文件中。 该文件包含名为 DEFAULT 的默认连接配置文件条目：
[DEFAULT]
host = <workspace-url>
token = <access-token>
若要为连接配置文件使用其他名称而不是 DEFAULT，请将 --profile 选项添加到 configure 命令，例如：
databricks configure --host <workspace-url> --profile <profile-name>
小窍门
可以在 Tab 或 --profile 之后按 -p 以显示可供选择的现有可用配置文件的列表，而不是手动输入配置文件名称。
指定的连接配置文件中的所有现有主机和令牌信息将由新的主机和令牌信息覆盖。