本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
PrepareQuery
同步操作，可讓您提交查詢，其中包含由 Timestream 存放以供稍後執行的參數。Timestream 僅支援將 ValidateOnly 設定為 的此操作true。
請求語法
{
"QueryString": "string",
"ValidateOnly": boolean
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受 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 中使用此 AWS SDKs 的詳細資訊，請參閱下列內容：
