Databricks CLI 命令
注意
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 以公共预览版提供。
Databricks CLI 使用受 Databricks 许可证和 Databricks 隐私声明的约束，包括任何使用情况数据预配。
本文介绍了有关可用的 Databricks CLI 命令的信息。 此信息补充了命令行帮助。 有关安装和使用 Databricks CLI 的更多信息，请参阅安装或更新 Databricks CLI 和什么是 Databricks CLI？。
Databricks CLI 包含下表中列出的命令组。 命令组包含相关命令集，这些命令也可以包含子命令。 若要输出命令组、单个命令或子命令的使用和语法信息，请使用以下语法：
databricks <command-group> -hdatabricks <command-group> <command-name> -hdatabricks <command-group> <command-name> <subcommand-name> -h
多数 CLI 命令所对应的操作均在 Azure Databricks REST API 参考文档中有所记录。
工作区命令
| 组 |
说明和命令 |
| fs |
用于管理文件和文件系统的命令：
cat、、cpls、mkdir、rm |
git-credentials |
用于为 Databricks 注册个人访问令牌以代表用户执行操作的命令：
create、、deleteget、list、update |
repos |
允许用户管理其 git 存储库的命令：
create、、deleteget、list、update
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
secrets |
用于管理机密、机密范围和访问权限的命令：
create-scope、、delete-acl、delete-secretdelete-scope、get-acl、get-secret、list-aclslist-scopes、、list-secrets、、 put-aclput-secret |
workspace |
用于列出、导入、导出和删除工作区中的笔记本和文件夹的命令：
delete、、exportexport-dir、get-status、import、import-dir、、 listmkdirs
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
计算命令
| 组 |
说明和命令 |
cluster-policies |
用于根据一组规则控制用户配置群集的能力的命令：
create、、deleteedit、get、list
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
clusters |
用于创建、启动、编辑、列出、终止和删除群集的命令：
change-owner、create、、editdelete、events、 getlistlist-node-typeslist-zonespermanent-deletepinresizerestartspark-versionsstartunpin
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
global-init-scripts |
使工作区管理员能够为其工作区配置全局初始化脚本的命令：
create、、deleteget、list、update |
instance-pools |
使用现成的云实例创建、编辑、删除和列出实例池的命令，从而缩短群集启动和自动扩展时间：
create、、deleteedit、get、list
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
instance-profiles |
允许管理员添加、列出和删除用户可用来启动群集的实例配置文件的命令：
add、、editlist、、remove |
libraries |
用于在群集上安装、卸载和获取库状态的命令：
all-cluster-statuses、、cluster-statusinstall、、uninstall |
policy-families |
用于查看可用策略系列的命令：
get, list |
作业命令
| 组 |
说明和命令 |
jobs |
用于管理作业的命令：
cancel-all-runs、、cancel-run、delete、、 export-runget-runrepair-runlist-runssubmitgetrun-nowget-run-outputresetlistdelete-runcreateupdate
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
Delta Live Tables 命令
| 组 |
说明和命令 |
pipelines |
用于创建、编辑、删除、启动和查看管道详细信息的命令：
create、、delete、get-updateget、list-pipeline-events、list-pipelines、list-updates、start-update、、 stopupdate
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
机器学习命令
| 组 |
说明和命令 |
experiments |
用于与试验交互的命令，这些试验是 MLflow 中组织的主要单元，所有 MLflow 运行都属于试验：
create-experiment、create-run、、delete-run、 delete-runssearch-runslog-inputslog-batchlog-metriclist-experimentslist-artifactslog-modelrestore-runsrestore-runsearch-experimentsrestore-experimentset-experiment-tagset-tagdelete-tagget-experimentupdate-experimentget-by-nameget-historyget-runGetlog-paramdelete-experimentupdate-run
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
model-registry |
用于工作区模型注册表的命令：
approve-transition-request、create-comment、、create-model-version、 create-transition-requesttransition-stagelist-transition-requestslist-modelsget-model-version-download-uriget-model-versionlist-webhooksget-modelget-latest-versionsdelete-webhookreject-transition-requestdelete-transition-requestdelete-model-version-tagrename-modelset-model-version-tagset-model-tagtest-registry-webhooksearch-modelsupdate-commentupdate-modelcreate-webhookdelete-modelupdate-model-versiondelete-commentdelete-model-tagdelete-model-versionsearch-model-versionscreate-modelupdate-webhook
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
实时服务命令
| 组 |
说明和命令 |
serving-endpoints |
用于创建、更新和删除模型服务终结点的命令：
build-logs、、create、export-metricsdelete、get、list、logspatch、、put、、 queryupdate-config
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
身份验证和访问控制管理命令
| 组 |
说明和命令 |
account |
用于管理 Databricks 帐户的命令：
- 身份验证和访问控制：access-control、groups、service-principals、users、workspace-assignment
- Unity Catalog：metastore-assignments、metastores、storage-credentials
- 设置：ip-access-lists、network-connectivity、settings
- 预配：credentials、encryption-keys、networks、private-access、storage、vpc-endpoints、workspaces
- 计费：billable-usage、log-delivery
- OAuth：custom-app-integration、o-auth-published-apps、published-app-integration、service-principal-secrets |
| auth |
用于身份验证的命令：
describe、、envlogin、profiles、token |
current-user |
用于检索有关当前经过身份验证的用户或服务主体的信息的命令：
me |
groups |
针对简化标识管理的组的命令，使分配对 Databricks 工作区、数据和其他安全对象的访问权限变得更加容易：
create、、deleteget、list、patch、update |
permissions |
为不同对象和终结点上的不同用户创建读取、写入、编辑、更新和管理访问权限的命令：
get、 set、、 update
get-permission-levels |
service-principals |
针对作业、自动化工具和系统（例如脚本、应用程序和 CI/CD 平台）的标识的命令：
create、、deleteget、list、patch、update |
users |
针对由 Databricks 识别并由电子邮件地址表示的用户标识的命令：
create、、deleteget、list、patch、update
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
| 组 |
说明和命令 |
alerts |
用于对警报执行操作的命令：
create、、deleteget、list、update |
data-sources |
创建新查询对象的命令：
list |
queries |
对查询定义执行操作的命令：
create、、deleteget、list、restore、update |
query-history |
通过 SQL 仓库访问查询历史记录的命令：
list |
warehouses |
用于管理 SQL 仓库的命令，SQL 仓库是一种计算资源，可让你在 Databricks SQL 中的数据对象上运行 SQL 命令：
create、、delete、getedit、get-workspace-warehouse-config、list、set-workspace-warehouse-config、、 startstop
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
Unity Catalog 命令
| 组 |
说明和命令 |
artifact-allowlists |
用于管理项目允许列表的命令。 在 Databricks Runtime 13.3 及更高版本中，可以将库和初始化脚本添加到 UC 中的允许列表中，以便用户可以在配置了共享访问模式的计算上利用这些项目：
get, update |
catalogs |
用于管理目录的命令，这是 Unity Catalog 三级命名空间的第一层：
create、、deleteget、list、update |
connections |
用于创建与外部数据源的连接的命令：
create、、deleteget、list、update |
external-locations |
用于管理外部位置的命令，外部位置将云存储路径与授权访问云存储路径的存储凭据相结合：
create、、deleteget、list、update |
functions |
用于管理 Unity Catalog 中的用户定义函数 (UDF) 的命令：
create、、deleteget、list、update |
grants |
用于授予对 Unity Catalog 中数据的访问权限的命令：
get、 get-effective、、 update |
metastores |
用于管理元存储的命令，元存储是 Unity Catalog 中对象的顶级容器：
assign、、create、deletecurrent、get、list、summary、unassign、、 updateupdate-assignment |
model-versions |
用于管理模型版本的命令。 Databricks 提供 Unity Catalog 中的 MLflow 模型注册表的托管版本。
delete、、getget-by-alias、list、update |
online-tables |
用于管理联机表的命令，通过使用这些表，可在访问 Delta 表中的数据时获享更低延迟和更高的 QPS：
create、 delete、、 get |
quality-monitors |
用于管理监视器的命令，这些监视器会计算和监视表随时间变化的数据或模型质量指标：
create、、deleteget、get-refresh、list-refreshes、、 run-refreshupdate |
registered-models |
用于管理已注册模型的命令。 Databricks 提供 Unity Catalog 中的 MLflow 模型注册表的托管版本。
create、、deletedelete-alias、get、list、、 set-aliasupdate |
schemas |
用于管理架构的命令，架构是 Unity Catalog 三级命名空间的第二层：
create、、deleteget、list、update |
storage-credentials |
用于管理存储凭据的命令，存储凭据是用于访问云租户上存储的数据的身份验证和授权机制：
create、、deleteget、list、update、validate |
system-schemas |
用于管理系统架构的命令，系统架构系统目录应用的架构：
disable、 enable、、 list |
table-constraints |
用于管理主键和外键约束的命令，这些约束会对表中字段之间的关系进行编码：
create, delete |
tables |
用于管理表的命令，这些表位于 Unity Catalog 三级命名空间的第三层：
delete、、existsget、list、list-summaries |
volumes |
用于管理卷的命令，卷是 Unity Catalog (UC) 用于访问、存储、管理、组织和处理文件的功能：
create、、deletelist、read、update |
workspace-bindings |
用于管理安全工作区绑定的命令。 可以将 Databricks 中的安全对象配置为 OPEN 或 ISOLATED。
get、、get-bindingsupdate、、update-bindings |
Delta Sharing 命令
| 组 |
说明和命令 |
providers |
用于管理数据提供程序的命令，这些提供程序表示共享数据的组织：
create、、deleteget、list、list-shares、update |
recipient-activation |
管理接收者激活的命令，仅适用于对接收者对象采用 TOKEN 身份验证类型的开放共享模型：
get-activation-url-info, retrieve-token |
recipients |
管理接收者的命令，你可以使用 :method:recipients/create 创建这些接收者，用其来代表你想要允许访问共享内容的组织：
create、、deleteget、list、rotate-token、update
share-permissions |
shares |
用于管理共享的命令，这些共享是使用 :method:shares/create 实例化的容器：
create、、deleteget、list、update
share-permissions, update-permissions |
设置命令
| 组 |
说明和命令 |
ip-access-lists |
用于使管理员能够配置 IP 访问列表的命令：
create、、deleteget、list、replace、update |
settings |
用于允许用户在工作区级别管理设置的命令：
automatic-cluster-update、、csp-enablementdefault-namespace、esm-enablement、restrict-workspace-admins |
token-management |
允许管理员获取所有令牌并删除其他用户的令牌的命令：
create-obo-token、、deleteget、、list
get-permission-levels、、get-permissionsset-permissions、、update-permissions |
tokens |
用于创建、列出和撤销令牌的命令，这些令牌可用于对 Databricks REST API 进行身份验证和访问：
create、 delete、、 list |
workspace-conf |
用于更新工作区设置的命令：
get-status, set-status |
| 组 |
说明和命令 |
| bundle |
用于管理 Databricks 资产捆绑包的命令，通过使用捆绑包，你能够以代码形式表示 Databricks 项目：
deploy、、deployment、generatedestroy、init、run、schema、、 syncvalidate |
| sync |
将本地目录同步到工作区目录。 |
矢量搜索命令
| 组 |
说明和命令 |
vector-search-endpoints |
用于管理矢量搜索终结点的命令，这些终结点表示用于托管矢量搜索索引的计算资源：
create-endpoint、、delete-endpointget-endpoint、、list-endpoints |
vector-search-indexes |
用于管理矢量搜索索引的命令，矢量搜索索引是嵌入矢量的有效表示形式，支持实时高效的接近最近的邻域 (ANN) 搜索查询：
create-index、、delete-data-vector-indexdelete-index、get-index、list-indexes、query-index、、 sync-indexupsert-data-vector-index |
仪表板命令
| 组 |
说明和命令 |
dashboards |
用于修改仪表板的命令：
create、、deleteget、list、restore、update |
lakeview |
为 AI/BI 仪表板提供特定管理操作的命令：
create、、getget-published、migrate、publish、trash、、 unpublishupdate |
其他命令
| 组 |
说明和命令 |
| api |
用于向 Databricks REST API 发出请求的命令：
delete、、gethead、patch、post、put |
| completion |
用于为指定的 shell 生成自动补全脚本的命令：
bash、、fishpowershell、、zsh |
| configure |
配置 Databricks CLI。 |
help |
输出任何命令的使用情况信息。 |
| 实验室 |
用于管理 Databricks Labs 安装的命令：
clear-cache、、installinstalled、list、show、、 uninstallupgrade |
version |
检索当前使用的 CLI 版本。 |
全局标志
以下标志可用于所有 Databricks CLI 命令。 请注意，某些标志不适用于某些命令。 有关特定命令及其标记的详细信息，请参阅命令行帮助。
| 标记 |
描述 |
-h 或 --help |
显示 Databricks CLI、相关命令组或相关命令的帮助。 |
-e 或 --environment string |
一个字符串，表示要使用的捆绑环境（如果适用于相关命令）。 |
--log-file |
一个字符串，表示要将输出日志写入到的位置。 如果未指定此标志，则默认会将输出日志写入到 stderr。 |
--log-format |
如果设置为 text，则以文本格式写入输出日志；如果设置为 json，则以 JSON 格式写入输出日志。 如果未指定此标志，则以文本格式写入输出日志。 |
--log-level |
一个表示日志格式级别的字符串。 如果未指定，则禁用日志格式级别。 |
-o 或 --output |
如果设置为 text，则以文本格式写入输出；如果设置为 json，则以 JSON 格式写入输出。 如果未指定此标志，则以文本格式写入输出。 |
-p 或 --profile |
一个字符串，表示要在 .databrickscfg 文件中使用的命名配置文件。 如果未指定此标志，则使用 DEFAULT 命名配置文件（如果存在）。 可以在 --profile 或 -p 之后按 Tab 以显示可供选择的现有可用配置文件的列表，而不是手动输入配置文件名称。 |
--progress-format |
要显示的进度日志的格式（default（默认值）、append、inplace 或 json）。 |