PrepareQuery - Amazon Timestream
请求语法请求参数响应语法响应元素错误另请参阅

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击此处了解更多信息。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

PrepareQuery

一种同步操作，允许您提交带参数的查询，这些参数将由 Timestream 存储以便后续运行。Timestream 仅支持当 ValidateOnly 设置为 true 时使用此操作。

请求语法

{
   "QueryString": "string",
   "ValidateOnly": boolean
}

请求参数

有关所有操作的通用参数的信息，请参阅常用参数。

请求接受采用 JSON 格式的以下数据。

QueryString

希望用作准备语句的 Timestream 查询字符串。参数名称可以采用查询字符串 @ 字符后跟标识符的形式指定。

类型：字符串

长度限制：长度下限为 1。长度上限为 262144。

必需：是

ValidateOnly

通过将此值设置为 true，Timestream 将仅验证查询字符串是否为有效的 Timestream 查询，而不会存储准备查询以供日后使用。

类型：布尔值

必需：否

响应语法

{
   "Columns": [ 
      { 
         "Aliased": boolean,
         "DatabaseName": "string",
         "Name": "string",
         "TableName": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "Parameters": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "QueryString": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

Columns

已提交查询字符串的 SELECT 子句列的列表。

类型：SelectColumn 对象数组

Parameters

已提交查询字符串中使用的参数列表。

类型：ParameterMapping 对象数组

QueryString

希望准备的查询字符串。

类型：字符串

长度限制：长度下限为 1。长度上限为 262144。

错误

有关所有操作的常见错误的信息，请参阅常见错误。

AccessDeniedException

您没有访问账户设置所需的权限。

HTTP 状态代码：400

InternalServerException

处理请求时发生的内部服务器错误。

HTTP 状态代码：400

InvalidEndpointException

请求的端点无效。

HTTP 状态代码：400

ThrottlingException

该请求因请求过多而受到限制。

HTTP 状态代码：400

ValidationException

请求无效或格式错误。

HTTP 状态代码：400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：