@dynatrace-sdk/client-query 1.12.1 → 1.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +17 -0
- package/README.md +44 -7
- package/cjs/index.js +444 -261
- package/dynatrace-metadata.json +3 -3
- package/esm/index.js +432 -238
- package/package.json +3 -2
- package/types/packages/client/query/src/lib/apis/query-assistance-api.d.ts +18 -0
- package/types/packages/client/query/src/lib/apis/query-execution-api.d.ts +23 -0
- package/types/packages/client/query/src/lib/error-envelopes/api-gateway-errors-handler.d.ts +2 -0
- package/types/packages/client/query/src/lib/error-envelopes/error-envelope-error.d.ts +2 -1
- package/types/packages/client/query/src/lib/error-envelopes/index.d.ts +2 -3
- package/types/packages/client/query/src/lib/error-envelopes/responses/insufficient-permission.d.ts +9 -0
- package/types/packages/client/query/src/lib/models/autocomplete-suggestion.d.ts +1 -1
- package/types/packages/client/query/src/lib/models/execute-request.d.ts +2 -0
- package/types/packages/client/query/src/lib/models/execute-request.transformation.d.ts +2 -0
- package/types/packages/client/query/src/lib/models/field-type-type.d.ts +1 -0
- package/types/packages/client/query/src/lib/models/filter-segment-variable-definition.d.ts +7 -0
- package/types/packages/client/query/src/lib/models/filter-segment-variable-definition.transformation.d.ts +9 -0
- package/types/packages/client/query/src/lib/models/filter-segment.d.ts +8 -0
- package/types/packages/client/query/src/lib/models/filter-segment.transformation.d.ts +10 -0
- package/types/packages/client/query/src/lib/models/filter-segments.d.ts +6 -0
- package/types/packages/client/query/src/lib/models/filter-segments.transformation.d.ts +6 -0
- package/types/packages/client/query/src/lib/models/index.d.ts +6 -0
- package/types/packages/client/query/src/lib/models/query-options.d.ts +1 -1
- package/types/packages/client/query/src/lib/models/token-type.d.ts +2 -1
- package/types/packages/{client/query/src/lib/error-envelopes → shared-errors/src}/api-client-error.d.ts +2 -1
- package/types/packages/shared-errors/src/api-gateway-error.d.ts +18 -0
- package/types/packages/{client/query/src/lib/error-envelopes → shared-errors/src}/client-request-error.d.ts +4 -2
- package/types/packages/shared-errors/src/index.d.ts +6 -0
- package/types/packages/{client/query/src/lib/error-envelopes → shared-errors/src}/invalid-response-error.d.ts +1 -0
- package/types/packages/shared-errors/src/sdk-error.d.ts +5 -0
- package/types/packages/shared-errors/src/types.d.ts +31 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
@dynatrace-sdk/client-query
|
|
4
4
|
|
|
5
|
+
## 1.15.0
|
|
6
|
+
|
|
7
|
+
### Minor Changes
|
|
8
|
+
- Add new token type to the `TokenType` enum and new field type to the `FieldType` enum.
|
|
9
|
+
|
|
10
|
+
## 1.14.0
|
|
11
|
+
|
|
12
|
+
### Minor Changes
|
|
13
|
+
|
|
14
|
+
- Introduced @dynatrace-sdk/shared-errors package and improved response errors handling.
|
|
15
|
+
|
|
16
|
+
## 1.13.0
|
|
17
|
+
|
|
18
|
+
### Features
|
|
19
|
+
|
|
20
|
+
- Add `filterSegments` property to `ExecuteRequest`
|
|
21
|
+
|
|
5
22
|
## 1.12.1
|
|
6
23
|
|
|
7
24
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @dynatrace-sdk/client-query
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.15.0)
|
|
4
4
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
5
5
|
|
|
6
6
|
Exposes an API to fetch records stored in Grail
|
|
@@ -729,7 +729,7 @@ Single suggestion for completion of the query.
|
|
|
729
729
|
|
|
730
730
|
| Name | Type | Description |
|
|
731
731
|
| --- | --- | --- |
|
|
732
|
-
|alreadyTypedCharacters<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Number of characters that the user
|
|
732
|
+
|alreadyTypedCharacters<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Number of characters that the user already typed for this suggestion. |
|
|
733
733
|
|parts<sup>*required</sup>|Array<<a href="#autocompletesuggestionpart">AutocompleteSuggestionPart</a>>|List of suggestion parts. |
|
|
734
734
|
|suggestion<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The suggested continuation of the query. |
|
|
735
735
|
|
|
@@ -879,11 +879,12 @@ Detailed information about the error.
|
|
|
879
879
|
|defaultTimeframeStart|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timeframe 'start' timestamp in ISO-8601 or RFC3339 format. If the timeframe 'end' parameter is missing, the whole timeframe is ignored. <em>Note that if a timeframe is specified within the query string (query) then it has precedence over this query request parameter.</em> |
|
|
880
880
|
|enablePreview|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|Request preview results. If a preview is available within the requestTimeoutMilliseconds, then it will be returned as part of the response. |
|
|
881
881
|
|fetchTimeoutSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The query will stop reading data after reaching the fetch-timeout. The query execution will continue, providing a partial result based on the read data. |
|
|
882
|
+
|filterSegments|<a href="#filtersegments">FilterSegments</a>| |
|
|
882
883
|
|locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
|
|
883
884
|
|maxResultBytes|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result bytes that this query will return. |
|
|
884
885
|
|maxResultRecords|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result records that this query will return. |
|
|
885
886
|
|query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
|
|
886
|
-
|queryOptions|<a href="#queryoptions">QueryOptions</a>| |
|
|
887
|
+
|queryOptions|<a href="#queryoptions" target="_blank" rel="noopener noreferrer">QueryOptions</a>| |
|
|
887
888
|
|requestTimeoutMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time a client is willing to wait for the query result. In case the query finishes within the specified timeout, the query result is returned. Otherwise, the requestToken is returned, allowing polling for the result. |
|
|
888
889
|
|timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
|
|
889
890
|
|
|
@@ -897,7 +898,43 @@ The possible type of a field in DQL.
|
|
|
897
898
|
| Name | Type |
|
|
898
899
|
| --- | --- |
|
|
899
900
|
|type<sup>*required</sup>|FieldTypeType|
|
|
900
|
-
|types|Array<<a href="#rangedfieldtypes"
|
|
901
|
+
|types|Array<<a href="#rangedfieldtypes">RangedFieldTypes</a>>|
|
|
902
|
+
|
|
903
|
+
### FilterSegment
|
|
904
|
+
|
|
905
|
+
|
|
906
|
+
|
|
907
|
+
|
|
908
|
+
A filter segment is identified by an ID. Each segment includes a list of variable definitions.
|
|
909
|
+
|
|
910
|
+
| Name | Type |
|
|
911
|
+
| --- | --- |
|
|
912
|
+
|id<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|
|
|
913
|
+
|variables|Array<<a href="#filtersegmentvariabledefinition" target="_blank" rel="noopener noreferrer">FilterSegmentVariableDefinition</a>>|
|
|
914
|
+
|
|
915
|
+
### FilterSegmentVariableDefinition
|
|
916
|
+
|
|
917
|
+
|
|
918
|
+
|
|
919
|
+
|
|
920
|
+
Defines a variable with a name and a list of values.
|
|
921
|
+
|
|
922
|
+
| Name | Type |
|
|
923
|
+
| --- | --- |
|
|
924
|
+
|name<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|
|
|
925
|
+
|values<sup>*required</sup>|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|
|
|
926
|
+
|
|
927
|
+
### FilterSegments
|
|
928
|
+
|
|
929
|
+
|
|
930
|
+
extends `Array<FilterSegment>`
|
|
931
|
+
|
|
932
|
+
Represents a collection of filter segments.
|
|
933
|
+
|
|
934
|
+
| Name | Type | Description |
|
|
935
|
+
| --- | --- | --- |
|
|
936
|
+
|[unscopables]<sup>*required</sup>|Object|<p>Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement.</p> |
|
|
937
|
+
|length<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Gets or sets the length of the array. This is a number one higher than the highest index in the array. |
|
|
901
938
|
|
|
902
939
|
### GeoPoint
|
|
903
940
|
|
|
@@ -1013,7 +1050,7 @@ The exact position in the query string.
|
|
|
1013
1050
|
|
|
1014
1051
|
|
|
1015
1052
|
|
|
1016
|
-
Query options.
|
|
1053
|
+
Query options enhance query functionality for Dynatrace internal services.
|
|
1017
1054
|
|
|
1018
1055
|
### QueryPollResponse
|
|
1019
1056
|
|
|
@@ -1166,7 +1203,7 @@ The type of the node.
|
|
|
1166
1203
|
|
|
1167
1204
|
<div class="padding-left--md">
|
|
1168
1205
|
|
|
1169
|
-
`Array` | `Binary` | `Boolean` | `Double` | `Duration` | `GeoPoint` | `IpAddress` | `Long` | `Record` | `String` | `Timeframe` | `Timestamp` | `Uid` | `Undefined`
|
|
1206
|
+
`Array` | `Binary` | `Boolean` | `Double` | `Duration` | `GeoPoint` | `IpAddress` | `Long` | `Record` | `SmartscapeId` | `String` | `Timeframe` | `Timestamp` | `Uid` | `Undefined`
|
|
1170
1207
|
|
|
1171
1208
|
</div>
|
|
1172
1209
|
|
|
@@ -1202,7 +1239,7 @@ The type of the autocomplete token.
|
|
|
1202
1239
|
|
|
1203
1240
|
<div class="padding-left--md">
|
|
1204
1241
|
|
|
1205
|
-
`Assignment` | `BooleanFalse` | `BooleanTrue` | `BraceClose` | `BraceOpen` | `BracketClose` | `BracketOpen` | `Colon` | `Comma` | `CommandName` | `DataObject` | `Dot` | `EndComment` | `EntityAttribute` | `EntitySelectorPart` | `EntityType` | `FieldModifier` | `FieldPattern` | `FunctionName` | `Indent` | `Linebreak` | `MetricKey` | `Null` | `Number` | `Operator` | `ParameterKey` | `ParameterValueScope` | `ParenthesisClose` | `ParenthesisOpen` | `ParsePattern` | `Pipe` | `Quote` | `SimpleIdentifier` | `SingleQuote` | `Slash` | `Space` | `String` | `TimeUnit` | `TimeseriesAggregation` | `TimeseriesAggregationExpression` | `TimestampValue` | `TraversalHopCount` | `TraversalOperator` | `TraversalRelationName` | `UidValue` | `Variable`
|
|
1242
|
+
`Assignment` | `BooleanFalse` | `BooleanTrue` | `BraceClose` | `BraceOpen` | `BracketClose` | `BracketOpen` | `Colon` | `Comma` | `CommandName` | `DataObject` | `Dot` | `EndComment` | `EntityAttribute` | `EntitySelectorPart` | `EntityType` | `FieldModifier` | `FieldPattern` | `FunctionName` | `Indent` | `Linebreak` | `MetricKey` | `Null` | `Number` | `Operator` | `ParameterKey` | `ParameterValueScope` | `ParenthesisClose` | `ParenthesisOpen` | `ParsePattern` | `Pipe` | `Quote` | `SimpleIdentifier` | `SingleQuote` | `Slash` | `SmartscapeIdValue` | `Space` | `String` | `TimeUnit` | `TimeseriesAggregation` | `TimeseriesAggregationExpression` | `TimestampValue` | `TraversalHopCount` | `TraversalOperator` | `TraversalRelationName` | `UidValue` | `Variable`
|
|
1206
1243
|
|
|
1207
1244
|
</div>
|
|
1208
1245
|
|