注释
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
account service-principals-v2
Databricks CLI 中的命令组包含用于对服务主体执行创建、获取、列出、更新和删除作的命令。 服务主体是用于作业、自动化工具和系统（如脚本、应用和 CI/CD 平台）的标识。 Databricks 建议创建服务主体来运行生产作业或修改生产数据。 如果所有处理生产数据的进程都运行于服务主体，交互用户在生产环境中无需写、删除或修改权限，从而消除用户意外覆盖生产数据的风险。
DataBricks Account Service-Principals-V2 Create
在 Databricks 帐户中创建新的服务主体。
databricks account service-principals-v2 create [flags]
选项
--active
如果此用户处于活动状态。
--application-id string
与服务主体相关的 UUID。
--display-name string
表示名字和姓氏拼接的字符串。
--external-id string
外部 ID。
--id string
Databricks 服务主体 ID。
--json JSON
要么是内联JSON字符串，要么 @path/to/file.json 是请求正体。
示例
以下示例使用命令行标志创建服务主体：
databricks account service-principals-v2 create --display-name "CI/CD Service Principal"
以下示例使用 JSON 创建服务主体：
databricks account service-principals-v2 create --json '{"displayName": "CI/CD Service Principal", "active": true}'
以下示例使用 JSON 文件创建服务主体：
databricks account service-principals-v2 create --json @service-principal.json
Databricks account service-principals-v2 delete
删除Databricks账户中的服务主体。
databricks account service-principals-v2 delete ID [flags]
Arguments
ID
Databricks 帐户中服务主体的唯一 ID。
选项
示例
以下示例按 ID 删除服务主体：
databricks account service-principals-v2 delete 12345
Databricks Account Service-principals-v2 get
获取 Databricks 帐户中定义的单个服务主体的详细信息。
databricks account service-principals-v2 get ID [flags]
Arguments
ID
Databricks 帐户中服务主体的唯一 ID。
选项
示例
以下示例按 ID 获取服务主体：
databricks account service-principals-v2 get 12345
Databricks Account Service-principals-v2 列表
获取与 Databricks 帐户关联的服务主体集。
databricks account service-principals-v2 list [flags]
选项
--attributes string
响应中返回的属性列表，用逗号分隔。
--excluded-attributes string
响应时需要排除的属性的逗号分隔列表。
--filter string
用于筛选结果的查询。
--limit int
要返回的最大结果数。
--sort-by string
用于对结果进行排序的属性。
--sort-order ListSortOrder
对结果进行排序的顺序。 支持值： ascending， descending。
示例
以下示例列出所有服务主体：
databricks account service-principals-v2 list
以下示例列出具有分页的服务主体：
databricks account service-principals-v2 list --limit 10
以下示例列出具有筛选器的服务主体：
databricks account service-principals-v2 list --filter "displayName eq \"CI/CD Service Principal\""
Databricks Account Service-principals-v2 patch
部分更新 Databricks 帐户中单个服务主体的详细信息。
databricks account service-principals-v2 patch ID [flags]
Arguments
ID
Databricks 工作区中的唯一 ID。
选项
--json JSON
要么是内联JSON字符串，要么 @path/to/file.json 是请求正体。
示例
以下示例使用 JSON 修补服务主体：
databricks account service-principals-v2 patch 12345 --json '{"displayName": "Updated CI/CD Service Principal"}'
以下示例使用 JSON 文件修补服务主体：
databricks account service-principals-v2 patch 12345 --json @patch-service-principal.json
Databricks Account Service-Principals-V2 更新
在Databricks账户中替换一个服务主体。
databricks account service-principals-v2 update ID [flags]
Arguments
ID
Databricks 服务主体 ID。
选项
--active
如果此用户处于活动状态。
--application-id string
与服务主体相关的 UUID。
--display-name string
表示名字和姓氏拼接的字符串。
--external-id string
外部 ID。
--json JSON
要么是内联JSON字符串，要么 @path/to/file.json 是请求正体。
示例
以下示例使用命令行标志更新服务主体：
databricks account service-principals-v2 update 12345 --display-name "Updated CI/CD Service Principal" --active
以下示例使用 JSON 更新服务主体：
databricks account service-principals-v2 update 12345 --json '{"displayName": "Updated CI/CD Service Principal", "active": true}'
以下示例使用 JSON 文件更新服务主体：
databricks account service-principals-v2 update 12345 --json @update-service-principal.json
全局标志
--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 字符串
如果适用，要使用的捆绑包目标