DQL数据异步查询¶

POST /api/v1/df/asynchronous/query_data

概述¶

Body 请求参数¶

参数名	类型	必选	说明
queries	array		多命令查询，其内容为 query 对象组成的列表允许为空: False
fieldTagDescNeeded	boolean		是否需要field 或者tag描述信息允许为空: False

参数补充说明¶

查询说明

参数说明

参数名	type	必选	说明
queries	array	Y	多命令查询，其内容为 query 对象组成的列表
fieldTagDescNeeded	boolean		是否需要field 或者tag描述信息

queries[*]成员参数结构说明 *** 注意, 在「DQL数据查询」接口基础上添加了async_id参数 ***

参数名	type	必选	说明
`async_id`	string	N	异步查询任务ID, 该值来自上次dql查询结果中的 content.data[*].async_id; 如果上一次查询返回结果中存在该值, 则本次查询需要带上该值
qtype	string	Y	查询语句的类型 dql: 表示dql类型查询语句; promql: 表示 PromQl类型查询语句
query	json	Y	查询结构
query.q	string		与 qtype 类型保持一致的查询语句，例如 dql 或者 promql 查询语句
query.highlight	boolean		是否显示高亮数据
query.timeRange	array		时间范围的时间戳列表
query.disableMultipleField	bool		是否打开单列模式，默认为 `true`
query.showLabel	bool		是否显示对象的lables，默认无
query.funcList	array		再次聚合修饰dql返回值，注意 disableMultipleField=Flse时, 当前参数无效
query.slimit	integer		时间线分组大小，只针对指标查询有效
query.soffset	integer		时间线分组偏移量
query.limit	integer		分页大小
query.offset	integer		分页偏移量
query.orderby	array		排序列表，`{fieldName:method}` , 注意指标集查询的排序只支持 fieldName=time; method in ["desc", "asc"];注意指标集查询的排序只支持 fieldName=time
query.sorderby	array		排序列表，sorderby 的 column 是一个表达式，支持所有返回单个值的聚合函数min max last avg p90 p95 count, `{fieldName:method}`,结构和orderby一致
query.order_by	array		排序列表，结构为[{"column": "field", "order": "DESC"}], doris引擎兼容字段
query.sorder_by	array		排序列表，结构为[{"column": "field", "order": "DESC"}], doris引擎兼容字段
query.density	string		响应的点密度, 优先级小于 autoDensity 且大于 dql语句中设置的密度
query.interval	integer		单位是秒，时间分片间隔，用于计算响应点数；计算出的点数小于等于density=high时的点数，则有效，否则无效
query.search_after	array		分页查询标记。相同参数上次请求响应结果中的 search_after 值作为本次请求的参数。
query.maxPointCount	integer		最大点数
query.workspaceUUID	string		要查询工作空间的uuid
query.output_format	string		lineprotocol: 行协议输出，默认不填的话，默认保持现有输出格式不变
query.cursor_time	integer		分段查询阀值: 第一次分段查询时，需要把 cursor_time 设置为 end_time；之后的分段查询，需要把 cursor_time 设置为响应中的 next_cursor_time
query.disable_sampling	bool		采样禁用开关, 默认值为 false

响应点密度density 参数值说明

可选值	说明
lower	较低，60个点
low	低，180个点
medium	中等，360个点
high	低，720个点

注意点密度参数的优先级，最大密度density[high] * maxPointCount > interval > density > dql语句中的控制参数

响应¶