Description on query expansion.

This commit is contained in:
Fabian Märki
2018-09-12 14:24:00 +02:00
parent c6b966d468
commit f87fc644d1

View File

@ -381,15 +381,19 @@ Queries are applied to a range. The following types of ranges are supported.
"range":{ "range":{
"startPulseId":0, "startPulseId":0,
"startInclusive":true, "startInclusive":true,
"startExpansion":false,
"endPulseId":100, "endPulseId":100,
"endInclusive":true "endInclusive":true,
"endExpansion":false
} }
``` ```
- **startPulseId**: The start pulse-id of the range request. - **startPulseId**: The start pulse-id of the range request.
- **startInclusive**: Defines if the start should be considered inclusive (values: **true**|false). - **startInclusive**: Defines if the start should be considered inclusive (values: **true**|false).
- **startExpansion**: Expands the query start until the first entry before the defined start (values: true|**false**). Binning aggregations are expanded until the start of the bin of that entry.
- **endPulseId**: The end pulse-id of the range request. - **endPulseId**: The end pulse-id of the range request.
- **endInclusive**: Defines if the end should be considered inclusive (values: **true**|false). - **endInclusive**: Defines if the end should be considered inclusive (values: **true**|false).
- **endExpansion**: Expands the query end until the first entry after the defined end (values: true|**false**). Binning aggregations are expanded until the end of the bin of that entry.
#### By Date #### By Date
@ -398,15 +402,19 @@ Queries are applied to a range. The following types of ranges are supported.
"range":{ "range":{
"startDate":"2015-08-06T18:00:00.000", "startDate":"2015-08-06T18:00:00.000",
"startInclusive":true, "startInclusive":true,
"startExpansion":false,
"endDate":"2015-08-06T18:59:59.999", "endDate":"2015-08-06T18:59:59.999",
"endInclusive":true "endInclusive":true,
"endExpansion":false
} }
``` ```
- **startDate**: The start date of the time range in the ISO8601 format (such as 1997-07-16T19:20:30.123+02:00 or 1997-07-16T19:20:30.123456789+02:00 (omitting +02:00 falls back to the server's time zone)). - **startDate**: The start date of the time range in the ISO8601 format (such as 1997-07-16T19:20:30.123+02:00 or 1997-07-16T19:20:30.123456789+02:00 (omitting +02:00 falls back to the server's time zone)).
- **startInclusive**: Defines if the start should be considered inclusive (values: **true**|false). - **startInclusive**: Defines if the start should be considered inclusive (values: **true**|false).
- **startExpansion**: Expands the query start until the first entry before the defined start (values: true|**false**). Binning aggregations are expanded until the start of the bin of that entry.
- **endDate**: The end date of the time range. - **endDate**: The end date of the time range.
- **endInclusive**: Defines if the end should be considered inclusive (values: **true**|false). - **endInclusive**: Defines if the end should be considered inclusive (values: **true**|false).
- **endExpansion**: Expands the query end until the first entry after the defined end (values: true|**false**). Binning aggregations are expanded until the end of the bin of that entry.
#### By Time #### By Time
@ -415,15 +423,19 @@ Queries are applied to a range. The following types of ranges are supported.
"range":{ "range":{
"startSeconds":"0.0", "startSeconds":"0.0",
"startInclusive":true, "startInclusive":true,
"startExpansion":false,
"endSeconds":"1.000999999", "endSeconds":"1.000999999",
"endInclusive":true "endInclusive":true,
"endExpansion":false
} }
``` ```
- **startSeconds**: The start time of the range in seconds since midnight, January 1, 1970 UTC (the UNIX epoch) as a decimal value including fractional seconds. - **startSeconds**: The start time of the range in seconds since midnight, January 1, 1970 UTC (the UNIX epoch) as a decimal value including fractional seconds.
- **startInclusive**: Defines if the start should be considered inclusive (values: **true**|false). - **startInclusive**: Defines if the start should be considered inclusive (values: **true**|false).
- **startExpansion**: Expands the query start until the first entry before the defined start (values: true|**false**). Binning aggregations are expanded until the start of the bin of that entry.
- **endSeconds**: The end time of the range in seconds. - **endSeconds**: The end time of the range in seconds.
- **endInclusive**: Defines if the end should be considered inclusive (values: **true**|false). - **endInclusive**: Defines if the end should be considered inclusive (values: **true**|false).
- **endExpansion**: Expands the query end until the first entry after the defined end (values: true|**false**). Binning aggregations are expanded until the end of the bin of that entry.
<a name="data_ordering"/> <a name="data_ordering"/>