Note
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 The Databricks CLI is in Public Preview.
Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.
Note
Databricks SQL API 的新版本现已推出。 请参阅 最新 Databricks SQL API 版本的更新。 若要对新的 Databricks SQL 查询执行作，请参阅 queries 命令组。
The queries-legacy command group within the Databricks CLI allows you to perform get, create, update, and delete operations on legacy query definitions.
databricks queries-legacy create
创建新的查询定义。 使用此终结点创建的查询属于发出请求的经过身份验证的用户。
该 data_source_id 字段指定要对其运行此查询的 SQL 仓库的 ID。 You can use the data-sources command to see a complete list of available SQL warehouses. 或者，可以从现有查询复制 data_source_id 该查询。
Note
在创建查询之前，无法添加可视化效果。
databricks queries-legacy create [flags]
选项
--json JSON
内联 JSON 字符串或 @path 包含请求正文的 JSON 文件的 JSON 文件。
databricks queries-legacy delete
将查询移动到回收站。 废旧查询会立即从搜索和列表视图中消失，它们不能用于警报。 回收站在 30 天后删除。
databricks queries-legacy delete QUERY_ID [flags]
Arguments
QUERY_ID
要删除的查询的 ID
选项
databricks queries-legacy get
获取查询对象定义以及有关当前经过身份验证的用户的上下文权限信息。
databricks queries-legacy get QUERY_ID [flags]
Arguments
QUERY_ID
要获取的查询的 ID
选项
databricks queries-legacy list
获取查询列表。 （可选）可以通过搜索词筛选此列表。
Important
并发运行此命令 10 次或多次可能会导致限制、服务降级或临时禁止。
databricks queries-legacy list [flags]
选项
--order string
要排序依据的查询属性的名称。
--page int
要检索的页码。
--page-size int
每页要返回的查询数。
--q string
全文搜索词。
databricks 查询-旧还原
还原已移动到回收站的查询。 还原的查询显示在列表视图和搜索中。 可以对警报使用还原的查询。
databricks queries-legacy restore QUERY_ID [flags]
Arguments
QUERY_ID
要还原的查询的 ID
选项
databricks 查询-旧版更新
修改查询定义。
Note
无法撤消此作。
databricks queries-legacy update QUERY_ID [flags]
Arguments
QUERY_ID
要更新的查询的 ID
选项
--data-source-id string
数据源 ID 映射到资源使用的数据源的 ID，不同于仓库 ID。
--description string
传达有关此查询的其他信息的常规说明，例如使用情况说明。
--json JSON
内联 JSON 字符串或 @path 包含请求正文的 JSON 文件的 JSON 文件。
--name string
显示在列表视图、小组件标题和查询页上的此查询的标题。
--query string
要运行的查询的文本。
--run-as-role RunAsRole
Sets the Run as role for the object. 支持的值： owner、 viewer
Global flags
--debug
是否启用调试日志记录。
-h 或 --help
显示 Databricks CLI、相关命令组或相关命令的帮助。
--log-file 字符串
一个字符串，表示要将输出日志写入到的文件。 如果未指定此标志，则默认会将输出日志写入到 stderr。
--log-format 格式
日志格式类型或 textjson。 默认值是 text。
--log-level 字符串
一个表示日志格式级别的字符串。 如果未指定，则禁用日志格式级别。
-o, --output 类型
命令输出类型或 textjson。 默认值是 text。
-p, --profile 字符串
用于运行命令的文件中配置文件 ~/.databrickscfg 的名称。 如果未指定此标志，则如果存在，则使用命名 DEFAULT 的配置文件。
--progress-format 格式
显示进度日志的格式： default、 append、 inplace或 json
-t, --target 字符串
如果适用，要使用的捆绑包目标