如需與 Amazon Timestream for LiveAnalytics 類似的功能，請考慮使用 Amazon Timestream for InfluxDB。它提供簡化的資料擷取和單一位數毫秒查詢回應時間，以進行即時分析。[在這裡](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)進一步了解。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # API 參考本節包含 Amazon Timestream 的 API 參考文件。 Timestream APIs：查詢和寫入。 + **寫入 API** 可讓您執行操作，例如建立資料表、標記資源，以及將記錄寫入 Timestream。 + **查詢 API** 可讓您執行查詢操作。 **注意** 這兩個 APIs都包含 DescribeEndpoints 動作。*對於查詢和寫入，DescribeEndpoints 動作相同。* 您可以閱讀以下每個 API 的詳細資訊，以及資料類型、常見錯誤和參數。 **注意** 如需所有 AWS 服務常見的錯誤代碼，請參閱[AWS 支援一節](https://docs.aws.amazon.com/awssupport/latest/APIReference/CommonErrors.html)。 **Topics** + [ # 動作 ](API_Operations.md) + [ # 資料類型 ](API_Types.md) + [ # 常見錯誤 ](CommonErrors.md) + [ # 常見參數 ](CommonParameters.md) # 動作 Amazon Timestream Write 支援下列動作： + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) Amazon Timestream Query 支援下列動作： + [CancelQuery](API_query_CancelQuery.md) + [CreateScheduledQuery](API_query_CreateScheduledQuery.md) + [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) + [DescribeAccountSettings](API_query_DescribeAccountSettings.md) + [DescribeEndpoints](API_query_DescribeEndpoints.md) + [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) + [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) + [ListScheduledQueries](API_query_ListScheduledQueries.md) + [ListTagsForResource](API_query_ListTagsForResource.md) + [PrepareQuery](API_query_PrepareQuery.md) + [Query](API_query_Query.md) + [TagResource](API_query_TagResource.md) + [UntagResource](API_query_UntagResource.md) + [UpdateAccountSettings](API_query_UpdateAccountSettings.md) + [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) # Amazon Timestream 寫入 Amazon Timestream Write 支援下列動作： + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) # CreateBatchLoadTask 建立新的 Timestream 批次載入任務。批次載入任務會處理 S3 位置中 CSV 來源的資料，並寫入 Timestream 資料表。在批次載入任務中定義從來源到目標的映射。錯誤和事件會寫入 S3 位置的報告。對於報告，如果未指定 AWS KMS 金鑰，則當 `SSE_S3`是選項時，報告將使用 S3 受管金鑰加密。否則會擲回錯誤。如需詳細資訊，請參閱 [AWS 受管金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。如需詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html)。 ## 請求語法 ``` { "ClientToken": "string", "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "TargetDatabaseName": "string", "TargetTableName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** 類型：字串長度限制：長度下限為 1。長度上限為 64。必要：否 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 類型：[DataModelConfiguration](API_DataModelConfiguration.md) 物件必要：否 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 定義批次載入任務之資料來源的組態詳細資訊。類型：[DataSourceConfiguration](API_DataSourceConfiguration.md) 物件必要：是 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** 類型：Long 必要：否 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的報告組態。這包含錯誤報告存放位置的詳細資訊。類型：[ReportConfiguration](API_ReportConfiguration.md) 物件必要：是 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的目標 Timestream 資料庫。類型：字串模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的目標 Timestream 資料表。類型：字串模式：`[a-zA-Z0-9_.-]+` 必要：是 ## 回應語法 ``` { "TaskId": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** 批次載入任務的 ID。類型：字串長度限制：長度下限為 3。長度上限為 32。模式：`[A-Z0-9]+` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** ConflictException ** Timestream 無法處理此請求，因為它包含已存在的資源。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) # CreateDatabase 建立新的 Timestream 資料庫。如果未指定 AWS KMS 金鑰，則會使用您帳戶中的 Timestream 受管 AWS KMS 金鑰來加密資料庫。如需詳細資訊，請參閱 [AWS 受管金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。如需詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html)。 ## 請求語法 ``` { "DatabaseName": "string", "KmsKeyId": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_CreateDatabase_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) ** 資料庫的 AWS KMS 金鑰。如果未指定 AWS KMS 金鑰，則會使用您帳戶中的 Timestream 受管 AWS KMS 金鑰來加密資料庫。如需詳細資訊，請參閱 [AWS 受管金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** [Tags](#API_CreateDatabase_RequestSyntax) ** 標記資料表的鍵值對清單。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Database](#API_CreateDatabase_ResponseSyntax) ** 新建立的 Timestream 資料庫。類型：[Database](API_Database.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** ConflictException ** Timestream 無法處理此請求，因為它包含已存在的資源。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) # CreateTable 將新資料表新增至您帳戶中的現有資料庫。在中 AWS 帳戶，如果資料表名稱位於相同的資料庫中，則每個區域中的資料表名稱必須至少是唯一的。如果資料表位於不同的資料庫中，您可能在同一區域中有相同的資料表名稱。建立資料表時，您必須指定資料表名稱、資料庫名稱，以及保留屬性。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_CreateTable_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) ** 包含啟用磁性存放區寫入時要在表格上設定的屬性。類型：[MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 物件必要：否 ** [RetentionProperties](#API_CreateTable_RequestSyntax) ** 您的時間序列資料必須存放在記憶體存放區和磁性存放區的持續時間。類型：[RetentionProperties](API_RetentionProperties.md) 物件必要：否 ** [Schema](#API_CreateTable_RequestSyntax) ** 資料表的結構描述。類型：[Schema](API_Schema.md) 物件必要：否 ** [TableName](#API_CreateTable_RequestSyntax) ** Timestream 資料表的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [Tags](#API_CreateTable_RequestSyntax) ** 標記資料表的鍵值對清單。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Table](#API_CreateTable_ResponseSyntax) ** 新建立的 Timestream 資料表。類型：[Table](API_Table.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** ConflictException ** Timestream 無法處理此請求，因為它包含已存在的資源。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable) # DeleteDatabase 刪除指定的 Timestream 資料庫。*這是不可復原的操作。刪除資料庫後，無法復原資料表中的時間序列資料。* **注意** 必須先刪除資料庫中的所有資料表，否則會擲回 ValidationException 錯誤。由於分散式重試的性質，操作可能會傳回成功或 ResourceNotFoundException。用戶端應該將其視為同等項目。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html)。 ## 請求語法 ``` { "DatabaseName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) ** 要刪除的 Timestream 資料庫名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) # DeleteTable 刪除指定的 Timestream 資料表。這是不可復原的操作。刪除 Timestream 資料庫資料表後，無法復原存放在資料表中的時間序列資料。 **注意** 由於分散式重試的性質，操作可能會傳回成功或 ResourceNotFoundException。用戶端應該將其視為同等項目。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DeleteTable_RequestSyntax) ** 要刪除 Timestream 資料庫的資料庫名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ** [TableName](#API_DeleteTable_RequestSyntax) ** 要刪除的 Timestream 資料表名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) # DescribeBatchLoadTask 傳回批次載入任務的相關資訊，包括組態、映射、進度和其他詳細資訊。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html)。 ## 請求語法 ``` { "TaskId": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) ** 批次載入任務的 ID。類型：字串長度限制：長度下限為 3。長度上限為 32。模式：`[A-Z0-9]+` 必要：是 ## 回應語法 ``` { "BatchLoadTaskDescription": { "CreationTime": number, "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "ErrorMessage": "string", "LastUpdatedTime": number, "ProgressReport": { "BytesMetered": number, "FileFailures": number, "ParseFailures": number, "RecordIngestionFailures": number, "RecordsIngested": number, "RecordsProcessed": number }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "ResumableUntil": number, "TargetDatabaseName": "string", "TargetTableName": "string", "TaskId": "string", "TaskStatus": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) ** 批次載入任務的描述。類型：[BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) # DescribeDatabase 傳回資料庫的相關資訊，包括資料庫名稱、建立資料庫的時間，以及在資料庫中找到的資料表總數。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html)。 ## 請求語法 ``` { "DatabaseName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ## 回應語法 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Database](#API_DescribeDatabase_ResponseSyntax) ** Timestream 資料表的名稱。類型：[Database](API_Database.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) # DescribeEndpoints 傳回可用端點的清單，以進行 Timestream API 呼叫。此 API 操作可透過寫入和查詢 APIs使用。由於 Timestream SDKs旨在透明地使用服務的架構，包括服務端點的管理和映射，*因此我們不建議您使用此 API 操作，除非*： + 您使用 [VPC 端點 (AWS PrivateLink) 搭配 Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) + 您的應用程式使用尚未支援 SDK 的程式設計語言 + 您需要更好地控制用戶端實作如需如何使用和何時實作 DescribeEndpoints 的詳細資訊，請參閱[端點探索模式](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery)。 ## 回應語法 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) ** 發出`DescribeEndpoints`請求時，會傳回`Endpoints`物件。類型：[Endpoint](API_Endpoint.md) 物件陣列 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) # DescribeTable 傳回資料表的相關資訊，包括資料表名稱、資料庫名稱、記憶體存放區和磁性存放區的保留期間。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DescribeTable_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ** [TableName](#API_DescribeTable_RequestSyntax) ** Timestream 資料表的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ## 回應語法 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Table](#API_DescribeTable_ResponseSyntax) ** Timestream 資料表。類型：[Table](API_Table.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) # ListBatchLoadTasks 提供批次載入任務的清單，以及任務在之前可繼續執行的名稱、狀態和其他詳細資訊。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html)。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string", "TaskStatus": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) ** 要在輸出中傳回的項目總數。如果可用的項目總數超過指定的值，則會在輸出中提供 NextToken。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) ** 用以指定分頁開始位置的字符。這是來自先前已截斷回應的 NextToken。類型：字串必要：否 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) ** 批次載入任務的狀態。類型：字串有效值:`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必要：否 ## 回應語法 ``` { "BatchLoadTasks": [ { "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "ResumableUntil": number, "TableName": "string", "TaskId": "string", "TaskStatus": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) ** 批次載入任務詳細資訊的清單。類型：[BatchLoadTask](API_BatchLoadTask.md) 物件陣列 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) ** 用以指定分頁開始位置的字符。提供下一個 ListBatchLoadTasksRequest。類型：字串 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) # ListDatabases 傳回 Timestream 資料庫的清單。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html)。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_ListDatabases_RequestSyntax) ** 要在輸出中傳回的項目總數。如果可用的項目總數超過指定的值，則會在輸出中提供 NextToken。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。類型：整數有效範圍：最小值為 1。最大值為 20。必要：否 ** [NextToken](#API_ListDatabases_RequestSyntax) ** 分頁字符。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。類型：字串必要：否 ## 回應語法 ``` { "Databases": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Databases](#API_ListDatabases_ResponseSyntax) ** 資料庫名稱清單。類型：[Database](API_Database.md) 物件陣列 ** [NextToken](#API_ListDatabases_ResponseSyntax) ** 分頁字符。當回應被截斷時，會傳回此參數。類型：字串 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) # ListTables 提供資料表清單，以及每個資料表的名稱、狀態和保留屬性。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "MaxResults": number, "NextToken": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_ListTables_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：否 ** [MaxResults](#API_ListTables_RequestSyntax) ** 要在輸出中傳回的項目總數。如果可用的項目總數超過指定的值，則會在輸出中提供 NextToken。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。類型：整數有效範圍：最小值為 1。最大值為 20。必要：否 ** [NextToken](#API_ListTables_RequestSyntax) ** 分頁字符。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。類型：字串必要：否 ## 回應語法 ``` { "NextToken": "string", "Tables": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListTables_ResponseSyntax) ** 用以指定分頁開始位置的字符。這是來自先前已截斷回應的 NextToken。類型：字串 ** [Tables](#API_ListTables_ResponseSyntax) ** 資料表清單。類型：[Table](API_Table.md) 物件陣列 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTables) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) # ListTagsForResource 列出 Timestream 資源上的所有標籤。 ## 請求語法 ``` { "ResourceARN": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 要列出標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 1011。必要：是 ## 回應語法 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 目前與 Timestream 資源相關聯的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) # ResumeBatchLoadTask ## 請求語法 ``` { "TaskId": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) ** 要繼續的批次載入任務 ID。類型：字串長度限制：長度下限為 3。長度上限為 32。模式：`[A-Z0-9]+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) # TagResource 將一組標籤與 Timestream 資源建立關聯。然後，您可以啟用這些使用者定義的標籤，使其顯示在 Billing and Cost Management 主控台上，以進行成本分配追蹤。 ## 請求語法 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_TagResource_RequestSyntax) ** 識別應新增標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 1011。必要：是 ** [Tags](#API_TagResource_RequestSyntax) ** 要指派給 Timestream 資源的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/TagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) # UntagResource 從 Timestream 資源移除標籤的關聯。 ## 請求語法 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_UntagResource_RequestSyntax) ** 要從中移除標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 1011。必要：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 標籤索引鍵的清單。資源的現有標籤，其金鑰是此清單的成員，將會從 Timestream 資源中移除。類型：字串陣列陣列成員：項目數下限為 0。項目數上限為 200。長度限制：長度下限為 1。長度上限為 128。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) # UpdateDatabase 修改現有資料庫的 AWS KMS 金鑰。更新資料庫時，您必須指定要使用的新 AWS KMS 金鑰的資料庫名稱和識別符 (`KmsKeyId`)。如果有任何並行`UpdateDatabase`請求，第一個寫入器會獲勝。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html)。 ## 請求語法 ``` { "DatabaseName": "string", "KmsKeyId": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) ** 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) ** 用來加密資料庫中存放資料之新 AWS KMS 金鑰 (`KmsKeyId`) 的識別符。如果`KmsKeyId`目前向資料庫註冊的與請求`KmsKeyId`中的相同，則不會有任何更新。您可以使用下列`KmsKeyId`任一項來指定： + 金鑰 ID：`1234abcd-12ab-34cd-56ef-1234567890ab` + 金鑰 ARN：`arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` + 別名名稱：`alias/ExampleAlias` + 別名 ARN：`arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應語法 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Database](#API_UpdateDatabase_ResponseSyntax) ** 資料表的最上層容器。資料庫和資料表是 Amazon Timestream 中的基本管理概念。資料庫中的所有資料表都會使用相同的 AWS KMS 金鑰加密。類型：[Database](API_Database.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) # UpdateTable 修改 Timestream 資料表的記憶體存放區和磁性存放區的保留期間。請注意，保留期間的變更會立即生效。例如，如果記憶體存放區的保留期間最初設定為 2 小時，然後變更為 24 小時，則記憶體存放區將能夠保留 24 小時的資料，但在進行此變更的 22 小時後將填入 24 小時的資料。Timestream 不會從磁性存放區擷取資料來填入記憶體存放區。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_UpdateTable_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) ** 包含啟用磁性存放區寫入時要在表格上設定的屬性。類型：[MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 物件必要：否 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) ** 記憶體存放區和磁性存放區的保留期間。類型：[RetentionProperties](API_RetentionProperties.md) 物件必要：否 ** [Schema](#API_UpdateTable_RequestSyntax) ** 資料表的結構描述。類型：[Schema](API_Schema.md) 物件必要：否 ** [TableName](#API_UpdateTable_RequestSyntax) ** Timestream 資料表的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ## 回應語法 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Table](#API_UpdateTable_ResponseSyntax) ** 更新的 Timestream 資料表。類型：[Table](API_Table.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) # WriteRecords 可讓您將時間序列資料寫入 Timestream。您可以指定要插入系統的單一資料點或一批資料點。Timestream 為您提供彈性的結構描述，可根據您叫用寫入資料庫時指定的資料點維度名稱和資料類型，自動偵測 Timestream 資料表的資料欄名稱和資料類型。 Timestream 支援最終一致性讀取語意。這表示當您在將一批資料寫入 Timestream 後立即查詢資料時，查詢結果可能不會反映最近完成的寫入操作的結果。結果也可能包含一些過時的資料。如果您在短時間內重複查詢請求，結果應該會傳回最新的資料。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html)。 **Upserts** 您可以在`WriteRecords`請求中使用 `Version` 參數來更新資料點。Timestream 會追蹤每個記錄的版本編號。當未在請求中為記錄指定`1`時， `Version`預設為。Timestream 會在收到寫入請求`Version`時，更新現有記錄的度量值及其，該記錄的寫入請求具有較高的`Version`數字。當它收到更新請求，其中度量值與現有記錄的值相同時，如果 Timestream 大於的現有值`Version`，則仍然會更新 `Version`。只要的值`Version`持續增加，您就可以視需要多次更新資料點。例如，假設您在請求`Version`中沒有指示的情況下撰寫新記錄。Timestream 會儲存此記錄，並將 `Version`設定為 `1`。現在，假設您嘗試使用具有不同度量值的相同記錄`WriteRecords`請求來更新此記錄，但和之前一樣，不提供 `Version`。在此情況下，Timestream 會使用拒絕此更新，`RejectedRecordsException`因為更新記錄的版本不大於版本的現有值。不過，如果您要重新傳送 `Version` 設定為的更新請求`2`，則 Timestream 會成功更新記錄的值，而 `Version`會設定為 `2`。接著，假設您已傳送具有相同記錄和相同度量值的`WriteRecords`請求，但將 `Version` 設定為 `3`。在此情況下，Timestream 只會更新`Version`為 `3`。任何進一步的更新都需要傳送大於的版本編號`3`，否則更新請求會收到 `RejectedRecordsException`。 ## 請求語法 ``` { "CommonAttributes": { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number }, "DatabaseName": "string", "Records": [ { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number } ], "TableName": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) ** 包含請求中所有記錄之間共用的常見度量、維度、時間和版本屬性的記錄。將資料寫入 Timestream 時，指定的量值和維度屬性將與記錄物件中的量值和維度屬性合併。維度可能不會重疊，或者`ValidationException`會擲回。換句話說，記錄必須包含具有唯一名稱的維度。類型：[Record](API_Record.md) 物件必要：否 ** [DatabaseName](#API_WriteRecords_RequestSyntax) ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ** [Records](#API_WriteRecords_RequestSyntax) ** 記錄陣列，其中包含每個時間序列資料點的唯一度量、維度、時間和版本屬性。類型：[Record](API_Record.md) 物件陣列陣列成員：項目數下限為 1。項目數上限為 100。必要：是 ** [TableName](#API_WriteRecords_RequestSyntax) ** Timestream 資料表的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：是 ## 回應語法 ``` { "RecordsIngested": { "MagneticStore": number, "MemoryStore": number, "Total": number } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) ** 此請求所擷取之記錄的相關資訊。類型：[RecordsIngested](API_RecordsIngested.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** RejectedRecordsException ** WriteRecords 會在下列情況下擲回此例外狀況： + 具有重複資料的記錄，其中有多個記錄具有相同的維度、時間戳記和度量名稱，但： + 測量值不同 + 版本不存在於請求中，*或*新記錄中的版本值等於或低於現有值在此情況下，如果 Timestream 拒絕資料，`RejectedRecords`回應中的 `ExistingVersion` 欄位會指出目前記錄的版本。若要強制更新，您可以將記錄集的版本重新傳送請求至大於的值`ExistingVersion`。 + 時間戳記超過記憶體存放區保留期間的記錄。 + 維度或量值超過 Timestream 定義限制的記錄。如需詳細資訊，請參閱《Amazon Timestream 開發人員指南[》中的配額](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。 ** RejectedRecords ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords) # Amazon Timestream 查詢 Amazon Timestream Query 支援下列動作： + [CancelQuery](API_query_CancelQuery.md) + [CreateScheduledQuery](API_query_CreateScheduledQuery.md) + [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) + [DescribeAccountSettings](API_query_DescribeAccountSettings.md) + [DescribeEndpoints](API_query_DescribeEndpoints.md) + [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) + [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) + [ListScheduledQueries](API_query_ListScheduledQueries.md) + [ListTagsForResource](API_query_ListTagsForResource.md) + [PrepareQuery](API_query_PrepareQuery.md) + [Query](API_query_Query.md) + [TagResource](API_query_TagResource.md) + [UntagResource](API_query_UntagResource.md) + [UpdateAccountSettings](API_query_UpdateAccountSettings.md) + [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) # CancelQuery 取消已發出的查詢。只有在發出取消請求之前，查詢尚未完成執行時，才會提供取消。由於取消是等冪操作，因此後續的取消請求會傳回 `CancellationMessage`，表示查詢已取消。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html)。 ## 請求語法 ``` { "QueryId": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [QueryId](#API_query_CancelQuery_RequestSyntax) ** 需要取消的查詢 ID。 `QueryID` 會傳回為查詢結果的一部分。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9]+` 必要：是 ## 回應語法 ``` { "CancellationMessage": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) ** 當指定的查詢`CancelQuery`請求`QueryId`已發出時，`CancellationMessage`會傳回。類型：字串 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery) # CreateScheduledQuery 建立將按照設定的排程代表您執行的排程查詢。Timestream 假定提供的執行角色作為用於執行查詢的部分 `ScheduledQueryExecutionRoleArn` 參數。您可以使用 `NotificationConfiguration` 參數為排程查詢操作設定通知。 ## 請求語法 ``` { "ClientToken": "string", "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "KmsKeyId": "string", "Name": "string", "NotificationConfiguration": { "SnsConfiguration": { "TopicArn": "string" } }, "QueryString": "string", "ScheduleConfiguration": { "ScheduleExpression": "string" }, "ScheduledQueryExecutionRoleArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TargetConfiguration": { "TimestreamConfiguration": { "DatabaseName": "string", "DimensionMappings": [ { "DimensionValueType": "string", "Name": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TableName": "string", "TimeColumn": "string" } } } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** 使用 ClientToken 呼叫 CreateScheduledQuery 等冪，換句話說，重複提出相同的請求將產生相同的結果。提出多個相同的 CreateScheduledQuery 請求與提出單一請求具有相同的效果。 + 如果在沒有 `ClientToken` 的情況下呼叫 CreateScheduledQuery，則查詢 SDK 會代表您產生 `ClientToken`。 + 8 小時後，任何具有相同 `ClientToken` 的請求會視為新的請求。類型：字串長度限制：長度下限為 32。長度上限為 128。必要：否 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 錯誤報告的組態。寫入查詢結果時遇到問題時，會產生錯誤報告。類型：[ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 物件必要：是 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) ** 用於靜態加密排程查詢資源的 Amazon KMS 金鑰。如果未指定 Amazon KMS 金鑰，則會使用 Timestream 擁有的 Amazon KMS 金鑰來加密排程查詢資源。若要指定 KMS 金鑰，請使用金鑰 ID、金鑰 ARN、別名名稱或別名 ARN。使用別名時，請在名稱加上 *alias/* 字首。如果 ErrorReportConfiguration 使用 `SSE_KMS` 作為加密類型，則使用相同的 KmsKeyId 來靜態加密錯誤報告。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) ** 排程查詢的名稱。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：是 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 排程查詢的通知組態。Timestream 會在查詢執行完成時、狀態更新或刪除查詢時傳送通知。類型：[NotificationConfiguration](API_query_NotificationConfiguration.md) 物件必要：是 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) ** 要執行的查詢字串。參數名稱可以在後跟一個識別碼的查詢字串 `@` 字元中指定。命名參數 `@scheduled_runtime` 是保留的，並且可以在查詢中使用，以取得排程執行查詢的時間。根據 ScheduleConfiguration 參數計算的時間戳記將是每次查詢執行的 `@scheduled_runtime` 參數值。例如，假設某個排程查詢執行個體是在 2021-12-01 00:00:00 執行。在此執行個體中，在叫用查詢時，`@scheduled_runtime` 參數會初始化為時間戳記 2021-12-01 00:00:00。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 查詢的排程組態。類型：[ScheduleConfiguration](API_query_ScheduleConfiguration.md) 物件必要：是 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) ** 執行排程查詢時，Timestream 將擔任之 IAM 角色的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) ** 用來標示排程查詢的鍵/值對清單。類型：[Tag](API_query_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 用於寫入查詢結果的組態。類型：[TargetConfiguration](API_query_TargetConfiguration.md) 物件必要：否 ## 回應語法 ``` { "Arn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) ** 已建立排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** ConflictException ** 無法輪詢已取消查詢的結果。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 您已超過服務配額。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery) # DeleteScheduledQuery 刪除指定的排程查詢。這是不可復原的操作。 ## 請求語法 ``` { "ScheduledQueryArn": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) # DescribeAccountSettings 描述您帳戶的設定，其中包含查詢定價模型，以及服務可用於查詢工作負載的已設定最大 TCUs。您只需支付工作負載所使用的運算單位持續時間的費用。 ## 回應語法 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "ActiveQueryTCU": number, "LastUpdate": { "Status": "string", "StatusMessage": "string", "TargetQueryTCU": number }, "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } } } }, "QueryPricingModel": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) ** 服務在任何時間點將用於服務查詢的 [Timestream 運算單位](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCUs) 數目上限。若要執行查詢，您必須將最小容量設定為 4 TCU。您可以在 4 的倍數中設定 TCU 數量上限，例如 4、8、16、32 等。此組態僅適用於 (TCUs的隨需用量。類型：整數 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) ** 包含查詢工作負載之帳戶中 Timestream Compute Units (TCUs) 用量設定的物件。QueryCompute 僅適用於亞太區域（孟買）區域。類型：[QueryComputeResponse](API_query_QueryComputeResponse.md) 物件 ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) ** 您帳戶中查詢的定價模型。 `QueryPricingModel` 參數由數個 Timestream 操作使用；不過，`UpdateAccountSettings`API 操作無法辨識以外的任何值`COMPUTE_UNITS`。類型：字串有效值:`BYTES_SCANNED | COMPUTE_UNITS` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) # DescribeEndpoints DescribeEndpoints 會傳回可用的端點清單，以進行 Timestream API 呼叫。此 API 可透過寫入和查詢取得。由於 Timestream SDKs旨在透明地使用服務的架構，包括服務端點的管理和映射，*因此不建議您使用此 API，除非*： + 您使用 [VPC 端點 (AWS PrivateLink) 搭配 Timestream ](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) + 您的應用程式使用尚未支援 SDK 的程式設計語言 + 您需要更好地控制用戶端實作如需如何使用和何時實作 DescribeEndpoints 的詳細資訊，請參閱[端點探索模式](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery)。 ## 回應語法 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) ** 發出`DescribeEndpoints`請求時，會傳回`Endpoints`物件。類型：[Endpoint](API_query_Endpoint.md) 物件陣列 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) # DescribeScheduledQuery 提供排程查詢的詳細資訊。 ## 請求語法 ``` { "ScheduledQueryArn": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應語法 ``` { "ScheduledQuery": { "Arn": "string", "CreationTime": number, "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "KmsKeyId": "string", "LastRunSummary": { "ErrorReportLocation": { "S3ReportLocation": { "BucketName": "string", "ObjectKey": "string" } }, "ExecutionStats": { "BytesMetered": number, "CumulativeBytesScanned": number, "DataWrites": number, "ExecutionTimeInMillis": number, "QueryResultRows": number, "RecordsIngested": number }, "FailureReason": "string", "InvocationTime": number, "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } } }, "RunStatus": "string", "TriggerTime": number }, "Name": "string", "NextInvocationTime": number, "NotificationConfiguration": { "SnsConfiguration": { "TopicArn": "string" } }, "PreviousInvocationTime": number, "QueryString": "string", "RecentlyFailedRuns": [ { "ErrorReportLocation": { "S3ReportLocation": { "BucketName": "string", "ObjectKey": "string" } }, "ExecutionStats": { "BytesMetered": number, "CumulativeBytesScanned": number, "DataWrites": number, "ExecutionTimeInMillis": number, "QueryResultRows": number, "RecordsIngested": number }, "FailureReason": "string", "InvocationTime": number, "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } } }, "RunStatus": "string", "TriggerTime": number } ], "ScheduleConfiguration": { "ScheduleExpression": "string" }, "ScheduledQueryExecutionRoleArn": "string", "State": "string", "TargetConfiguration": { "TimestreamConfiguration": { "DatabaseName": "string", "DimensionMappings": [ { "DimensionValueType": "string", "Name": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TableName": "string", "TimeColumn": "string" } } } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) ** 排程查詢。類型：[ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery) # ExecuteScheduledQuery 您可以使用此 API 手動執行排程查詢。如果您啟用 `QueryInsights`，此 API 也會傳回與您在 Amazon SNS 通知中執行之查詢相關的洞見和指標。 `QueryInsights` 可協助您調校查詢的效能。如需的詳細資訊`QueryInsights`，請參閱[使用查詢洞見來最佳化 Amazon Timestream 中的查詢](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)。 ## 請求語法 ``` { "ClientToken": "string", "InvocationTime": number, "QueryInsights": { "Mode": "string" }, "ScheduledQueryArn": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 未使用。類型：字串長度限制：長度下限為 32。長度上限為 128。必要：否 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) ** UTC 的時間戳記。查詢將如同在此時間戳記叫用一樣執行。類型：Timestamp 必要：是 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 封裝啟用的設定`QueryInsights`。啟用會`QueryInsights`傳回洞見和指標，做為您執行之查詢的 Amazon SNS 通知的一部分。您可以使用 `QueryInsights`來調整查詢效能和成本。類型：[ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) 物件必要：否 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 範例 ### ENABLED\$1WITH\$1RATE\$1CONTROL 模式的排程查詢通知訊息下列範例顯示 `QueryInsights` 參數`ENABLED_WITH_RATE_CONTROL`模式的成功排程查詢通知訊息。 ``` "SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:::scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723710546, "triggerTimeMillis": 1723710547490, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17343, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 }, "queryInsightsResponse": { "querySpatialCoverage": { "max": { "value": 1.0, "tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable", "partitionKey": [ "measure_name" ] } }, "queryTemporalRange": { "max": { "value": 2399999999999, "tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable" } }, "queryTableCount": 1, "outputRows": 1, "outputBytes": 59 } } } ``` ### DISABLED 模式的排程查詢通知訊息下列範例顯示 `QueryInsights` 參數`DISABLED`模式的成功排程查詢通知訊息。 ``` "SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:::scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723711401, "triggerTimeMillis": 1723711402144, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17992, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 } } } ``` ### ENABLED\$1WITH\$1RATE\$1CONTROL 模式的失敗通知訊息下列範例顯示 `QueryInsights` 參數`ENABLED_WITH_RATE_CONTROL`模式的失敗排程查詢通知訊息。 ``` "FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915513, "triggerTimeMillis": 1727915513894, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } } ``` ### DISABLED 模式的失敗通知訊息下列範例顯示 `QueryInsights` 參數`DISABLED`模式的失敗排程查詢通知訊息。 ``` "FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915194, "triggerTimeMillis": 1727915195119, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } } ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery) # ListScheduledQueries 取得發起人 Amazon 帳戶和區域中所有排程查詢的清單。 `ListScheduledQueries` 最終一致。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) ** 要在輸出中傳回的項目數量上限。如果可用的項目總數超過指定的值，`NextToken`則會在輸出中提供。若要繼續分頁，請提供 `NextToken`值做為後續呼叫的引數`ListScheduledQueriesRequest`。類型：整數有效範圍：最小值為 1。最大值為 1000。必要：否 ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) ** 用於恢復分頁的分頁字符。類型：字串必要：否 ## 回應語法 ``` { "NextToken": "string", "ScheduledQueries": [ { "Arn": "string", "CreationTime": number, "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "LastRunStatus": "string", "Name": "string", "NextInvocationTime": number, "PreviousInvocationTime": number, "State": "string", "TargetDestination": { "TimestreamDestination": { "DatabaseName": "string", "TableName": "string" } } } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) ** 用以指定分頁開始位置的字符。這是來自先前已截斷回應的 NextToken。類型：字串 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) ** 排程查詢的清單。類型：[ScheduledQuery](API_query_ScheduledQuery.md) 物件陣列 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) # ListTagsForResource 列出 Timestream 查詢資源上的所有標籤。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string", "ResourceARN": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) ** 要傳回的標籤數目上限。類型：整數有效範圍：最小值為 1。最大值為 200。必要：否 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) ** 用於恢復分頁的分頁字符。類型：字串必要：否 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) ** 要列出標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應語法 ``` { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) ** 用於後續呼叫來恢復分頁的分頁字符`ListTagsForResourceResponse`。類型：字串 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) ** 目前與 Timestream 資源相關聯的標籤。類型：[Tag](API_query_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) # PrepareQuery 同步操作，可讓您提交查詢，其中包含由 Timestream 存放以供稍後執行的參數。Timestream 僅支援將 `ValidateOnly` 設定為的此操作`true`。 ## 請求語法 ``` { "QueryString": "string", "ValidateOnly": boolean } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) ** 您想要用作預備陳述式的 Timestream 查詢字串。參數名稱可以在後跟一個識別碼的查詢字串 `@` 字元中指定。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) ** 透過將此值設定為 `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](#API_query_PrepareQuery_ResponseSyntax) ** 所提交查詢字串的 SELECT 子句資料欄清單。類型：[SelectColumn](API_query_SelectColumn.md) 物件陣列 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) ** 已提交查詢字串中使用的參數清單。類型：[ParameterMapping](API_query_ParameterMapping.md) 物件陣列 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) ** 您要準備的查詢字串。類型：字串長度限制：長度下限為 1。長度上限為 262144。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery) # Query `Query` 是一種同步操作，可讓您針對 Amazon Timestream 資料執行查詢。如果您啟用 `QueryInsights`，此 API 也會傳回與您執行之查詢相關的洞見和指標。 `QueryInsights` 可協助您調校查詢的效能。如需的詳細資訊`QueryInsights`，請參閱[使用查詢洞見來最佳化 Amazon Timestream 中的查詢](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)。 **注意** 在`QueryInsights`啟用的情況下，您允許的 `Query` API 請求數目上限為每秒 1 個查詢 (QPS)。如果您超過此查詢速率，可能會導致限流。 `Query` 會在 60 秒後逾時。您必須更新 SDK 中的預設逾時，以支援 60 秒的逾時。如需詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html)。在下列情況下，您的查詢請求將會失敗： + 如果您在 5 分鐘等冪時段之外使用相同的用戶端字符提交`Query`請求。 + 如果您使用相同的用戶端字符提交`Query`請求，但在 5 分鐘等冪時段內變更其他參數。 + 如果資料列的大小（包括查詢中繼資料）超過 1 MB，則查詢會失敗，並顯示下列錯誤訊息： `Query aborted as max page response size has been exceeded by the output result row` + 如果查詢啟動器和結果讀取器的 IAM 主體不同和/或查詢啟動器，且結果讀取器在查詢請求中沒有相同的查詢字串，則查詢會失敗並顯示`Invalid pagination token`錯誤。 ## 請求語法 ``` { "ClientToken": "string", "MaxRows": number, "NextToken": "string", "QueryInsights": { "Mode": "string" }, "QueryString": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_Query_RequestSyntax) ** 提出`Query`請求時，最多指定 64 個 ASCII 字元的唯一區分大小寫字串。提供 `ClientToken`會呼叫`Query`*等*冪。這表示重複執行相同的查詢會產生相同的結果。換句話說，提出多個相同的`Query`請求與提出單一請求的效果相同。在查詢`ClientToken`中使用時，請注意下列事項： + 如果在沒有的情況下執行個體化查詢 API`ClientToken`，則查詢 SDK `ClientToken`會代表您產生。 + 如果`Query`調用僅包含 `ClientToken`但不包含 `NextToken`，則的調用`Query`會假設為新的查詢執行。 + 如果調用包含 `NextToken`，則會假設該特定調用是先前呼叫查詢 API 的後續調用，並傳回結果集。 + 4 小時後，任何具有相同的請求`ClientToken`都會視為新的請求。類型：字串長度限制：長度下限為 32。長度上限為 128。必要：否 ** [MaxRows](#API_query_Query_RequestSyntax) ** 要在`Query`輸出中傳回的資料列總數。`Query` 具有指定`MaxRows`值的初始執行會在兩種情況下傳回查詢的結果集： + 結果的大小小於 `1MB`。 + 結果集中的資料列數小於的值`maxRows`。否則，的初始調用`Query`只會傳回 `NextToken`，然後可用於後續呼叫以擷取結果集。若要繼續分頁，請在後續命令中提供 `NextToken`值。如果資料列大小很大（例如資料列有許多資料欄），Timestream 可能會傳回較少的資料列，以避免回應大小超過 1 MB 的限制。如果`MaxRows`未提供，Timestream 會傳送必要的資料列數，以符合 1 MB 的限制。類型：整數有效範圍：最小值為 1。最大值為 1000。必要：否 ** [NextToken](#API_query_Query_RequestSyntax) ** 用於傳回一組結果的分頁字符。使用叫用 `Query` API 時`NextToken`，會假設該特定叫用是先前呼叫的後續叫用`Query`，並傳回結果集。不過，如果`Query`調用僅包含 `ClientToken`，則的調用`Query`會假設為新的查詢執行。在查詢中使用 NextToken 時，請注意下列事項： + 分頁字符最多可用於五個`Query`叫用，或長達 1 小時，以先發生者為準。 + 使用相同的 `NextToken`會傳回相同的記錄集。若要繼續分頁結果集，您必須使用最新的 `nextToken`。 + 假設`Query`調用會傳回兩個`NextToken`值 `TokenA`和 `TokenB`。如果 `TokenB` 在後續`Query`調用中使用，則 `TokenA` 會失效且無法重複使用。 + 若要在分頁開始後從查詢請求先前的結果集，您必須重新叫用查詢 API。 + `NextToken` 應該使用最新的進行分頁，直到傳回`null`為止，此時`NextToken`應使用新的。 + 如果查詢啟動器和結果讀取器的 IAM 主體不同和/或查詢啟動器，且結果讀取器在查詢請求中沒有相同的查詢字串，則查詢會失敗並顯示`Invalid pagination token`錯誤。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** [QueryInsights](#API_query_Query_RequestSyntax) ** 封裝啟用的設定`QueryInsights`。啟用會`QueryInsights`傳回洞見和指標，以及您所執行查詢的查詢結果。您可以使用 `QueryInsights`來調整查詢效能。類型：[QueryInsights](API_query_QueryInsights.md) 物件必要：否 ** [QueryString](#API_query_Query_RequestSyntax) ** Timestream 要執行的查詢。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ## 回應語法 ``` { "ColumnInfo": [ { "Name": "string", "Type": { "ArrayColumnInfo": "ColumnInfo", "RowColumnInfo": [ "ColumnInfo" ], "ScalarType": "string", "TimeSeriesMeasureValueColumnInfo": "ColumnInfo" } } ], "NextToken": "string", "QueryId": "string", "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } }, "UnloadPartitionCount": number, "UnloadWrittenBytes": number, "UnloadWrittenRows": number }, "QueryStatus": { "CumulativeBytesMetered": number, "CumulativeBytesScanned": number, "ProgressPercentage": number }, "Rows": [ { "Data": [ { "ArrayValue": [ "Datum" ], "NullValue": boolean, "RowValue": "Row", "ScalarValue": "string", "TimeSeriesValue": [ { "Time": "string", "Value": "Datum" } ] } ] } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ColumnInfo](#API_query_Query_ResponseSyntax) ** 傳回結果集的資料欄資料類型。類型：[ColumnInfo](API_query_ColumnInfo.md) 物件陣列 ** [NextToken](#API_query_Query_ResponseSyntax) ** 可在`Query`呼叫中再次使用的分頁字符，以取得下一組結果。類型：字串長度限制：長度下限為 1。長度上限為 2048。 ** [QueryId](#API_query_Query_ResponseSyntax) ** 指定查詢的唯一 ID。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9]+` ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) ** 封裝`QueryInsights`包含與您執行之查詢相關的洞見和指標。類型：[QueryInsightsResponse](API_query_QueryInsightsResponse.md) 物件 ** [QueryStatus](#API_query_Query_ResponseSyntax) ** 查詢狀態的相關資訊，包括掃描的進度和位元組。類型：[QueryStatus](API_query_QueryStatus.md) 物件 ** [Rows](#API_query_Query_ResponseSyntax) ** 查詢傳回的結果集資料列。類型：[Row](API_query_Row.md) 物件陣列 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** ConflictException ** 無法輪詢已取消查詢的結果。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** QueryExecutionException ** Timestream 無法成功執行查詢。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query) # TagResource 將一組標籤與 Timestream 資源建立關聯。然後，您可以啟用這些使用者定義的標籤，使其顯示在 Billing and Cost Management 主控台上，以進行成本分配追蹤。 ## 請求語法 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_query_TagResource_RequestSyntax) ** 識別應新增標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [Tags](#API_query_TagResource_RequestSyntax) ** 要指派給 Timestream 資源的標籤。類型：[Tag](API_query_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 您已超過服務配額。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) # UntagResource 從 Timestream 查詢資源移除標籤的關聯。 ## 請求語法 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) ** 要從中移除標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [TagKeys](#API_query_UntagResource_RequestSyntax) ** 標籤索引鍵的清單。資源的現有標籤，其金鑰是此清單的成員，將會從 Timestream 資源中移除。類型：字串陣列陣列成員：項目數下限為 0。項目數上限為 200。長度限制：長度下限為 1。長度上限為 128。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) # UpdateAccountSettings 轉換您的帳戶以使用 TCUs進行查詢定價，並修改您設定的最大查詢運算單位。如果您將的值減少`MaxQueryTCU`為所需的組態，則新值最多可能需要 24 小時才會生效。 **注意** 將帳戶轉換為使用 TCUs進行查詢定價之後，您就無法轉換為使用掃描的位元組進行查詢定價。 ## 請求語法 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } }, "TargetQueryTCU": number } }, "QueryPricingModel": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) ** 服務在任何時間點將用於服務查詢的運算單位數量上限。若要執行查詢，您必須將最小容量設定為 4 TCU。您可以在 4 的倍數中設定 TCU 數量上限，例如 4、8、16、32 等。支援的最大值`MaxQueryTCU`為 1000。若要請求提高此軟性限制，請聯絡 AWS Support。如需 maxQueryTCU 預設配額的相關資訊，請參閱預設配額。此組態僅適用於 Timestream Compute Units (TCUs 的隨需用量。支援的最大值`MaxQueryTCU`為 1000。若要請求提高此軟性限制，請聯絡 AWS Support。如需的預設配額的相關資訊`maxQueryTCU`，請參閱[預設配額](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default)。類型：整數必要：否 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) ** 修改帳戶中設定的查詢運算設定，包括查詢定價模型和帳戶中佈建的 Timestream 運算單位 TCUs)。QueryCompute 僅適用於亞太區域（孟買）區域。此 API 是等冪的，這表示多次提出相同的請求會與提出一次請求具有相同的效果。類型：[QueryComputeRequest](API_query_QueryComputeRequest.md) 物件必要：否 ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) ** 帳戶中查詢的定價模型。 `QueryPricingModel` 參數由數個 Timestream 操作使用；不過，`UpdateAccountSettings`API 操作無法辨識以外的任何值`COMPUTE_UNITS`。類型：字串有效值:`BYTES_SCANNED | COMPUTE_UNITS` 必要：否 ## 回應語法 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "ActiveQueryTCU": number, "LastUpdate": { "Status": "string", "StatusMessage": "string", "TargetQueryTCU": number }, "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } } } }, "QueryPricingModel": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) ** 服務在任何時間點將用於服務查詢的已設定運算單位數量上限。類型：整數 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) ** 確認更新的帳戶設定，以查詢帳戶中的資料。QueryCompute 僅適用於亞太區域（孟買）區域。類型：[QueryComputeResponse](API_query_QueryComputeResponse.md) 物件 ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) ** 帳戶的定價模型。類型：字串有效值:`BYTES_SCANNED | COMPUTE_UNITS` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) # UpdateScheduledQuery 更新排程查詢。 ## 請求語法 ``` { "ScheduledQueryArn": "string", "State": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) ** 排程查詢的狀態。類型：字串有效值:`ENABLED | DISABLED` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到請求的資源。 ** ScheduledQueryArn ** 排程查詢的 ARN。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery) # 資料類型 Amazon Timestream Write 支援下列資料類型： + [BatchLoadProgressReport](API_BatchLoadProgressReport.md) + [BatchLoadTask](API_BatchLoadTask.md) + [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) + [CsvConfiguration](API_CsvConfiguration.md) + [Database](API_Database.md) + [DataModel](API_DataModel.md) + [DataModelConfiguration](API_DataModelConfiguration.md) + [DataModelS3Configuration](API_DataModelS3Configuration.md) + [DataSourceConfiguration](API_DataSourceConfiguration.md) + [DataSourceS3Configuration](API_DataSourceS3Configuration.md) + [Dimension](API_Dimension.md) + [DimensionMapping](API_DimensionMapping.md) + [Endpoint](API_Endpoint.md) + [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) + [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) + [MeasureValue](API_MeasureValue.md) + [MixedMeasureMapping](API_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_MultiMeasureMappings.md) + [PartitionKey](API_PartitionKey.md) + [Record](API_Record.md) + [RecordsIngested](API_RecordsIngested.md) + [RejectedRecord](API_RejectedRecord.md) + [ReportConfiguration](API_ReportConfiguration.md) + [ReportS3Configuration](API_ReportS3Configuration.md) + [RetentionProperties](API_RetentionProperties.md) + [S3Configuration](API_S3Configuration.md) + [Schema](API_Schema.md) + [Table](API_Table.md) + [Tag](API_Tag.md) Amazon Timestream Query 支援下列資料類型： + [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) + [ColumnInfo](API_query_ColumnInfo.md) + [Datum](API_query_Datum.md) + [DimensionMapping](API_query_DimensionMapping.md) + [Endpoint](API_query_Endpoint.md) + [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) + [ErrorReportLocation](API_query_ErrorReportLocation.md) + [ExecutionStats](API_query_ExecutionStats.md) + [LastUpdate](API_query_LastUpdate.md) + [MixedMeasureMapping](API_query_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_query_MultiMeasureMappings.md) + [NotificationConfiguration](API_query_NotificationConfiguration.md) + [ParameterMapping](API_query_ParameterMapping.md) + [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) + [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) + [QueryComputeRequest](API_query_QueryComputeRequest.md) + [QueryComputeResponse](API_query_QueryComputeResponse.md) + [QueryInsights](API_query_QueryInsights.md) + [QueryInsightsResponse](API_query_QueryInsightsResponse.md) + [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) + [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) + [QueryStatus](API_query_QueryStatus.md) + [QueryTemporalRange](API_query_QueryTemporalRange.md) + [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) + [Row](API_query_Row.md) + [S3Configuration](API_query_S3Configuration.md) + [S3ReportLocation](API_query_S3ReportLocation.md) + [ScheduleConfiguration](API_query_ScheduleConfiguration.md) + [ScheduledQuery](API_query_ScheduledQuery.md) + [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) + [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) + [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) + [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) + [SelectColumn](API_query_SelectColumn.md) + [SnsConfiguration](API_query_SnsConfiguration.md) + [Tag](API_query_Tag.md) + [TargetConfiguration](API_query_TargetConfiguration.md) + [TargetDestination](API_query_TargetDestination.md) + [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) + [TimestreamConfiguration](API_query_TimestreamConfiguration.md) + [TimestreamDestination](API_query_TimestreamDestination.md) + [Type](API_query_Type.md) # Amazon Timestream 寫入 Amazon Timestream Write 支援下列資料類型： + [BatchLoadProgressReport](API_BatchLoadProgressReport.md) + [BatchLoadTask](API_BatchLoadTask.md) + [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) + [CsvConfiguration](API_CsvConfiguration.md) + [Database](API_Database.md) + [DataModel](API_DataModel.md) + [DataModelConfiguration](API_DataModelConfiguration.md) + [DataModelS3Configuration](API_DataModelS3Configuration.md) + [DataSourceConfiguration](API_DataSourceConfiguration.md) + [DataSourceS3Configuration](API_DataSourceS3Configuration.md) + [Dimension](API_Dimension.md) + [DimensionMapping](API_DimensionMapping.md) + [Endpoint](API_Endpoint.md) + [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) + [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) + [MeasureValue](API_MeasureValue.md) + [MixedMeasureMapping](API_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_MultiMeasureMappings.md) + [PartitionKey](API_PartitionKey.md) + [Record](API_Record.md) + [RecordsIngested](API_RecordsIngested.md) + [RejectedRecord](API_RejectedRecord.md) + [ReportConfiguration](API_ReportConfiguration.md) + [ReportS3Configuration](API_ReportS3Configuration.md) + [RetentionProperties](API_RetentionProperties.md) + [S3Configuration](API_S3Configuration.md) + [Schema](API_Schema.md) + [Table](API_Table.md) + [Tag](API_Tag.md) # BatchLoadProgressReport 批次載入任務進度的詳細資訊。 ## 目錄 ** BytesMetered ** 類型：Long 必要：否 ** FileFailures ** 類型：Long 必要：否 ** ParseFailures ** 類型：Long 必要：否 ** RecordIngestionFailures ** 類型：Long 必要：否 ** RecordsIngested ** 類型：Long 必要：否 ** RecordsProcessed ** 類型：Long 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) # BatchLoadTask 批次載入任務的詳細資訊。 ## 目錄 ** CreationTime ** Timestream 批次載入任務建立的時間。類型：Timestamp 必要：否 ** DatabaseName ** 批次載入任務載入資料的資料庫的資料庫名稱。類型：字串必要：否 ** LastUpdatedTime ** Timestream 批次載入任務上次更新的時間。類型：Timestamp 必要：否 ** ResumableUntil ** 類型：Timestamp 必要：否 ** TableName ** 批次載入任務載入資料的資料表名稱。類型：字串必要：否 ** TaskId ** 批次載入任務的 ID。類型：字串長度限制：長度下限為 3。長度上限為 32。模式：`[A-Z0-9]+` 必要：否 ** TaskStatus ** 批次載入任務的狀態。類型：字串有效值:`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) # BatchLoadTaskDescription 批次載入任務的詳細資訊。 ## 目錄 ** CreationTime ** Timestream 批次載入任務建立的時間。類型：Timestamp 必要：否 ** DataModelConfiguration ** 批次載入任務的資料模型組態。這包含批次載入任務資料模型存放位置的詳細資訊。類型：[DataModelConfiguration](API_DataModelConfiguration.md) 物件必要：否 ** DataSourceConfiguration ** 批次載入任務之資料來源的組態詳細資訊。類型：[DataSourceConfiguration](API_DataSourceConfiguration.md) 物件必要：否 ** ErrorMessage ** 類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** LastUpdatedTime ** Timestream 批次載入任務上次更新的時間。類型：Timestamp 必要：否 ** ProgressReport ** 類型：[BatchLoadProgressReport](API_BatchLoadProgressReport.md) 物件必要：否 ** RecordVersion ** 類型：Long 必要：否 ** ReportConfiguration ** 批次載入任務的報告組態。這包含錯誤報告存放位置的詳細資訊。類型：[ReportConfiguration](API_ReportConfiguration.md) 物件必要：否 ** ResumableUntil ** 類型：Timestamp 必要：否 ** TargetDatabaseName ** 類型：字串必要：否 ** TargetTableName ** 類型：字串必要：否 ** TaskId ** 批次載入任務的 ID。類型：字串長度限制：長度下限為 3。長度上限為 32。模式：`[A-Z0-9]+` 必要：否 ** TaskStatus ** 批次載入任務的狀態。類型：字串有效值:`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) # CsvConfiguration 分隔的資料格式，其中資料欄分隔符號可以是逗號，而記錄分隔符號是新行字元。 ## 目錄 ** ColumnSeparator ** 資料欄分隔符號可以是逗號 ('，')、管道 ('\$1)、分號 ('；')、 tab('/t') 或空格 (' ')。類型：字串長度限制條件：固定長度為 1。必要：否 ** EscapeChar ** 逸出字元可以是其中之一類型：字串長度限制條件：固定長度為 1。必要：否 ** NullValue ** 可以是空格 (' ')。類型：字串長度限制：長度下限為 1。長度上限為 256。必要：否 ** QuoteChar ** 可以是單引號 (') 或雙引號 (")。類型：字串長度限制條件：固定長度為 1。必要：否 ** TrimWhiteSpace ** 指定修剪前後的空格。類型：布林值必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) # Database 資料表的頂層容器。資料庫和資料表是 Amazon Timestream 中的基本管理概念。資料庫中的所有資料表都會使用相同的 AWS KMS 金鑰加密。 ## 目錄 ** Arn ** 唯一識別此資料庫的 Amazon Resource Name。類型：字串必要：否 ** CreationTime ** 建立資料庫的時間，從 Unix epoch 時間開始計算。類型：Timestamp 必要：否 ** DatabaseName ** Timestream 資料庫的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：否 ** KmsKeyId ** 用來加密資料庫中存放之資料的 AWS KMS 金鑰識別碼。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** LastUpdatedTime ** 此資料庫上次更新的時間。類型：Timestamp 必要：否 ** TableCount ** Timestream 資料庫中找到的資料表總數。類型：Long 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Database) # DataModel 批次載入任務的資料模型。 ## 目錄 ** DimensionMappings ** 維度的來源至目標映射。類型：[DimensionMapping](API_DimensionMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：是 ** MeasureNameColumn ** 類型：字串長度限制：長度下限為 1。長度上限為 256。必要：否 ** MixedMeasureMappings ** 量值的來源至目標映射。類型：[MixedMeasureMapping](API_MixedMeasureMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：否 ** MultiMeasureMappings ** 多度量記錄的來源至目標映射。類型：[MultiMeasureMappings](API_MultiMeasureMappings.md) 物件必要：否 ** TimeColumn ** 要映射到時間的來源資料欄。類型：字串長度限制：長度下限為 1。長度上限為 256。必要：否 ** TimeUnit ** 時間戳記單位的精細程度。它指出時間值是秒、毫秒、奈秒或其他支援的值。預設值為 `MILLISECONDS`。類型：字串有效值:`MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModel) # DataModelConfiguration ## 目錄 ** DataModel ** 類型：[DataModel](API_DataModel.md) 物件必要：否 ** DataModelS3Configuration ** 類型：[DataModelS3Configuration](API_DataModelS3Configuration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelConfiguration) # DataModelS3Configuration ## 目錄 ** BucketName ** 類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必要：否 ** ObjectKey ** 類型：字串長度限制：長度下限為 1。長度上限為 1024。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelS3Configuration) # DataSourceConfiguration 定義資料來源的組態詳細資訊。 ## 目錄 ** DataFormat ** 這是目前 CSV。類型：字串有效值:`CSV` 必要：是 ** DataSourceS3Configuration ** 檔案的 S3 位置組態，其中包含要載入的資料。類型：[DataSourceS3Configuration](API_DataSourceS3Configuration.md) 物件必要：是 ** CsvConfiguration ** 分隔的資料格式，其中資料欄分隔符號可以是逗號，而記錄分隔符號是新行字元。類型：[CsvConfiguration](API_CsvConfiguration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceConfiguration) # DataSourceS3Configuration ## 目錄 ** BucketName ** 客戶 S3 儲存貯體的儲存貯體名稱。類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必要：是 ** ObjectKeyPrefix ** 類型：字串長度限制：長度下限為 1。長度上限為 1024。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) # Dimension 代表時間序列的中繼資料屬性。例如，EC2 執行個體的名稱和可用區域，或風力發電機製造商的名稱即為維度。 ## 目錄 ** Name ** Dimension 代表時間序列的中繼資料屬性。例如，EC2 執行個體的名稱和可用區域，或風力發電機製造商的名稱即為維度。如需維度名稱的限制，請參閱[命名限制](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)。類型：字串長度限制：長度下限為 1。長度上限為 60。必要：是 ** Value ** 維度值。類型：字串必要：是 ** DimensionValueType ** 時間序列資料點的維度資料類型。類型：字串有效值:`VARCHAR` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) # DimensionMapping ## 目錄 ** DestinationColumn ** 類型：字串長度限制：長度下限為 1。必要：否 ** SourceColumn ** 類型：字串長度限制：長度下限為 1。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) # Endpoint 代表要對其進行 API 呼叫的可用端點，以及該端點的 TTL。 ## 目錄 ** Address ** 端點地址。類型：字串必要：是 ** CachePeriodInMinutes ** 端點的 TTL，以分鐘為單位。類型：Long 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) # MagneticStoreRejectedDataLocation 在磁性存放區寫入期間，以非同步方式寫入遭拒絕記錄之錯誤報告的位置。 ## 目錄 ** S3Configuration ** 在磁性存放區寫入期間，以非同步方式寫入遭拒絕記錄之錯誤報告的 S3 位置組態。類型：[S3Configuration](API_S3Configuration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) # MagneticStoreWriteProperties 用於設定磁性存放區寫入的資料表上的屬性集。 ## 目錄 ** EnableMagneticStoreWrites ** 勇於啟用磁性存放區寫入的標記。類型：布林值必要：是 ** MagneticStoreRejectedDataLocation ** 在磁性存放區寫入期間，以非同步方式寫入遭拒絕記錄之錯誤報告的位置。類型：[MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreWriteProperties) # MeasureValue 代表時間序列的資料屬性。例如，EC2 執行個體的 CPU 使用率或風力渦輪機的 RPM 是測量方法。MeasureValue 同時具有名稱和值。 MeasureValue 僅適用於類型 `MULTI`。使用 `MULTI` 類型，您可以在單一記錄中傳遞與相同時間序列相關聯的多個資料屬性 ## 目錄 ** Name ** MeasureValue 的名稱。如需 MeasureValue 名稱的限制，請參閱《Amazon Timestream 開發人員指南》中的[命名限制](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)。類型：字串長度限制：長度下限為 1。必要：是 ** Type ** 包含時間序列資料點的 MeasureValue 資料類型。類型：字串有效值:`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 必要：是 ** Value ** MeasureValue 的值。如需詳細資訊，請參閱[資料類型](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MeasureValue) # MixedMeasureMapping ## 目錄 ** MeasureValueType ** 類型：字串有效值:`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 必要：是 ** MeasureName ** 類型：字串長度限制：長度下限為 1。必要：否 ** MultiMeasureAttributeMappings ** 類型：[MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：否 ** SourceColumn ** 類型：字串長度限制：長度下限為 1。必要：否 ** TargetMeasureName ** 類型：字串長度限制：長度下限為 1。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MixedMeasureMapping) # MultiMeasureAttributeMapping ## 目錄 ** SourceColumn ** 類型：字串長度限制：長度下限為 1。必要：是 ** MeasureValueType ** 類型：字串有效值:`DOUBLE | BIGINT | BOOLEAN | VARCHAR | TIMESTAMP` 必要：否 ** TargetMultiMeasureAttributeName ** 類型：字串長度限制：長度下限為 1。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings ## 目錄 ** MultiMeasureAttributeMappings ** 類型：[MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：是 ** TargetMultiMeasureName ** 類型：字串長度限制：長度下限為 1。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureMappings) # PartitionKey 用於分割資料表中資料的屬性。維度索引鍵會使用維度名稱指定為分割區索引鍵的維度值來分割資料，而測量索引鍵分割區資料則使用度量名稱 ('measure\$1name' 欄的值）。 ## 目錄 ** Type ** 分割區金鑰的類型。選項為 DIMENSION （尺寸索引鍵）和 MEASURE （度量索引鍵）。類型：字串有效值:`DIMENSION | MEASURE` 必要：是 ** EnforcementInRecord ** 擷取記錄中維度索引鍵規格的強制執行層級。選項為必要（必須指定尺寸索引鍵）和選用（不需要指定尺寸索引鍵）。類型：字串有效值:`REQUIRED | OPTIONAL` 必要：否 ** Name ** 用於維度索引鍵的屬性名稱。類型：字串長度限制：長度下限為 1。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) # Record 代表寫入 Timestream 的時間序列資料點。每個記錄都包含維度陣列。維度代表時間序列資料點的中繼資料屬性，例如 EC2 執行個體的執行個體名稱或可用區域。記錄也包含量值名稱，這是要收集的量值名稱（例如 EC2 執行個體的 CPU 使用率）。此外，記錄包含度量值和值類型，這是度量值的資料類型。此外，記錄包含收集量值時的時間戳記，以及時間戳記單位，其代表時間戳記的精細程度。記錄有一個`Version`欄位，這是 64 位元`long`，可用來更新資料點。只有在寫入請求中記錄的`Version`屬性高於現有記錄時，才會成功寫入具有相同維度、時間戳記和度量名稱但不同度量值的重複記錄。對於沒有 `Version` 欄位的記錄，時間串流預設為 `Version` `1`的。 ## 目錄 ** Dimensions ** 包含時間序列資料點的維度清單。類型：[Dimension](API_Dimension.md) 物件陣列陣列成員：最多 128 個項目。必要：否 ** MeasureName ** Measure 代表時間序列的資料屬性。例如，EC2 執行個體的 CPU 使用率或風力渦輪機的 RPM 是測量方式。類型：字串長度限制：長度下限為 1。長度上限為 256。必要：否 ** MeasureValue ** 包含時間序列資料點的測量值。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** MeasureValues ** 包含時間序列資料點的 MeasureValue 清單。這僅適用於類型 `MULTI`。對於純量值，請直接使用記錄的`MeasureValue`屬性。類型：[MeasureValue](API_MeasureValue.md) 物件陣列必要：否 ** MeasureValueType ** 包含時間序列資料點的測量值資料類型。預設類型為 `DOUBLE`。如需詳細資訊，請參閱[資料類型](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)。類型：字串有效值:`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 必要：否 ** Time ** 包含收集資料點的測量值的時間。時間值加上單位提供自 epoch 以來經過的時間。例如，如果時間值為 `12345`且單位為 `ms`，則自 epoch 以來`12345 ms`已經過。類型：字串長度限制：長度下限為 1。長度上限為 256。必要：否 ** TimeUnit ** 時間戳記單位的精細程度。它指出時間值是秒、毫秒、奈秒或其他支援的值。預設值為 `MILLISECONDS`。類型：字串有效值:`MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS` 必要：否 ** Version ** 用於記錄更新的 64 位元屬性。寫入具有較高版本編號之重複資料的請求，將會更新現有的量值和版本。如果測量值相同， `Version` 仍會更新。預設值為 `1`。 `Version` 必須是 `1`或更高版本，否則您會收到`ValidationException`錯誤。類型：Long 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) # RecordsIngested 此請求所擷取之記錄的相關資訊。 ## 目錄 ** MagneticStore ** 擷取至磁性存放區的記錄計數。類型：整數必要：否 ** MemoryStore ** 擷取至記憶體存放區的記錄計數。類型：整數必要：否 ** Total ** 成功擷取的記錄總數。類型：整數必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) # RejectedRecord 代表在將時間序列資料重新插入系統之前，因為必須解決的資料驗證問題而未成功插入 Timestream 的記錄。 ## 目錄 ** ExistingVersion ** 記錄的現有版本。在相同記錄存在的案例中，此值的版本高於寫入請求中的版本。類型：Long 必要：否 ** Reason ** 記錄未成功插入 Timestream 的原因。失敗的可能原因包括： + 具有重複資料的記錄，其中有多個記錄具有相同的維度、時間戳記和量值名稱，但： + 測量值不同 + 請求中不存在版本，*或*新記錄中的版本值等於或低於現有值如果 Timestream 拒絕此案例的資料，`RejectedRecords`回應中的 `ExistingVersion` 欄位會顯示目前記錄的版本。若要強制更新，您可以將記錄集的版本重新傳送請求，並設為大於的值`ExistingVersion`。 + 時間戳記位於記憶體存放區保留期間以外的記錄。 **注意** 更新保留時段時，如果您立即嘗試在新視窗中擷取資料，將會收到`RejectedRecords`例外狀況。若要避免`RejectedRecords`例外狀況，請等待新視窗的持續時間擷取新資料。如需詳細資訊，請參閱[設定 Timestream 的最佳實務](https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration)，以及[有關儲存如何在 Timestream 中運作的說明](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html)。 + 維度或量值超過 Timestream 定義限制的記錄。如需詳細資訊，請參閱《Timestream 開發人員指南》中的[存取管理](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。類型：字串必要：否 ** RecordIndex ** WriteRecords 輸入請求中的記錄索引。索引開頭為 0。類型：整數必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) # ReportConfiguration 批次載入任務的報告組態。這包含錯誤報告存放位置的詳細資訊。 ## 目錄 ** ReportS3Configuration ** 設定 S3 位置，以寫入批次載入的錯誤報告和事件。類型：[ReportS3Configuration](API_ReportS3Configuration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportConfiguration) # ReportS3Configuration ## 目錄 ** BucketName ** 類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必要：是 ** EncryptionOption ** 類型：字串有效值:`SSE_S3 | SSE_KMS` 必要：否 ** KmsKeyId ** 類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** ObjectKeyPrefix ** 類型：字串長度限制：長度下限為 1。長度上限為 928。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) # RetentionProperties 保留屬性包含時間序列資料必須儲存在磁性存放區和記憶體存放區中的持續時間。 ## 目錄 ** MagneticStoreRetentionPeriodInDays ** 資料必須儲存在磁性存放區中的持續時間。類型：Long 有效範圍：最小值為 1。最大值為 73000。必要：是 ** MemoryStoreRetentionPeriodInHours ** 資料必須儲存在記憶體存放區中的持續時間。類型：Long 有效範圍：最小值為 1。最大值為 8766。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RetentionProperties) # S3Configuration 指定 S3 位置的組態。 ## 目錄 ** BucketName ** 客戶 S3 儲存貯體的儲存貯體名稱。類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必要：否 ** EncryptionOption ** 客戶 S3 位置的加密選項。選項是使用 S3 受管金鑰或 AWS 受管金鑰進行 S3 伺服器端加密。類型：字串有效值:`SSE_S3 | SSE_KMS` 必要：否 ** KmsKeyId ** 使用 AWS 受管 AWS KMS 金鑰加密時，客戶 S3 位置的金鑰 ID。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** ObjectKeyPrefix ** 客戶 S3 位置的物件金鑰預覽。類型：字串長度限制：長度下限為 1。長度上限為 928。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) # Schema 結構描述指定資料表的預期資料模型。 ## 目錄 ** CompositePartitionKey ** 非空白的分割區索引鍵清單，定義用於分割資料表資料的屬性。清單的順序決定分割區階層。建立資料表後，無法變更每個分割區索引鍵的名稱和類型，以及分割區索引鍵順序。不過，可以變更每個分割區金鑰的強制執行層級。類型：[PartitionKey](API_PartitionKey.md) 物件陣列陣列成員：項目數下限為 1。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) # Table 代表 Timestream 中的資料庫資料表。資料表包含一或多個相關的時間序列。您可以修改資料表的記憶體存放區和磁性存放區的保留期間。 ## 目錄 ** Arn ** 唯一識別此資料表的 Amazon Resource Name。類型：字串必要：否 ** CreationTime ** Timestream 資料表建立的時間。類型：Timestamp 必要：否 ** DatabaseName ** 包含此資料表的 Timestream 資料庫名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：否 ** LastUpdatedTime ** Timestream 資料表上次更新的時間。類型：Timestamp 必要：否 ** MagneticStoreWriteProperties ** 包含啟用磁性存放區寫入時要在表格上設定的屬性。類型：[MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 物件必要：否 ** RetentionProperties ** 記憶體存放區和磁帶存放區的保留期間。類型：[RetentionProperties](API_RetentionProperties.md) 物件必要：否 ** Schema ** 資料表的結構描述。類型：[Schema](API_Schema.md) 物件必要：否 ** TableName ** Timestream 資料表的名稱。類型：字串長度限制：長度下限為 3。長度上限為 256。必要：否 ** TableStatus ** 資料表的目前狀態： + `DELETING` - 正在刪除資料表。 + `ACTIVE` - 資料表已就緒可供使用。類型：字串有效值:`ACTIVE | DELETING | RESTORING` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) # Tag 標籤是您指派給 Timestream 資料庫和/或資料表的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。您可以使用標籤來分類資料庫和/或資料表，例如依用途、擁有者或環境。 ## 目錄 ** Key ** 標籤鍵。標籤鍵會區分大小寫。類型：字串長度限制：長度下限為 1。長度上限為 128。必要：是 ** Value ** 標籤的值。標籤值區分大小寫，可以是 null。類型：字串長度限制：長度下限為 0。長度上限為 256。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) # Amazon Timestream 查詢 Amazon Timestream Query 支援下列資料類型： + [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) + [ColumnInfo](API_query_ColumnInfo.md) + [Datum](API_query_Datum.md) + [DimensionMapping](API_query_DimensionMapping.md) + [Endpoint](API_query_Endpoint.md) + [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) + [ErrorReportLocation](API_query_ErrorReportLocation.md) + [ExecutionStats](API_query_ExecutionStats.md) + [LastUpdate](API_query_LastUpdate.md) + [MixedMeasureMapping](API_query_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_query_MultiMeasureMappings.md) + [NotificationConfiguration](API_query_NotificationConfiguration.md) + [ParameterMapping](API_query_ParameterMapping.md) + [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) + [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) + [QueryComputeRequest](API_query_QueryComputeRequest.md) + [QueryComputeResponse](API_query_QueryComputeResponse.md) + [QueryInsights](API_query_QueryInsights.md) + [QueryInsightsResponse](API_query_QueryInsightsResponse.md) + [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) + [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) + [QueryStatus](API_query_QueryStatus.md) + [QueryTemporalRange](API_query_QueryTemporalRange.md) + [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) + [Row](API_query_Row.md) + [S3Configuration](API_query_S3Configuration.md) + [S3ReportLocation](API_query_S3ReportLocation.md) + [ScheduleConfiguration](API_query_ScheduleConfiguration.md) + [ScheduledQuery](API_query_ScheduledQuery.md) + [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) + [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) + [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) + [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) + [SelectColumn](API_query_SelectColumn.md) + [SnsConfiguration](API_query_SnsConfiguration.md) + [Tag](API_query_Tag.md) + [TargetConfiguration](API_query_TargetConfiguration.md) + [TargetDestination](API_query_TargetDestination.md) + [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) + [TimestreamConfiguration](API_query_TimestreamConfiguration.md) + [TimestreamDestination](API_query_TimestreamDestination.md) + [Type](API_query_Type.md) # AccountSettingsNotificationConfiguration 帳戶設定相關通知的組態設定。 ## 目錄 ** RoleArn ** 授予 Timestream 發佈通知許可的 Amazon Resource Name (ARN)。只有在更新帳戶設定時提供 SNS 主題時，才會顯示此欄位。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** SnsConfiguration ** 傳送通知所需的 SNS 詳細資訊。類型：[SnsConfiguration](API_query_SnsConfiguration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) # ColumnInfo 包含查詢結果的中繼資料，例如資料欄名稱、資料類型和其他屬性。 ## 目錄 ** Type ** 結果集資料欄的資料類型。資料類型可以是純量或複雜。純量資料類型是整數、字串、雙數、布林值和其他。複雜的資料類型是陣列、資料列等類型。類型：[Type](API_query_Type.md) 物件必要：是 ** Name ** 結果集資料欄的名稱。結果集的名稱適用於所有資料類型的資料欄，陣列除外。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) # Datum 基準代表查詢結果中的單一資料點。 ## 目錄 ** ArrayValue ** 指示資料點是否為陣列。類型：[Datum](#API_query_Datum) 物件陣列必要：否 ** NullValue ** 指示資料點是否為 null。類型：布林值必要：否 ** RowValue ** 指示資料點是否為資料列。類型：[Row](API_query_Row.md) 物件必要：否 ** ScalarValue ** 指出資料點是純量值，例如整數、字串、雙值或布林值。類型：字串必要：否 ** TimeSeriesValue ** 指示資料點是否為 Timeeries 資料類型。類型：[TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) 物件陣列必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) # DimensionMapping 這種類型用於將查詢結果中的資料行映射至目的地資料表中的維度。 ## 目錄 ** DimensionValueType ** 維度的類型。類型：字串有效值:`VARCHAR` 必要：是 ** Name ** 查詢結果中資料行的名稱。類型：字串必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) # Endpoint 代表要對其進行 API 呼叫的可用端點，以及該端點的 TTL。 ## 目錄 ** Address ** 端點地址。類型：字串必要：是 ** CachePeriodInMinutes ** 端點的 TTL，以分鐘為單位。類型：Long 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) # ErrorReportConfiguration 錯誤報告所需的組態。 ## 目錄 ** S3Configuration ** 錯誤報告的 S3 組態。類型：[S3Configuration](API_query_S3Configuration.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) # ErrorReportLocation 這包含單一排程查詢呼叫的錯誤報告位置。 ## 目錄 ** S3ReportLocation ** 寫入錯誤報告的 S3 位置。類型：[S3ReportLocation](API_query_S3ReportLocation.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) # ExecutionStats 單一排程查詢執行的統計資料。 ## 目錄 ** BytesMetered ** 為單一排程查詢執行計量的位元組。類型：Long 必要：否 ** CumulativeBytesScanned ** 掃描單一排程查詢執行的位元組。類型：Long 必要：否 ** DataWrites ** 資料會針對單一排程查詢執行中擷取的記錄進行計量。類型：Long 必要：否 ** ExecutionTimeInMillis ** 排程查詢執行完成所需的總時間，以毫秒為單位。類型：Long 必要：否 ** QueryResultRows ** 在擷取至目的地資料來源之前，從執行查詢輸出中出現的資料列數。類型：Long 必要：否 ** RecordsIngested ** 單一排程查詢執行擷取的記錄數目。類型：Long 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecutionStats) # LastUpdate 包含最近帳戶設定更新的組態物件，只有在先前更新過設定時才會顯示。 ## 目錄 ** Status ** 上次更新的狀態。可以是 `PENDING`、 `FAILED`或 `SUCCEEDED`。類型：字串有效值:`PENDING | FAILED | SUCCEEDED` 必要：否 ** StatusMessage ** 描述上次帳戶設定更新狀態的錯誤訊息，只有在發生錯誤時才會顯示。類型：字串必要：否 ** TargetQueryTCU ** 上次帳戶設定更新中請求的 TimeStream Compute Units (TCUs數量。類型：整數必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) # MixedMeasureMapping MixedMeasureMapping 是可以用來將資料擷取到衍生資料表中窄和多重度量混合中的映射。 ## 目錄 ** MeasureValueType ** 要從 sourceColumn 讀取的值類型。如果映射用於 MULTI，請使用 MeasureValueType.MULTI。類型：字串有效值:`BIGINT | BOOLEAN | DOUBLE | VARCHAR | MULTI` 必要：是 ** MeasureName ** 請參考結果資料列中的 measure\$1name 值。如果提供 MeasureNameColumn，此欄位為必要項目。類型：字串必要：否 ** MultiMeasureAttributeMappings ** 當 measureValueType 為 MULTI 時，此為必要項目。MULTI 值度量的屬性映射。類型：[MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：否 ** SourceColumn ** 此欄位是指要從中讀取度量值以進行結果實體化的來源資料行。類型：字串必要：否 ** TargetMeasureName ** 要使用的目標度量名稱。如果未提供，預設情況下，目標度量名稱將為度量名稱 (如果提供)，否則為 sourceColumn。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MixedMeasureMapping) # MultiMeasureAttributeMapping MULTI 值度量的屬性映射。 ## 目錄 ** MeasureValueType ** 從來源資料行讀取的屬性類型。類型：字串有效值:`BIGINT | BOOLEAN | DOUBLE | VARCHAR | TIMESTAMP` 必要：是 ** SourceColumn ** 要從其中讀取屬性值的來源資料行。類型：字串必要：是 ** TargetMultiMeasureAttributeName ** 用於衍生資料表中屬性名稱的自訂名稱。如果未提供，則會使用來源資料行名稱。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings 僅提供 MixedMeasureMappings 或 MultiMeasureMappings 中的一個。MultiMeasureMappings 可用於擷取衍生資料表中作為多重度量的資料。 ## 目錄 ** MultiMeasureAttributeMappings ** 必要。用於將查詢結果映射至擷取多重度量屬性資料的屬性映射。類型：[MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：是 ** TargetMultiMeasureName ** 衍生資料表中目標多重度量名稱的名稱。如果未提供 measureNameColumn，此輸入為必要項目。如果提供 MeasureNameColumn，該資料行中的值將作為多重度量名稱使用。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureMappings) # NotificationConfiguration 排程查詢的通知組態。Timestream 會在建立排程查詢、更新其狀態或將其刪除時傳送通知。 ## 目錄 ** SnsConfiguration ** Amazon Simple Notification Service (SNS) 組態的詳細資訊。只有在更新帳戶設定時提供 SNS 主題時，才會顯示此欄位。類型：[SnsConfiguration](API_query_SnsConfiguration.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) # ParameterMapping 具名參數的映射。 ## 目錄 ** Name ** 參數名稱。類型：字串必要：是 ** Type ** 包含查詢結果集中資料欄的資料類型。資料類型可以是純量或複雜。支援的純量資料類型為整數、布林值、字串、雙、時間戳記、日期、時間和間隔。支援的複雜資料類型為陣列、資料列和時間記錄。類型：[Type](API_query_Type.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) # ProvisionedCapacityRequest 請求更新用於查詢資料的佈建容量設定。 ## 目錄 ** TargetQueryTCU ** 查詢資料的目標運算容量，在 Timestream Compute Units (TCUs中指定。類型：整數必要：是 ** NotificationConfiguration ** 與佈建容量更新相關的通知組態設定。類型：[AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) # ProvisionedCapacityResponse 對請求的回應，以更新用於查詢資料的佈建容量設定。 ## 目錄 ** ActiveQueryTCU ** 帳戶中佈建的 Timestream Compute Units (TCUs數量。只有在運算模式為時，才會顯示此欄位`PROVISIONED`。類型：整數必要：否 ** LastUpdate ** 佈建容量設定上次更新的相關資訊。類型：[LastUpdate](API_query_LastUpdate.md) 物件必要：否 ** NotificationConfiguration ** 包含每當修改佈建容量設定時所傳送通知的設定的物件。只有在運算模式為時，才會顯示此欄位`PROVISIONED`。類型：[AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) # QueryComputeRequest 擷取或更新用於查詢資料的運算容量設定的請求。QueryCompute 僅適用於亞太區域（孟買）區域。 ## 目錄 ** ComputeMode ** 在帳戶中配置和使用 Timestream Compute Units (TCUs的模式。請注意，在亞太區域（孟買）區域中，API 操作只會辨識值 `PROVISIONED`。QueryCompute 僅適用於亞太區域（孟買）區域。類型：字串有效值:`ON_DEMAND | PROVISIONED` 必要：否 ** ProvisionedCapacity ** 組態物件，其中包含您帳戶中佈建時間串流運算單位 (TCUs的設定。QueryCompute 僅適用於亞太區域（孟買）區域。類型：[ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) # QueryComputeResponse 請求的回應，以擷取或更新查詢資料的運算容量設定。QueryCompute 僅適用於亞太區域（孟買）區域。 ## 目錄 ** ComputeMode ** 在帳戶中配置和使用 Timestream Compute Units (TCUs的模式。請注意，在亞太區域（孟買）區域中，API 操作只會辨識值 `PROVISIONED`。QueryCompute 僅適用於亞太區域（孟買）區域。類型：字串有效值:`ON_DEMAND | PROVISIONED` 必要：否 ** ProvisionedCapacity ** 組態物件，其中包含您帳戶中佈建時間串流運算單位 (TCUs的設定。QueryCompute 僅適用於亞太區域（孟買）區域。類型：[ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeResponse) # QueryInsights `QueryInsights` 是一項效能調校功能，可協助您最佳化查詢、降低成本並提升效能。使用 `QueryInsights`，您可以評估查詢的截斷效率，並識別需要改進的區域，以增強查詢效能。使用 `QueryInsights`，您也可以根據時間與空間修剪來分析查詢的有效性，並找出改善效能的機會。具體而言，您可以評估查詢使用時間型和分割區金鑰型索引策略來最佳化資料擷取的能力。若要最佳化查詢效能，您必須同時微調管理查詢執行的時間和空間參數。提供的關鍵指標`QueryInsights`是 `QuerySpatialCoverage`和 `QueryTemporalRange`。 `QuerySpatialCoverage`指出查詢掃描的空間軸有多少，而較低的值更有效率。 `QueryTemporalRange`顯示掃描的時間範圍，而較窄的範圍則效能更佳。 **QueryInsights 的優點** 以下是使用的主要優點`QueryInsights`： + **識別效率不佳的查詢** – `QueryInsights`提供查詢存取之資料表的時間型和屬性型剪除的相關資訊。此資訊可協助您識別以次最佳化方式存取的資料表。 + **最佳化資料模型和分割** – 您可以使用`QueryInsights`資訊來存取和微調資料模型和分割策略。 + **調整查詢** – `QueryInsights`重點介紹更有效地使用索引的機會。 **注意** 您允許在`QueryInsights`啟用的情況下提出的 `Query` API 請求數目上限為每秒 1 個查詢 (QPS)。如果您超過此查詢速率，可能會導致限流。 ## 目錄 ** Mode ** 提供下列模式以啟用 `QueryInsights`： + `ENABLED_WITH_RATE_CONTROL` – `QueryInsights`啟用正在處理的查詢。此模式也包含速率控制機制，將`QueryInsights`功能限制為每秒 1 個查詢 (QPS)。 + `DISABLED` – 停用 `QueryInsights`。類型：字串有效值:`ENABLED_WITH_RATE_CONTROL | DISABLED` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) # QueryInsightsResponse 提供與您執行之查詢相關的各種洞見和指標。 ## 目錄 ** OutputBytes ** 以位元組為單位指示查詢結果集的大小。您可以使用此資料來驗證結果集是否已在查詢調校練習中變更。類型：Long 必要：否 ** OutputRows ** 指示作為查詢結果集一部分傳回的資料列總數。您可以使用此資料來驗證結果集中的資料列數是否已變更，做為查詢調校練習的一部分。類型：Long 必要：否 ** QuerySpatialCoverage ** 提供查詢空間涵蓋範圍的洞見，包括具有次佳（最大）空間修剪的資料表。此資訊可協助您識別需要改善分割策略的區域，以增強空間修剪。類型：[QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 物件必要：否 ** QueryTableCount ** 指示查詢中的資料表數量。類型：Long 必要：否 ** QueryTemporalRange ** 提供查詢時間範圍的洞見，包括具有最大（最大）時間範圍的資料表。以下是最佳化時間型修剪的一些潛在選項： + 新增缺少的時間述詞。 + 移除時間述詞周圍的函數。 + 將時間述詞新增至所有子查詢。類型：[QueryTemporalRange](API_query_QueryTemporalRange.md) 物件必要：否 ** UnloadPartitionCount ** 指示 `Unload`操作建立的分割區。類型：Long 必要：否 ** UnloadWrittenBytes ** 表示 `Unload`操作所寫入的大小，以位元組為單位。類型：Long 必要：否 ** UnloadWrittenRows ** 指示`Unload`查詢寫入的資料列。類型：Long 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsightsResponse) # QuerySpatialCoverage 提供查詢空間涵蓋範圍的洞見，包括具有次佳（最大）空間修剪的資料表。此資訊可協助您識別需要改善分割策略的領域，以增強空間修剪例如，您可以使用`QuerySpatialCoverage`資訊執行下列動作： + 新增 measure\$1name [或使用客戶定義的分割區金鑰](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html) (CDPK) 述詞。 + 如果您已完成上述動作，請移除它們周圍的函數或子句，例如 `LIKE`。 ## 目錄 ** Max ** 提供已執行查詢的空間涵蓋範圍，以及空間修剪效率最低的資料表的洞見。 + `Value` – 空間涵蓋範圍的最大比率。 + `TableArn` – 具有次佳空間修剪之資料表的 Amazon Resource Name (ARN)。 + `PartitionKey` – 用於分割的分割區索引鍵，可以是預設值`measure_name`或 CDPK。類型：[QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverage) # QuerySpatialCoverageMax 提供資料表的洞見，其中包含查詢掃描到的最次佳空間範圍。 ## 目錄 ** PartitionKey ** 用於分割的分割區索引鍵，可以是預設`measure_name`或[客戶定義的分割區索引鍵](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html)。類型：字串陣列必要：否 ** TableArn ** 具有最次理想空間修剪之資料表的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** Value ** 空間涵蓋範圍的最大比率。類型：Double 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) # QueryStatus 查詢狀態的相關資訊，包括進度和掃描的位元組。 ## 目錄 ** CumulativeBytesMetered ** 查詢掃描的資料量，以位元組為單位，您需支付費用。這是累積總和，代表自查詢開始後，您將要支付的資料總量。費用只會套用一次，並在查詢完成執行或查詢取消時套用。類型：Long 必要：否 ** CumulativeBytesScanned ** 查詢掃描的資料量，以位元組為單位。這是累積總和，代表查詢開始後掃描的總位元組數。類型：Long 必要：否 ** ProgressPercentage ** 查詢的進度，以百分比表示。類型：Double 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) # QueryTemporalRange 提供查詢時間範圍的洞見，包括具有最大（最大）時間範圍的資料表。 ## 目錄 ** Max ** 封裝下列屬性，提供對時間軸上效能最差資料表的洞見： + `Value` – 查詢開始和結束之間的最長持續時間，以奈秒為單位。 + `TableArn` – 查詢最大時間範圍之資料表的 Amazon Resource Name (ARN)。類型：[QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) # QueryTemporalRangeMax 提供資料表的洞見，其中包含查詢掃描到的最次佳時間修剪。 ## 目錄 ** TableArn ** 查詢最大時間範圍之資料表的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** Value ** 查詢開始和結束之間的最長持續時間，以奈秒為單位。類型：Long 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) # Row 代表查詢結果中的單一資料列。 ## 目錄 ** Data ** 結果集單一資料列中的資料點清單。類型：[Datum](API_query_Datum.md) 物件陣列必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Row) # S3Configuration 執行查詢所產生之錯誤報告的 S3 位置詳細資訊。 ## 目錄 ** BucketName ** 將在其下建立錯誤報告的 S3 儲存貯體名稱。類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必要：是 ** EncryptionOption ** 錯誤報告的靜態加密選項。如果未指定加密選項，Timestream 將選擇 SSE\$1S3 作為預設值。類型：字串有效值:`SSE_S3 | SSE_KMS` 必要：否 ** ObjectKeyPrefix ** 錯誤報告索引鍵的字首。在預設情況下，Timestream 會將以下字首新增到錯誤報告路徑。類型：字串長度限制：長度下限為 1。長度上限為 896。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3Configuration) # S3ReportLocation 排程查詢執行的 S3 報告位置。 ## 目錄 ** BucketName ** S3 儲存貯體名稱。類型：字串長度限制：長度下限為 3。長度上限為 63。模式：`[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必要：否 ** ObjectKey ** S3 金鑰。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) # ScheduleConfiguration 查詢排程的組態。 ## 目錄 ** ScheduleExpression ** 表示何時觸發排程查詢執行的運算式。這可以是 Cron 運算式或 Rate 運算式。類型：字串長度限制：長度下限為 1。長度上限為 256。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) # ScheduledQuery 排程查詢 ## 目錄 ** Arn ** Amazon Resource Name。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** Name ** 排程查詢的名稱。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：是 ** State ** 排程查詢的狀態。類型：字串有效值:`ENABLED | DISABLED` 必要：是 ** CreationTime ** 排程查詢的建立時間。類型：Timestamp 必要：否 ** ErrorReportConfiguration ** 排程查詢錯誤報告的組態。類型：[ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 物件必要：否 ** LastRunStatus ** 上次排程查詢執行的狀態。類型：字串有效值:`AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 必要：否 ** NextInvocationTime ** 下次執行排程查詢時。類型：Timestamp 必要：否 ** PreviousInvocationTime ** 上次執行排程查詢的時間。類型：Timestamp 必要：否 ** TargetDestination ** 將寫入最終排程查詢結果的目標資料來源。類型：[TargetDestination](API_query_TargetDestination.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) # ScheduledQueryDescription 描述排程查詢的結構。 ## 目錄 ** Arn ** 排程查詢 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** Name ** 排程查詢的名稱。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：是 ** NotificationConfiguration ** 通知組態。類型：[NotificationConfiguration](API_query_NotificationConfiguration.md) 物件必要：是 ** QueryString ** 要執行的查詢。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ** ScheduleConfiguration ** 排程組態。類型：[ScheduleConfiguration](API_query_ScheduleConfiguration.md) 物件必要：是 ** State ** 排程查詢的狀態。類型：字串有效值:`ENABLED | DISABLED` 必要：是 ** CreationTime ** 排程查詢的建立時間。類型：Timestamp 必要：否 ** ErrorReportConfiguration ** 排程查詢的錯誤報告組態。類型：[ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 物件必要：否 ** KmsKeyId ** 客戶提供的 KMS 金鑰，用於加密排程查詢資源。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** LastRunSummary ** 上次排程查詢執行的執行期摘要。類型：[ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 物件必要：否 ** NextInvocationTime ** 排程查詢下次排程執行的時間。類型：Timestamp 必要：否 ** PreviousInvocationTime ** 上次執行查詢的時間。類型：Timestamp 必要：否 ** RecentlyFailedRuns ** 最後五次失敗排程查詢執行的執行期摘要。類型：[ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 物件陣列必要：否 ** ScheduledQueryExecutionRoleArn ** Timestream 用來執行排程查詢的 IAM 角色。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** TargetConfiguration ** 排程查詢目標存放區組態。類型：[TargetConfiguration](API_query_TargetConfiguration.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) # ScheduledQueryInsights 封裝在 `QueryInsights`上啟用的設定`ExecuteScheduledQueryRequest`。 ## 目錄 ** Mode ** 提供下列模式以啟用 `ScheduledQueryInsights`： + `ENABLED_WITH_RATE_CONTROL` – `ScheduledQueryInsights`啟用正在處理的查詢。此模式也包含速率控制機制，將`QueryInsights`功能限制為每秒 1 個查詢 (QPS)。 + `DISABLED` – 停用 `ScheduledQueryInsights`。類型：字串有效值:`ENABLED_WITH_RATE_CONTROL | DISABLED` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) # ScheduledQueryInsightsResponse 提供與`ExecuteScheduledQueryRequest`已執行相關的各種洞見和指標。 ## 目錄 ** OutputBytes ** 以位元組為單位指示查詢結果集的大小。您可以使用此資料來驗證結果集是否已在查詢調校練習中變更。類型：Long 必要：否 ** OutputRows ** 指示作為查詢結果集一部分傳回的資料列總數。您可以使用此資料來驗證結果集中的資料列數是否已變更，做為查詢調校練習的一部分。類型：Long 必要：否 ** QuerySpatialCoverage ** 提供查詢空間涵蓋範圍的洞見，包括具有次佳（最大）空間修剪的資料表。此資訊可協助您識別需要改善分割策略的區域，以增強空間修剪。類型：[QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 物件必要：否 ** QueryTableCount ** 指示查詢中的資料表數量。類型：Long 必要：否 ** QueryTemporalRange ** 提供查詢時間範圍的洞見，包括具有最大（最大）時間範圍的資料表。以下是最佳化時間型修剪的一些潛在選項： + 新增缺少的時間述詞。 + 移除時間述詞周圍的函數。 + 將時間述詞新增至所有子查詢。類型：[QueryTemporalRange](API_query_QueryTemporalRange.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) # ScheduledQueryRunSummary 執行排程查詢的摘要 ## 目錄 ** ErrorReportLocation ** 錯誤報告的 S3 位置。類型：[ErrorReportLocation](API_query_ErrorReportLocation.md) 物件必要：否 ** ExecutionStats ** 排程執行的執行時間統計資料。類型：[ExecutionStats](API_query_ExecutionStats.md) 物件必要：否 ** FailureReason ** 故障時排程查詢的錯誤訊息。您可能需要查看錯誤報告，以取得更詳細的錯誤原因。類型：字串必要：否 ** InvocationTime ** 此執行的 InvocationTime。這是排定查詢執行的時間。參數`@scheduled_runtime`可用於查詢以取得值。類型：Timestamp 必要：否 ** QueryInsightsResponse ** 提供與排程查詢執行摘要相關的各種洞見和指標。類型：[ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) 物件必要：否 ** RunStatus ** 排程查詢執行的狀態。類型：字串有效值:`AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 必要：否 ** TriggerTime ** 查詢執行的實際時間。類型：Timestamp 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) # SelectColumn 查詢傳回的資料欄詳細資訊。 ## 目錄 ** Aliased ** 正確，如果資料欄名稱由查詢別名。否則為 False。類型：布林值必要：否 ** DatabaseName ** 具有此欄位的資料庫。類型：字串必要：否 ** Name ** 欄的名稱。類型：字串必要：否 ** TableName ** 具有此資料欄的資料庫中的資料表。類型：字串必要：否 ** Type ** 包含查詢結果集中資料欄的資料類型。資料類型可以是純量或複雜。支援的純量資料類型為整數、布林值、字串、雙、時間戳記、日期、時間和間隔。支援的複雜資料類型為陣列、資料列和時間記錄。類型：[Type](API_query_Type.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) # SnsConfiguration 傳送通知所需的 SNS 詳細資訊。 ## 目錄 ** TopicArn ** 將對其傳送排程查詢狀態通知的 SNS 主題 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) # Tag 標籤是您指派給 Timestream 資料庫和/或資料表的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤可讓您將資料庫和/或資料表分類，例如依用途、擁有者或環境。 ## 目錄 ** Key ** 標籤鍵。標籤鍵會區分大小寫。類型：字串長度限制：長度下限為 1。長度上限為 128。必要：是 ** Value ** 標籤的值。標籤值區分大小寫，可以是 null。類型：字串長度限制：長度下限為 0。長度上限為 256。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) # TargetConfiguration 用於寫入查詢輸出的組態。 ## 目錄 ** TimestreamConfiguration ** 將資料寫入 Timestream 資料庫和資料表所需的組態。類型：[TimestreamConfiguration](API_query_TimestreamConfiguration.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) # TargetDestination 寫入目標資料來源資料的目標詳細資訊。目前支援的資料來源是 Timestream。 ## 目錄 ** TimestreamDestination ** 查詢 Timestream 資料來源的結果目的地詳細資訊。類型：[TimestreamDestination](API_query_TimestreamDestination.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) # TimeSeriesDataPoint Timeeries 資料類型代表一段時間內量值的值。時間序列是時間戳記和測量值的資料列陣列，資料列依時間的遞增順序排序。TimeSeriesDataPoint 是時間序列中的單一資料點。它代表時間序列中（時間、測量值）的元組。 ## 目錄 ** Time ** 收集測量值時的時間戳記。類型：字串必要：是 ** Value ** 資料點的測量值。類型：[Datum](API_query_Datum.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimeSeriesDataPoint) # TimestreamConfiguration 要將資料寫入 Timestream 資料庫和資料表的組態。此組態可讓使用者將查詢結果選取資料行映射至目的地資料表資料行。 ## 目錄 ** DatabaseName ** 要將查詢結果寫入其中的 Timestream 資料庫名稱。類型：字串必要：是 ** DimensionMappings ** 這是為了允許將查詢結果中的資料行映射至目的地資料表中的維度。類型：[DimensionMapping](API_query_DimensionMapping.md) 物件陣列必要：是 ** TableName ** 要將查詢結果寫入其中的 Timestream 資料表名稱。該資料表應該在 Timestream 組態提供的相同資料庫中。類型：字串必要：是 ** TimeColumn ** 來自查詢結果的資料行，應該用作目的地資料表中的時間資料行。其資料行類型應該是 TIMESTAMP。類型：字串必要：是 ** MeasureNameColumn ** 度量資料行的名稱。類型：字串必要：否 ** MixedMeasureMappings ** 指定如何將度量映射至多重度量記錄。類型：[MixedMeasureMapping](API_query_MixedMeasureMapping.md) 物件陣列陣列成員：項目數下限為 1。必要：否 ** MultiMeasureMappings ** 多重度量映射。類型：[MultiMeasureMappings](API_query_MultiMeasureMappings.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) # TimestreamDestination 排程查詢的目的地。 ## 目錄 ** DatabaseName ** Timestream 資料庫名稱。類型：字串必要：否 ** TableName ** 時間串流資料表名稱。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamDestination) # Type 包含查詢結果集中資料欄的資料類型。資料類型可以是純量或複雜。支援的純量資料類型為整數、布林值、字串、雙、時間戳記、日期、時間和間隔。支援的複雜資料類型為陣列、資料列和時間記錄。 ## 目錄 ** ArrayColumnInfo ** 指示資料欄是否為陣列。類型：[ColumnInfo](API_query_ColumnInfo.md) 物件必要：否 ** RowColumnInfo ** 指示資料欄是否為資料列。類型：[ColumnInfo](API_query_ColumnInfo.md) 物件陣列必要：否 ** ScalarType ** 指示資料欄是否為類型字串、整數、布林值、雙、時間戳記、日期、時間。如需詳細資訊，請參閱[支援的資料類型](https://docs.aws.amazon.com/timestream/latest/developerguide/supported-data-types.html)。類型：字串有效值:`VARCHAR | BOOLEAN | BIGINT | DOUBLE | TIMESTAMP | DATE | TIME | INTERVAL_DAY_TO_SECOND | INTERVAL_YEAR_TO_MONTH | UNKNOWN | INTEGER` 必要：否 ** TimeSeriesMeasureValueColumnInfo ** 指示資料欄是否為 timeseries 資料類型。類型：[ColumnInfo](API_query_ColumnInfo.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type) # 常見錯誤本節列出所有 AWS 服務的 API 動作常見的錯誤。如需此服務之 API 動作的特定錯誤，請參閱該 API 動作的主題。 **AccessDeniedException** 您沒有足夠存取權可執行此動作。 HTTP 狀態碼：400 **IncompleteSignature** 請求簽章不符合 AWS 標準。 HTTP 狀態碼：400 **InternalFailure** 由於不明的錯誤、例外狀況或故障，處理請求失敗。 HTTP 狀態碼：500 **InvalidAction** 請求的動作或操作無效。確認已正確輸入動作。 HTTP 狀態碼：400 **InvalidClientTokenId** 提供的 X.509 憑證或 AWS 存取金鑰 ID 不存在於我們的記錄中。 HTTP 狀態碼：403 **NotAuthorized** 您沒有執行此動作的許可。 HTTP 狀態碼：400 **OptInRequired** AWS 存取金鑰 ID 需要訂閱服務。 HTTP 狀態碼：403 **RequestExpired** 請求送達服務已超過戳印日期於請求上之後的 15 分鐘，或者已超過請求過期日期之後的 15 分鐘 (例如預先簽章的 URL)，或者請求上的日期戳印在未來將超過 15 分鐘。 HTTP 狀態碼：400 **ServiceUnavailable** 由於伺服器暫時故障，請求失敗。 HTTP 狀態碼：503 **ThrottlingException** 由於請求調節，因此請求遭到拒絕。 HTTP 狀態碼：400 **ValidationError** 輸入無法滿足 AWS 服務指定的限制條件。 HTTP 狀態碼：400 # 常見參數以下清單內含所有動作用來簽署 Signature 第 4 版請求的參數以及查詢字串。任何專屬於特定動作的參數則列於該動作的主題中。如需 Signature 第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。 **Action** 要執行的動作。類型：字串必要：是 **Version** 編寫請求所憑藉的 API 版本，以 YYYY-MM-DD 格式表示。類型：字串必要：是 **X-Amz-Algorithm** 建立請求簽章時所使用的雜湊演算法。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串有效值:`AWS4-HMAC-SHA256` 必要：有條件 **X-Amz-Credential** 憑證範圍值，此為一個字串，其中包含您的存取金鑰、日期、您的目標區域、您請求的服務，以及終止字串 (“aws4\$1request”)。值以下列格式表示：*access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[建立簽署的 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串必要：有條件 **X-Amz-Date** 用來建立簽署的日期。格式必須是 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如，以下日期時間是有效的 X-Amz-Date 值：`20120325T120000Z` 條件：對所有請求而言，X-Amz-Date 皆為選用，可用來覆寫用於簽署請求的日期。如果規定日期標頭採用 ISO 8601 基本格式，則不需要 X-Amz-Date。當使用 X-Amz-Date 時，其一律會覆寫日期標頭的值。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [AWS API 請求簽章元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)。類型：字串必要：有條件 **X-Amz-Security-Token** 透過呼叫 AWS Security Token Service () 取得的臨時安全字符AWS STS。如需支援 AWS STS的臨時安全憑證的服務清單，請參閱《IAM 使用者指南》**中的[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。條件：如果您使用來自的臨時安全登入資料 AWS STS，則必須包含安全字符。類型：字串必要：有條件 **X-Amz-Signature** 指定從要簽署的字串和衍生的簽署金鑰中計算出的十六進位編碼簽章。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串必要：有條件 **X-Amz-SignedHeaders** 指定納入作為標準請求一部分的所有 HTTP 標頭。如需指定簽章標頭的詳細資訊，請參閱《*IAM 使用者指南*》中的[建立簽章 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串必要：有條件