提交SQL查询任务。
接口说明
仅适合提交中小型查询，执行时间不能超过 1 个小时
查询结果最多返回 10000 条
单个主账号下并发执行有限制，如同时提交多次查询会排队。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dlf:SubmitQuery |
*全部资源
|
无 | 无 |
请求语法
POST /webapi/query/submitQueryRequestBody HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
HTTP 请求体。 |
|
| sql |
string |
否 |
SQL 语句。 |
show databases |
| workspaceId |
string |
否 |
工作空间 ID。 |
WS-A129E61C4892D2B4 |
| catalogId |
string |
否 |
数据目录 ID。 |
catalog1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
创建查询的结果。 |
{ "success" : true } |
|
| Data |
string |
返回数据。 |
Q-14475CF9B51FCE5E |
| RequestId |
string |
请求 ID。 |
279AA630-A8ED-5EA9-80A3-2E213D63548C |
| Success |
boolean |
操作是否成功。取值为：
|
true |
示例
正常返回示例
JSON格式
{
"Data": "Q-14475CF9B51FCE5E",
"RequestId": "279AA630-A8ED-5EA9-80A3-2E213D63548C",
"Success": true
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | Query.ClusterNotReady | Query cluster is not ready. Please try again later. | 查询集群资源正在准备中，请稍后重试 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。