Smaws_Client_TimestreamQuery.QueryQuery is a synchronous operation that enables you to run a query against your Amazon Timestream data.
If you enabled QueryInsights, this API also returns insights and metrics related to the query that you executed. QueryInsights helps with performance tuning of your query. For more information about QueryInsights, see Using query insights to optimize queries in Amazon Timestream.
The maximum number of Query API requests you're allowed to make with QueryInsights enabled is 1 query per second (QPS). If you exceed this query rate, it might result in throttling.
Query will time out after 60 seconds. You must update the default timeout in the SDK to support a timeout of 60 seconds. See the code sample for details.
Your query request will fail in the following cases:
Query request with the same client token outside of the 5-minute idempotency window.Query request with the same client token, but change other parameters, within the 5-minute idempotency window.If the size of the row (including the query metadata) exceeds 1 MB, then the query will fail with the following error message:
Query aborted as max page response size has been exceeded by the output result row
Invalid pagination token error.val error_to_string :
[ Smaws_Lib.Protocols.AwsJson.error
| `AccessDeniedException of Types.access_denied_exception
| `ConflictException of Types.conflict_exception
| `InternalServerException of Types.internal_server_exception
| `InvalidEndpointException of Types.invalid_endpoint_exception
| `QueryExecutionException of Types.query_execution_exception
| `ThrottlingException of Types.throttling_exception
| `ValidationException of Types.validation_exception ] ->
stringval request :
'http_type Smaws_Lib.Context.t ->
Types.query_request ->
(Types.query_response,
[> Smaws_Lib.Protocols.AwsJson.error
| `AccessDeniedException of Types.access_denied_exception
| `ConflictException of Types.conflict_exception
| `InternalServerException of Types.internal_server_exception
| `InvalidEndpointException of Types.invalid_endpoint_exception
| `QueryExecutionException of Types.query_execution_exception
| `ThrottlingException of Types.throttling_exception
| `ValidationException of Types.validation_exception ])
Stdlib.resultval request_with_metadata :
'http_type Smaws_Lib.Context.t ->
Types.query_request ->
(Types.query_response Smaws_Lib.Response.t,
[> Smaws_Lib.Protocols.AwsJson.error
| `AccessDeniedException of Types.access_denied_exception
| `ConflictException of Types.conflict_exception
| `InternalServerException of Types.internal_server_exception
| `InvalidEndpointException of Types.invalid_endpoint_exception
| `QueryExecutionException of Types.query_execution_exception
| `ThrottlingException of Types.throttling_exception
| `ValidationException of Types.validation_exception ]
* Smaws_Lib.Response.metadata)
Stdlib.result