注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
注释
Databricks SQL API 的新版本现已推出。 请参阅 最新 Databricks SQL API 版本的更新。 若要对新的 Databricks SQL 查询执行操作，请参阅 queries 命令组。
Databricks CLI 中的 queries-legacy 命令组允许对遗留查询定义执行获取、创建、更新和删除操作。
Databricks 查询-遗留 创建
创建新的查询定义。 使用此终结点创建的查询属于发出请求的经过身份验证的用户。
该 data_source_id 字段指定要对其运行此查询的 SQL 仓库的 ID。 可以使用 数据源命令 查看可用 SQL 仓库的完整列表。 或者，您可以从现有查询中复制data_source_id。
注释
在创建查询之前，无法添加可视化效果。
databricks queries-legacy create [flags]
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
Databricks 查询-旧版 删除
将查询移动到回收站。 废旧查询会立即从搜索和列表视图中消失，它们不能用于警报。 回收站在 30 天后删除。
databricks queries-legacy delete QUERY_ID [flags]
论据
QUERY_ID
要删除的查询的 ID
选项
Databricks 查询-遗留获取
获取查询对象定义以及有关当前经过身份验证的用户的上下文权限信息。
databricks queries-legacy get QUERY_ID [flags]
论据
QUERY_ID
要获取的查询的 ID
选项
databricks 查询-传统列表
获取查询列表。 （可选）可以通过搜索词筛选此列表。
重要
并发运行此命令 10 次或多次可能会导致限制、服务降级或临时禁止。
databricks queries-legacy list [flags]
选项
--order string
要排序依据的查询属性的名称。
--page int
要检索的页码。
--page-size int
每页要返回的查询数。
--q string
全文搜索词。
databricks 查询-旧版还原
还原已移动到回收站的查询。 还原的查询显示在列表视图和搜索中。 可以使用恢复的查询来设置警报。
databricks queries-legacy restore QUERY_ID [flags]
论据
QUERY_ID
要恢复的查询 ID
选项
databricks 查询-旧版更新
修改查询定义。
注释
无法撤消此操作。
databricks queries-legacy update QUERY_ID [flags]
论据
QUERY_ID
要更新的查询的 ID
选项
--data-source-id string
数据源 ID 映射到资源使用的数据源的 ID，不同于仓库 ID。
--description string
传达有关此查询的其他信息的常规说明，例如使用情况说明。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
--name string
显示在列表视图、小组件标题和查询页上的此查询的标题。
--query string
要运行的查询的文本。
--run-as-role RunAsRole
设置“运行方式”角色，适用于该对象。 支持的值：owner、viewer
全局标志
--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 字符串
如果适用，要使用的捆绑包目标