从2025年6月20日起，亚马逊Timestream版 LiveAnalytics 将不再向新客户开放。如果您想使用亚马逊 Timestream LiveAnalytics，请在该日期之前注册。现有客户可以继续照常使用该服务。有关更多信息，请参阅 Amazon Timestream 以了解 LiveAnalytics 可用性变更。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：