@dynatrace-sdk/client-query 1.10.1 → 1.11.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 @dynatrace-sdk/client-query
 
+## 1.11.0
+
+### Minor Changes
+
+- Add `canonicalQuery` property to VerifyRequest
+- Provide actual error code in the error message instead of wildcard. APPDEV-7744
+- Add option to generate canonical query to `VerifyRequest`
+
+### Patch Changes
+
+- Do not print empty fields in the default message of an error. APPDEV-7630
+- Fix typo in the description of `defaultTimeframeStart`
+- Remove `Authorization` header
+- Update documentation. APPDEV-8154
+
 ## 1.10.1
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # @dynatrace-sdk/client-query
 
-[![npm](https://img.shields.io/badge/npm-v1.10.1-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.10.1)
+[![npm](https://img.shields.io/badge/npm-v1.11.0-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.11.0)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 Exposes an API to fetch records stored in Grail
@@ -87,10 +87,9 @@ a link to docs, etc.
 
 #### Parameters
 
-| Name | Type| Description|
-|---|---|---|
-|config.authorization|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The authorization context. Typically start with 'Bearer '. |
-|config.body<sup>*required</sup>|[AutocompleteRequest](#autocompleterequest)| |
+| Name | Type |
+| --- | --- |
+|config.body<sup>*required</sup>|[AutocompleteRequest](#autocompleterequest)| 
 
 
 
@@ -332,10 +331,9 @@ When displaying the query, pick one option. You may use the other options for ho
 
 #### Parameters
 
-| Name | Type| Description|
-|---|---|---|
-|config.authorization|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The authorization context. Typically start with 'Bearer '. |
-|config.body<sup>*required</sup>|[ParseRequest](#parserequest)| |
+| Name | Type |
+| --- | --- |
+|config.body<sup>*required</sup>|[ParseRequest](#parserequest)| 
 
 
 
@@ -392,10 +390,9 @@ submitting the query for execution.
 
 #### Parameters
 
-| Name | Type| Description|
-|---|---|---|
-|config.authorization|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The authorization context. Typically start with 'Bearer '. |
-|config.body<sup>*required</sup>|[VerifyRequest](#verifyrequest)| |
+| Name | Type |
+| --- | --- |
+|config.body<sup>*required</sup>|[VerifyRequest](#verifyrequest)| 
 
 
 
@@ -486,8 +483,8 @@ It is guaranteed that every field of every record will have a corresponding type
 
 #### Parameters
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |config.enrich|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|If set additional data will be available in the metadata section. |
 |config.requestToken<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The request-token of the query. |
 
@@ -572,9 +569,8 @@ It is guaranteed that every field of every record will have a corresponding type
 
 #### Parameters
 
-| Name | Type| Description|
-|---|---|---|
-|config.authorization|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The authorization context. Typically start with 'Bearer '. |
+| Name | Type | Description |
+| --- | --- | --- |
 |config.body<sup>*required</sup>|[ExecuteRequest](#executerequest)| |
 |config.enrich|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|If set additional data will be available in the metadata section. |
 
@@ -659,8 +655,8 @@ It is guaranteed that every field of every record will have a corresponding type
 
 #### Parameters
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |config.enrich|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|If set additional data will be available in the metadata section. |
 |config.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 query status is returned. |
 |config.requestToken<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The request-token of the query. |
@@ -701,8 +697,9 @@ const data = await queryExecutionClient.queryPoll({
 
 
 
-| Name | Type| Description|
-|---|---|---|
+
+| Name | Type | Description |
+| --- | --- | --- |
 |cursorPosition|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |
 |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'. |
 |maxDataSuggestions|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |
@@ -714,10 +711,11 @@ const data = await queryExecutionClient.queryPoll({
 
 
 
+
 The response of the autocomplete call.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |optional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the suggestions are optional. |
 |suggestedTtlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Suggested duration in seconds, for how long the response may be cached and reused by the client. It is derived from the volatility of the suggestions on the server (if the suggestions are static, how long the server will cache the volatile suggestions, ...). If not provided, then the result may be cached for long time. Value below 1 means that the result should not be cached. |
 |suggestions<sup>*required</sup>|Array&lt;[AutocompleteSuggestion](#autocompletesuggestion)&gt;|The list of suggestions. |
@@ -726,10 +724,11 @@ The response of the autocomplete call.
 
 
 
+
 Single suggestion for completion of the query.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |alreadyTypedCharacters<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Number of characters that the user user already typed for this suggestion. |
 |parts<sup>*required</sup>|Array&lt;[AutocompleteSuggestionPart](#autocompletesuggestionpart)&gt;|List of suggestion parts. |
 |suggestion<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The suggested continuation of the query. |
@@ -738,10 +737,11 @@ Single suggestion for completion of the query.
 
 
 
+
 Part of the suggestion.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |info|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The type of the suggestion. |
 |suggestion<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The suggested continuation of the query. |
 |synopsis|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The synopsis of the suggestion. |
@@ -751,10 +751,11 @@ Part of the suggestion.
 
 
 
+
 The DQL node that has alternatives.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |alternatives|object|The different alternatives. |
 |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
 |nodeType<sup>*required</sup>|DQLNodeNodeType| |
@@ -764,10 +765,11 @@ The DQL node that has alternatives.
 
 
 
+
 The DQL node that contains other nodes.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |children|Array&lt;[DQLNode](#dqlnode)&gt;|The list of children nodes. |
 |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
 |nodeType<sup>*required</sup>|DQLNodeNodeType| |
@@ -778,10 +780,11 @@ The DQL node that contains other nodes.
 
 
 
+
 General Node in the DQL query.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
 |nodeType<sup>*required</sup>|DQLNodeNodeType| |
 |tokenPosition|[TokenPosition](#tokenposition)| |
@@ -790,10 +793,11 @@ General Node in the DQL query.
 
 
 
+
 Node that represents single token.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |canonicalString|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Canonical form. |
 |isMandatoryOnUserOrder|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|For optional items only: whether this node becomes mandatory when user order is used. True only for some optional 'ghost braces' |
 |isOptional<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the node is optional. |
@@ -805,20 +809,22 @@ Node that represents single token.
 
 
 
+
 An &apos;envelope&apos; error object that has the mandatory error object.
 
-| Name | Type|
-|---|---|
+| Name | Type |
+| --- | --- |
 |error<sup>*required</sup>|[ErrorResponse](#errorresponse)|
 
 ### ErrorResponse
 
 
 
+
 The response for error state
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |code<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Error code, which normally matches the HTTP error code. |
 |details<sup>*required</sup>|[ErrorResponseDetails](#errorresponsedetails)| |
 |message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|A short, clear error message without details |
@@ -827,10 +833,11 @@ The response for error state
 
 
 
+
 Detailed information about the error.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |arguments<sup>*required</sup>|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The arguments for the message format. |
 |errorMessage<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Complete error message. |
 |errorMessageFormat<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the error message, string.format based. |
@@ -847,12 +854,13 @@ Detailed information about the error.
 
 
 
-| Name | Type| Description|
-|---|---|---|
+
+| Name | Type | Description |
+| --- | --- | --- |
 |defaultSamplingRatio|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|In case not specified in the DQL string, the sampling ratio defined here is applied. Note that this is only applicable to log queries. |
 |defaultScanLimitGbytes|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Limit in gigabytes for the amount data that will be scanned during read. |
-|defaultTimeframeEnd|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timeframe 'end' timestamp in ISO-8601 or RFC399 format. If the timeframe 'start' 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> |
-|defaultTimeframeStart|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timeframe 'start' timestamp in ISO-8601 or RFC399 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> |
+|defaultTimeframeEnd|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timeframe 'end' timestamp in ISO-8601 or RFC3339 format. If the timeframe 'start' 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> |
+|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> |
 |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. |
 |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. |
 |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'. |
@@ -867,10 +875,11 @@ Detailed information about the error.
 
 
 
+
 The possible type of a field in DQL.
 
-| Name | Type|
-|---|---|
+| Name | Type |
+| --- | --- |
 |type<sup>*required</sup>|FieldTypeType| 
 |types|Array&lt;[RangedFieldTypes](#rangedfieldtypes)&gt;|
 
@@ -878,10 +887,11 @@ The possible type of a field in DQL.
 
 
 
+
 DQL data type representing a geolocation point.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |latitude<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The coordinate that specifies the north-south position of a point on the surface of the earth. |
 |longitude<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The coordinate that specifies the  east-west position of a point on the surface of the earth. |
 
@@ -889,10 +899,11 @@ DQL data type representing a geolocation point.
 
 
 
+
 Collects various bits of metadata information.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |analysisTimeframe|[Timeframe](#timeframe)| |
 |canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The canonical form of the query. It has normalized spaces and canonical constructs. |
 |dqlVersion|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The version of DQL that was used to process the query request. |
@@ -911,10 +922,11 @@ Collects various bits of metadata information.
 
 
 
+
 Collects various bits of metadata information.
 
-| Name | Type|
-|---|---|
+| Name | Type |
+| --- | --- |
 |grail|[GrailMetadata](#grailmetadata)| 
 |metrics|Array&lt;[MetricMetadata](#metricmetadata)&gt;|
 
@@ -922,10 +934,11 @@ Collects various bits of metadata information.
 
 
 
+
 The message that provides additional information about the execution of the query.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |arguments|Array&lt;[string](https://developer.mozilla.org/en-US/docs/Glossary/String)&gt;|The arguments for the message format. |
 |message|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The complete message of the notification. |
 |messageFormat|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the notification, string.format based |
@@ -938,10 +951,11 @@ The message that provides additional information about the execution of the quer
 
 
 
+
 An object that defines additional metric metadata.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |description|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The description of the metadata. |
 |displayName|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The display name of the metadata. |
 |fieldName|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The name of the associated field used in the query. |
@@ -957,8 +971,9 @@ An object that defines additional metric metadata.
 
 
 
-| Name | Type| Description|
-|---|---|---|
+
+| Name | Type | Description |
+| --- | --- | --- |
 |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'. |
 |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
 |queryOptions|[QueryOptions](#queryoptions)| |
@@ -968,15 +983,17 @@ An object that defines additional metric metadata.
 
 
 
+
 The exact position in the query string.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |column<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Query position column zero based index. |
 |index<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Query position index. |
 |line<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Query position line zero based index. |
 
 ### QueryOptions
+**type**: Record&lt;string, string | undefined&gt;
 
 
 
@@ -986,10 +1003,11 @@ Query options.
 
 
 
+
 The response of GET query:execute call.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
 |result|[QueryResult](#queryresult)| |
 |state<sup>*required</sup>|QueryState| |
@@ -999,10 +1017,11 @@ The response of GET query:execute call.
 
 
 
+
 The result of the DQL query.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |metadata<sup>*required</sup>|[Metadata](#metadata)| |
 |records<sup>*required</sup>|Array&lt;null &#124; [ResultRecord](#resultrecord)&gt;|List of records containing the result fields data. |
 |types<sup>*required</sup>|Array&lt;[RangedFieldTypes](#rangedfieldtypes)&gt;|The data types for the result records. |
@@ -1011,10 +1030,11 @@ The result of the DQL query.
 
 
 
+
 The response when starting a query.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
 |requestToken|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The token returned by the POST query:execute call. |
 |result|[QueryResult](#queryresult)| |
@@ -1025,20 +1045,23 @@ The response when starting a query.
 
 
 
+
 The field type in range.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |indexRange|Array&lt;[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)&gt;|The range of elements at use this type in arrays (null for records). |
 |mappings<sup>*required</sup>|[RangedFieldTypesMappings](#rangedfieldtypesmappings)| |
 
 ### RangedFieldTypesMappings
+**type**: Record&lt;string, FieldType | undefined&gt;
 
 
 
 The mapping between the field name and data type.
 
 ### ResultRecord
+**type**: Record&lt;string, ResultRecordValue | null | undefined&gt;
 
 
 
@@ -1048,10 +1071,11 @@ Single record that contains the result fields.
 
 
 
+
 DQL data type timeframe.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
 |end|Date|The end time of the timeframe. |
 |start|Date|The start time of the timeframe. |
 
@@ -1059,10 +1083,11 @@ DQL data type timeframe.
 
 
 
+
 The position of a token in a query string used for errors and notification to map the message to a specific part of the query.
 
-| Name | Type|
-|---|---|
+| Name | Type |
+| --- | --- |
 |end<sup>*required</sup>|[PositionInfo](#positioninfo)| 
 |start<sup>*required</sup>|[PositionInfo](#positioninfo)|
 
@@ -1072,8 +1097,10 @@ The position of a token in a query string used for errors and notification to ma
 
 
 
-| Name | Type| Description|
-|---|---|---|
+
+| Name | Type | Description |
+| --- | --- | --- |
+|generateCanonicalQuery|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)| <i>default:</i> <code>false</code>|
 |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'. |
 |query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
 |queryOptions|[QueryOptions](#queryoptions)| |
@@ -1083,10 +1110,12 @@ The position of a token in a query string used for errors and notification to ma
 
 
 
+
 Verify response.
 
-| Name | Type| Description|
-|---|---|---|
+| Name | Type | Description |
+| --- | --- | --- |
+|canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
 |notifications|Array&lt;[MetadataNotification](#metadatanotification)&gt;|The notifications related to the supplied DQL query string. |
 |valid<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the supplied DQL query string is valid. |