执行 sql、spl 等查询接口
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /workspace/{workspace}/dataset/{datasetName}/query HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| workspace |
string |
是 |
工作空间 ID |
workspace-test |
| datasetName |
string |
是 |
数据集名称 |
test_dataset |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求参数 |
|
| type |
string |
是 |
类型 |
SQL |
| query |
string |
是 |
查询内容 |
SELECT count(1) from "datasetname" |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应数据 |
||
| requestId |
string |
请求 ID |
3B311FD9-A60B-55E0-A896-A0C73********* |
| meta |
object |
元数据 |
|
| affectedRows |
integer |
扫描/处理的日志行数 |
1 |
| elapsedMillisecond |
integer |
本次执行消耗的毫秒时间 |
1231243 |
| progress |
string |
查询的结果是否完整 |
Complete |
| count |
integer |
本次查询请求返回的日志行数。 |
1 |
| data |
array<object> |
日志数据数组，每条日志对应一个元素 |
|
|
object |
日志数据数组 |
||
|
string |
返回的日志 |
{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'} |
示例
正常返回示例
JSON格式
{
"requestId": "3B311FD9-A60B-55E0-A896-A0C73*********",
"meta": {
"affectedRows": 1,
"elapsedMillisecond": 1231243,
"progress": "Complete",
"count": 1
},
"data": [
{
"key": "{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。