DQL Data Asynchronous Query¶
POST /api/v1/df/asynchronous/query_data
Overview¶
Body Request Parameters¶
Parameter | Type | Required | Description |
---|---|---|---|
queries | array | Multiple command queries, consisting of a list of query objects Allow empty: False |
|
fieldTagDescNeeded | boolean | Whether field or tag description information is needed Allow empty: False |
Parameter Additional Description¶
Query Description
- Parameter Description
Parameter | type | Required | Description |
---|---|---|---|
queries | array | Y | Multiple command queries, consisting of a list of query objects |
fieldTagDescNeeded | boolean | Whether field or tag description information is needed |
- queries[*] Member Parameter Structure Description
*** Note, the
async_id
parameter has been added based on the "DQL Data Query" interface ***
Parameter | type | Required | Description |
---|---|---|---|
async_id |
string | N | Asynchronous query task ID, this value comes from the content.data[*].async_id in the last DQL query result; if this value exists in the last query result, it needs to be included in this query |
qtype | string | Y | The type of query statement dql: indicates DQL type query statement; promql: indicates PromQl type query statement |
query | json | Y | Query structure |
query.q | string | The query statement consistent with the qtype, such as DQL or PromQL query statement | |
query.ignore_cache | boolean | Whether the query disables caching, default is false, indicating using cache | |
query.promqlType | enum | Effective when qtype=promql, the type of PromQL query, optional values instantQuery and rangeQuery , default value is rangeQuery |
|
query.highlight | boolean | Whether to display highlighted data | |
query.timeRange | array | Timestamp list of the time range | |
query.disableMultipleField | bool | Whether to enable single-column mode, default is true |
|
query.showLabel | bool | Whether to display object labels, default is none | |
query.funcList | array | Re-aggregate to modify DQL return values, note that when disableMultipleField=Flse, this parameter is invalid | |
query.slimit | integer | Time series group size, only effective for Metrics queries | |
query.soffset | integer | Time series group offset | |
query.limit | integer | Pagination size | |
query.offset | integer | Pagination offset | |
query.orderby | array | Sorting list, {fieldName:method} , note that sorting for Measurement queries only supports fieldName=time; method in ["desc", "asc"]; note that sorting for Measurement queries only supports fieldName=time |
|
query.sorderby | array | Sorting list, sorderby's column is an expression, supports all aggregate functions returning a single value min max last avg p90 p95 count, {fieldName:method} , structure consistent with orderby |
|
query.order_by | array | Sorting list, structure is [{"column": "field", "order": "DESC"}], doris engine compatibility field | |
query.sorder_by | array | Sorting list, structure is [{"column": "field", "order": "DESC"}], doris engine compatibility field | |
query.density | string | Response point density, priority is less than autoDensity and greater than the density set in the DQL statement | |
query.interval | integer | Unit is seconds, time slice interval, used to calculate response points; if the calculated points are less than or equal to the points when density=high, it is valid, otherwise invalid | |
query.search_after | array | Pagination query marker. The search_after value in the response result of the last request with the same parameters is used as the parameter for this request. | |
query.maxPointCount | integer | Maximum points | |
query.workspaceUUID | string | The uuid of the workspace to be queried, "*" means query all authorized spaces, refer to the interface /wksp_share/granted_ws_list for viewable spaces | |
query.workspaceUUIDs | array | The uuids of the workspaces to be queried, priority is higher than query.workspaceUUID. ["*"] means query all authorized spaces, refer to the interface /wksp_share/granted_ws_list for viewable spaces | |
query.targetRegion | string | When the query workspace is specified as ["*"], this field is required | |
query.output_format | string | lineprotocol: line protocol output, if not filled, the default output format remains unchanged | |
query.cursor_time | integer | Segmented query threshold: for the first segmented query, cursor_time needs to be set to end_time; for subsequent segmented queries, cursor_time needs to be set to the next_cursor_time in the response | |
query.cursor_token | string | Pagination query token (returned by the engine cursor_token value): for pagination queries, the next_cursor_token returned by the last query needs to be set as the cursor_token for this query; requests without cursor_token may cause data with the same timestamp to be skipped during pagination. | |
query.disable_sampling | bool | Sampling disable switch, default value is false |
- Response Point Density
density
Parameter Value Description
Optional Value | Description |
---|---|
lower | Lower, 60 points |
low | Low, 180 points |
medium | Medium, 360 points |
high | Low, 720 points |
-
Note the priority of the point density parameter, maximum density
density[high]
* maxPointCount > interval > density > control parameters in the DQL statement -
Common Query Descriptions
-
Unrecovered Incident Query Note: When performing data queries through the openapi interface, the default role is administrator. Note that it may be subject to data access rule restrictions