要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击[此处](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)了解更多信息。本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 数据类型 Amazon Timestream 写入支持以下数据类型： + [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 查询支持以下数据类型： + [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 写入支持以下数据类型： + [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 ** 类型：长整型必需：否 ** FileFailures ** 类型：长整型必需：否 ** ParseFailures ** 类型：长整型必需：否 ** RecordIngestionFailures ** 类型：长整型必需：否 ** RecordsIngested ** 类型：长整型必需：否 ** RecordsProcessed ** 类型：长整型必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) # BatchLoadTask 批量加载任务的详细信息。 ## 内容 ** CreationTime ** 创建 Timestream 批量加载任务的时间。类型：时间戳必需：否 ** DatabaseName ** 批量加载任务将数据加载到其中的数据库名称。类型：字符串必需：否 ** LastUpdatedTime ** 上次更新 Timestream 批量加载任务的时间。类型：时间戳必需：否 ** ResumableUntil ** 类型：时间戳必需：否 ** TableName ** 批量加载任务将数据加载到其中的表名称。类型：字符串必需：否 ** TaskId ** 批量加载任务的 ID。类型：字符串长度约束：最小长度为 3。最大长度为 32。模式：`[A-Z0-9]+` 必需：否 ** TaskStatus ** 批量加载任务的状态。类型：字符串有效值：`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) # BatchLoadTaskDescription 批量加载任务的详细信息。 ## 内容 ** CreationTime ** 创建 Timestream 批量加载任务的时间。类型：时间戳必需：否 ** DataModelConfiguration ** 批量加载任务的数据模型配置。这包含有关批量加载任务数据模型存储位置的详细信息。类型：[DataModelConfiguration](API_DataModelConfiguration.md) 对象必需：否 ** DataSourceConfiguration ** 批量加载任务数据来源的配置详细信息。类型：[DataSourceConfiguration](API_DataSourceConfiguration.md) 对象必需：否 ** ErrorMessage ** 类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** LastUpdatedTime ** 上次更新 Timestream 批量加载任务的时间。类型：时间戳必需：否 ** ProgressReport ** 类型：[BatchLoadProgressReport](API_BatchLoadProgressReport.md) 对象必需：否 ** RecordVersion ** 类型：长整型必需：否 ** ReportConfiguration ** 批量加载任务的报告配置。这包含有关错误报告存储位置的详细信息。类型：[ReportConfiguration](API_ReportConfiguration.md) 对象必需：否 ** ResumableUntil ** 类型：时间戳必需：否 ** TargetDatabaseName ** 类型：字符串必需：否 ** TargetTableName ** 类型：字符串必需：否 ** TaskId ** 批量加载任务的 ID。类型：字符串长度约束：最小长度为 3。最大长度为 32。模式：`[A-Z0-9]+` 必需：否 ** TaskStatus ** 批量加载任务的状态。类型：字符串有效值：`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) # CsvConfiguration 一种分隔的数据格式，其中列分隔符可以是逗号，记录分隔符是换行符。 ## 内容 ** ColumnSeparator ** 列分隔符可以是逗号（“,”）、竖线（“\$1”）、分号（“;”）、制表符（“/t”）或空格（“ ”）其中之一。类型：字符串长度限制：固定长度为 1。必需：否 ** EscapeChar ** 转义字符可以是以下其中之一类型：字符串长度限制：固定长度为 1。必需：否 ** NullValue ** 可以是空格（“ ”）。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ** QuoteChar ** 可以是单引号（'），也可以是双引号（"）。类型：字符串长度限制：固定长度为 1。必需：否 ** TrimWhiteSpace ** 指定剪裁前导和尾随空格。类型：布尔值必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) # Database 表的顶级容器。数据库和表是 Amazon Timestream 中的基本管理概念。数据库中的所有表都使用相同的 AWS KMS 密钥进行加密。 ## 内容 ** Arn ** 唯一标识此数据库的 Amazon 资源名称。类型：字符串必需：否 ** CreationTime ** 创建数据库的时间，从 Unix epoch 时间开始计算。类型：时间戳必需：否 ** DatabaseName ** Timestream 数据库的名称。类型：字符串长度约束：最小长度为 3。长度上限为 256。必需：否 ** KmsKeyId ** 用于加密存储在数据库中的数据的 AWS KMS 密钥的标识符。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** LastUpdatedTime ** 上次更新此数据库的时间。类型：时间戳必需：否 ** TableCount ** 在 Timestream 数据库中查找到的表总数。类型：长整型必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) # Dimension 表示时间序列的元数据属性。例如，EC2 实例的名称和可用区或风力涡轮机制造商的名称都是维度。 ## 内容 ** Name ** 维度表示时间序列的元数据属性。例如，EC2 实例的名称和可用区或风力涡轮机制造商的名称都是维度。有关维度名称的限制，请参阅[命名约束](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)。类型：字符串长度限制：长度下限为 1。最大长度为 60。必需：是 ** Value ** 维度的值。类型：字符串必需：是 ** DimensionValueType ** 时间序列数据点的维度数据类型。类型：字符串有效值：`VARCHAR` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) # DimensionMapping ## 内容 ** DestinationColumn ** 类型：字符串长度限制：长度下限为 1。必需：否 ** SourceColumn ** 类型：字符串长度限制：长度下限为 1。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) # Endpoint 表示可发出 API 调用的可用端点，以及该端点的 TTL。 ## 内容 ** Address ** 端点地址。类型：字符串必需：是 ** CachePeriodInMinutes ** 端点的 TTL（以分钟为单位）。类型：长整型必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) # MagneticStoreRejectedDataLocation 在磁存储写入期间，为异步拒绝的记录写入错误报告的位置。 ## 内容 ** S3Configuration ** 配置 S3 位置在磁存储写入期间，为异步拒绝的记录写入错误报告。类型：[S3Configuration](API_S3Configuration.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) # MagneticStoreWriteProperties 表上用于配置磁存储写入的一组属性。 ## 内容 ** EnableMagneticStoreWrites ** 启用磁性存储写入的标志。类型：布尔值必需：是 ** MagneticStoreRejectedDataLocation ** 在磁存储写入期间，为异步拒绝的记录写入错误报告的位置。类型：[MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [适用于 Ruby V3 的 AWS 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)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings ## 内容 ** MultiMeasureAttributeMappings ** 类型：[MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) 对象数组数组成员：最少 1 个物品。必需：是 ** TargetMultiMeasureName ** 类型：字符串长度限制：长度下限为 1。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) + [适用于 Ruby V3 的 AWS 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（无需指定维度键）。类型：字符串有效值：`REQUIRED | OPTIONAL` 必需：否 ** Name ** 维度键所使用属性的名称。类型：字符串长度限制：长度下限为 1。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) # Record 表示将写入 Timestream 的时间序列数据点。每条记录均包含维度数组。维度表示时间序列数据点的元数据属性，例如 EC2 实例的实例名称或可用区。记录还包含度量名称，即正在收集的度量名称（例如，EC2 实例的 CPU 利用率）。此外，记录还包含度量值及值类型，即度量值的数据类型。此外，记录包含收集度量的时间戳及时间戳单位，后者表示时间戳的粒度。记录包含 `Version` 字段，该字段是 64 位 `long`，可用于更新数据点。写入具有相同维度、时间戳和度量名称但度量值不同的重复记录时，仅当写入请求中记录的 `Version` 属性高于现有记录时才会成功。对于没有 `Version` 字段的记录，Timestream 默认使用 `1` 的 `Version`。 ## 内容 ** Dimensions ** 包含时间序列数据点的维度列表。类型：[Dimension](API_Dimension.md) 对象数组数组成员：最多 128 项。必需：否 ** MeasureName ** 度量表示时间序列的数据属性。例如，EC2 实例的 CPU 利用率或风力涡轮机的 RPM 都是度量。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ** MeasureValue ** 包含时间序列数据点的度量值。类型：字符串长度限制：最小长度为 0。最大长度为 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` 错误。类型：长整型必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) # RecordsIngested 有关此请求所摄取记录的信息。 ## 内容 ** MagneticStore ** 摄取到磁性存储的记录计数。类型：整数必需：否 ** MemoryStore ** 摄取到内存存储的记录计数。类型：整数必需：否 ** Total ** 成功摄取的记录总计数。类型：整数必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) # RejectedRecord 表示因数据验证问题未能成功插入 Timestream 的记录，必须解决这些问题后才能将时间序列数据重新插入系统。 ## 内容 ** ExistingVersion ** 记录的现有版本。如果存在版本号高于写入请求版本号的相同记录，则会填充此值。类型：长整型必需：否 ** 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) # ReportConfiguration 批量加载任务的报告配置。这包含有关错误报告存储位置的详细信息。 ## 内容 ** ReportS3Configuration ** 配置 S3 位置，用于写入批量加载的错误报告和事件。类型：[ReportS3Configuration](API_ReportS3Configuration.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) + [适用于 Ruby V3 的 AWS 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 ** 类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** ObjectKeyPrefix ** 类型：字符串长度限制：长度下限为 1。最大长度为 928。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) # RetentionProperties 保留属性包含您的时间序列数据必须存储在磁存储和内存存储中的持续时间。 ## 内容 ** MagneticStoreRetentionPeriodInDays ** 数据必须存储在磁存储中的持续时间。类型：长整型有效范围：最小值为 1。最大值为 73000。必需：是 ** MemoryStoreRetentionPeriodInHours ** 数据必须存储在内存存储中的持续时间。类型：长整型有效范围：最小值为 1。最大值为 8766。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) + [适用于 Ruby V3 的 AWS 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 托管密钥加密时客户 S3 位置的 AWS KMS 密钥 ID。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** ObjectKeyPrefix ** 客户 S3 位置的对象键预览。类型：字符串长度限制：长度下限为 1。最大长度为 928。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) # Schema 架构指定表的预期数据模型。 ## 内容 ** CompositePartitionKey ** 非空的分区键列表，定义用于对表数据进行分区的属性。列表的顺序决定分区层次结构。创建表后，每个分区键的名称、类型以及分区键顺序均不可更改。然而，可更改每个分区键的强制级别。类型：[PartitionKey](API_PartitionKey.md) 对象数组数组成员：最少 1 个物品。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) # Table 表示 Timestream 中的数据库表。表包含一个或多个相关的时间序列。可以修改表的内存存储和磁性存储的保留持续时间。 ## 内容 ** Arn ** 唯一标识此表的 Amazon 资源名称。类型：字符串必需：否 ** CreationTime ** Timestream 表创建的时间。类型：时间戳必需：否 ** DatabaseName ** 包含此表的 Timestream 数据库的名称。类型：字符串长度约束：最小长度为 3。长度上限为 256。必需：否 ** LastUpdatedTime ** 上次更新 Timestream 表的时间。类型：时间戳必需：否 ** 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) # Tag 标签是指为 Timestream 数据库和/或表分配的标识。每个标签都包含定义的一个键和一个可选值。使用标签，可按用途、所有者或环境对数据库和/或表进行分类。 ## 内容 ** Key ** 标签的密钥。标签键区分大小写。类型：字符串长度限制：长度下限为 1。最大长度为 128。必需：是 ** Value ** 标签的值。标签值区分大小写，可以为 null。类型：字符串长度约束：最小长度为 0。最大长度为 256。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) # Amazon Timestream 查询 Amazon Timestream 查询支持以下数据类型： + [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 资源名称（ARN）。仅当更新账户设置时提供 SNS 主题的情况下，此字段才会显示。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：是 ** SnsConfiguration ** 发送通知所需的 SNS 的详细信息。类型：[SnsConfiguration](API_query_SnsConfiguration.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) # ColumnInfo 包含查询结果的元数据，例如列名称、数据类型以及其他属性。 ## 内容 ** Type ** 结果集列的数据类型。数据类型可以是标量，也可以是复数。标量数据类型包括整数、字符串、双精度、布尔值及其他类型。复数数据类型包括数组、行及其他类型。类型：[Type](API_query_Type.md) 对象必需：是 ** Name ** 结果集列的名称。除数组外，所有数据类型的列均可使用结果集的名称。类型：字符串必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) # Datum Datum 表示查询结果中的单个数据点。 ## 内容 ** ArrayValue ** 指示数据点是否为数组。类型：[Datum](#API_query_Datum) 对象数组必需：否 ** NullValue ** 指示数据点是否为 null。类型：布尔值必需：否 ** RowValue ** 指示数据点是否为行。类型：[Row](API_query_Row.md) 对象必需：否 ** ScalarValue ** 指示数据点是否为标量值，例如整数、字符串、双精度或布尔值。类型：字符串必需：否 ** TimeSeriesValue ** 指示数据点是否为时间序列数据类型。类型：[TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) 对象数组必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) # DimensionMapping 此类型用于将查询结果中的列映射到目标表中的维度。 ## 内容 ** DimensionValueType ** 维度的类型。类型：字符串有效值：`VARCHAR` 必需：是 ** Name ** 查询结果中的列名。类型：字符串必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) # Endpoint 表示可发出 API 调用的可用端点，以及该端点的 TTL。 ## 内容 ** Address ** 端点地址。类型：字符串必需：是 ** CachePeriodInMinutes ** 端点的 TTL（以分钟为单位）。类型：长整型必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) # ErrorReportConfiguration 错误报告所需的配置。 ## 内容 ** S3Configuration ** 错误报告的 S3 配置。类型：[S3Configuration](API_query_S3Configuration.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) # ErrorReportLocation 这包含针对单个计划查询调用的错误报告位置。 ## 内容 ** S3ReportLocation ** 用于写入错误报告的 S3 位置。类型：[S3ReportLocation](API_query_S3ReportLocation.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) # ExecutionStats 单个计划查询运行的统计数据。 ## 内容 ** BytesMetered ** 单个计划查询运行计量的字节数。类型：长整型必需：否 ** CumulativeBytesScanned ** 单个计划查询运行扫描的字节数。类型：长整型必需：否 ** DataWrites ** 按单个计划查询运行中摄取记录计量的数据写入量。类型：长整型必需：否 ** ExecutionTimeInMillis ** 完成计划查询运行所需的总时间，以毫秒为单位。类型：长整型必需：否 ** QueryResultRows ** 将查询摄取到目标数据来源之前，运行查询所产生输出中显示的行数。类型：长整型必需：否 ** RecordsIngested ** 单个计划查询运行摄取的记录数。类型：长整型必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) + [适用于 Ruby V3 的 AWS 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 计算单位（TCU）数量。类型：整数必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) # MixedMeasureMapping MixedMeasureMappings 是可用于将数据提取到派生表中的窄度量和多度量混合中的映射。 ## 内容 ** 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 ** 要使用的目标度量名称。如果未提供，则目标度量名称默认为 measure-name（如果提供），否则为 sourceColumn。类型：字符串必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) # ParameterMapping 命名参数的映射。 ## 内容 ** Name ** 参数名称。类型：字符串必需：是 ** Type ** 包含查询结果集中列的数据类型。数据类型可以是标量，也可以是复数。支持的标量数据类型包括整数、布尔值、字符串、双精度、时间戳、日期、时间和间隔。支持的复数数据类型包括数组、行和时间序列。类型：[Type](API_query_Type.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) # ProvisionedCapacityRequest 用于更新查询数据预置容量设置的请求。 ## 内容 ** TargetQueryTCU ** 用于查询数据的目标计算能力，以 Timestream 计算单元（TCU）为单位进行指定。类型：整数必需：是 ** NotificationConfiguration ** 已预置容量更新相关通知的配置设置。类型：[AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) # ProvisionedCapacityResponse 对更新查询数据预置容量设置请求的响应。 ## 内容 ** ActiveQueryTCU ** 账户中预置的 Timestream 计算单位（TCU）数量。仅当计算模式为 `PROVISIONED` 时，此字段才显示。类型：整数必需：否 ** LastUpdate ** 有关预置容量设置上次更新的信息。类型：[LastUpdate](API_query_LastUpdate.md) 对象必需：否 ** NotificationConfiguration ** 包含通知设置的对象，当预置容量设置发生修改时，该对象会发送通知。仅当计算模式为 `PROVISIONED` 时，此字段才显示。类型：[AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) # QueryComputeRequest 用于检索或更新查询数据计算容量设置的请求。QueryCompute 仅在亚太地区（孟买）区域提供。 ## 内容 ** ComputeMode ** 在账户内分配和使用 Timestream 计算单位（TCU）的模式。请注意，在亚太地区（孟买）区域，API 操作仅识别 `PROVISIONED` 值。QueryCompute 仅在亚太地区（孟买）区域提供。类型：字符串有效值：`ON_DEMAND | PROVISIONED` 必需：否 ** ProvisionedCapacity ** 包含账户中预置 Timestream 计算单位（TCU）设置的配置对象。QueryCompute 仅在亚太地区（孟买）区域提供。类型：[ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) # QueryComputeResponse 对检索或更新计算数据预置容量设置请求的响应。QueryCompute 仅在亚太地区（孟买）区域提供。 ## 内容 ** ComputeMode ** 在账户内分配和使用 Timestream 计算单位（TCU）的模式。请注意，在亚太地区（孟买）区域，API 操作仅识别 `PROVISIONED` 值。QueryCompute 仅在亚太地区（孟买）区域提供。类型：字符串有效值：`ON_DEMAND | PROVISIONED` 必需：否 ** ProvisionedCapacity ** 包含账户中预置 Timestream 计算单位（TCU）设置的配置对象。QueryCompute 仅在亚太地区（孟买）区域提供。类型：[ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) # QueryInsightsResponse 提供与所执行查询相关的多种见解和指标。 ## 内容 ** OutputBytes ** 表示查询结果集的大小（以字节为单位）。作为查询调优练习的一部分，您可以使用这些数据验证结果集是否已发生更改。类型：长整型必需：否 ** OutputRows ** 表示作为查询结果集一部分返回的总行数。作为查询调优练习的一部分，您可以使用这些数据验证结果集中的行数是否已发生更改。类型：长整型必需：否 ** QuerySpatialCoverage ** 提供有关查询空间覆盖范围的见解，包括具有次优（最大）空间修剪的表。这些信息可帮助您识别分区策略中需要改进的领域，从而增强空间剪枝效果。类型：[QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 对象必需：否 ** QueryTableCount ** 表示查询中的表数量。类型：长整型必需：否 ** QueryTemporalRange ** 提供有关查询时间范围的见解，包括具有最长（最大）时间范围的表。以下是一些可行方案，用于优化基于时间的修剪： + 添加缺失的时间谓词。 + 移除时间谓词周围的函数。 + 向所有子查询添加时间谓词。类型：[QueryTemporalRange](API_query_QueryTemporalRange.md) 对象必需：否 ** UnloadPartitionCount ** 表示 `Unload` 操作创建的分区。类型：长整型必需：否 ** UnloadWrittenBytes ** 表示 `Unload` 操作写入的大小（以字节为单位）。类型：长整型必需：否 ** UnloadWrittenRows ** 表示 `Unload` 查询写入的行。类型：长整型必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) + [适用于 Ruby V3 的 AWS 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 资源名称（ARN）。 + `PartitionKey`：用于分区的分区键，可以是默认 `measure_name`，也可以是 CDPK。类型：[QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) + [适用于 Ruby V3 的 AWS 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 资源名称（ARN）。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** Value ** 空间覆盖的最大比率。类型：双精度必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) # QueryStatus 有关查询状态的信息，包括进度和已扫描的字节数。 ## 内容 ** CumulativeBytesMetered ** 查询已扫描的数据量（以字节为单位），您将为此支付费用。这是累积总和，表示自查询开始以来您需要支付费用的总数据量。该费用仅收取一次，在查询完成运行时或者在查询被取消时收取。类型：长整型必需：否 ** CumulativeBytesScanned ** 查询已扫描的数据量（以字节为单位）。这是累积总和，表示自查询开始以来扫描的总字节数。类型：长整型必需：否 ** ProgressPercentage ** 查询进度，以百分比表示。类型：双精度必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) # QueryTemporalRange 提供有关查询时间范围的见解，包括具有最长（最大）时间范围的表。 ## 内容 ** Max ** 封装以下属性，这些属性可深入了解时间轴上表现最差的表： + `Value`：查询开始和结束之间的最大持续时长（以纳秒为单位）。 + `TableArn`：查询时使用最大时间范围的表的 Amazon 资源名称（ARN）。类型：[QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) # QueryTemporalRangeMax 通过查询扫描到的最次优时间修剪，提供对表的见解。 ## 内容 ** TableArn ** 查询时使用最大时间范围的表的 Amazon 资源名称（ARN）。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** Value ** 查询开始和结束之间的最大持续时长（以纳秒为单位）。类型：长整型必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) # Row 代表查询结果中的一行。 ## 内容 ** Data ** 结果集单行中的数据点列表。类型：[Datum](API_query_Datum.md) 对象数组必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) # ScheduleConfiguration 查询计划的配置。 ## 内容 ** ScheduleExpression ** 表示何时触发计划查询运行的表达式。此项可以是 cron 表达式或 rate 表达式。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) # ScheduledQuery 计划查询 ## 内容 ** Arn ** Amazon 资源名称（ARN）。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：是 ** Name ** 计划查询的名称。类型：字符串长度限制：长度下限为 1。长度上限为 64。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必需：是 ** State ** 计划查询的状态。类型：字符串有效值：`ENABLED | DISABLED` 必需：是 ** CreationTime ** 计划查询的创建时间。类型：时间戳必需：否 ** ErrorReportConfiguration ** 计划查询错误报告的配置。类型：[ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 对象必需：否 ** LastRunStatus ** 上次计划查询运行的状态。类型：字符串有效值：`AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 必需：否 ** NextInvocationTime ** 计划查询下次运行的时间。类型：时间戳必需：否 ** PreviousInvocationTime ** 计划查询上次运行的时间。类型：时间戳必需：否 ** TargetDestination ** 最终写入计划查询结果的目标数据来源。类型：[TargetDestination](API_query_TargetDestination.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) # ScheduledQueryDescription 描述计划查询的结构。 ## 内容 ** Arn ** 计划查询 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 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 ** 计划查询的创建时间。类型：时间戳必需：否 ** ErrorReportConfiguration ** 计划查询的错误报告配置。类型：[ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 对象必需：否 ** KmsKeyId ** 客户提供的 KMS 密钥，用于加密计划查询资源。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** LastRunSummary ** 上次计划查询运行的运行时摘要。类型：[ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 对象必需：否 ** NextInvocationTime ** 计划查询下次计划运行的时间。类型：时间戳必需：否 ** PreviousInvocationTime ** 查询上次运行的时间。类型：时间戳必需：否 ** RecentlyFailedRuns ** 最近五次计划查询运行失败的运行时摘要。类型：[ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) 对象数组必需：否 ** ScheduledQueryExecutionRoleArn ** Timestream 用于运行计划查询的 IAM 角色。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：否 ** TargetConfiguration ** 计划查询目标存储配置。类型：[TargetConfiguration](API_query_TargetConfiguration.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) # ScheduledQueryInsights 封装用于在 `ExecuteScheduledQueryRequest` 上启用 `QueryInsights` 的设置。 ## 内容 ** Mode ** 提供以下模式以启用 `ScheduledQueryInsights`： + `ENABLED_WITH_RATE_CONTROL`：为正在处理的查询启用 `ScheduledQueryInsights`。此模式还包括速率控制机制，该机制将 `QueryInsights` 功能限制为每秒 1 次查询（QPS）。 + `DISABLED`：禁用 `ScheduledQueryInsights`。类型：字符串有效值：`ENABLED_WITH_RATE_CONTROL | DISABLED` 必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) # ScheduledQueryInsightsResponse 提供与已执行 `ExecuteScheduledQueryRequest` 相关的多种见解和指标。 ## 内容 ** OutputBytes ** 表示查询结果集的大小（以字节为单位）。作为查询调优练习的一部分，您可以使用这些数据验证结果集是否已发生更改。类型：长整型必需：否 ** OutputRows ** 表示作为查询结果集一部分返回的总行数。作为查询调优练习的一部分，您可以使用这些数据验证结果集中的行数是否已发生更改。类型：长整型必需：否 ** QuerySpatialCoverage ** 提供有关查询空间覆盖范围的见解，包括具有次优（最大）空间修剪的表。这些信息可帮助您识别分区策略中需要改进的领域，从而增强空间剪枝效果。类型：[QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) 对象必需：否 ** QueryTableCount ** 表示查询中的表数量。类型：长整型必需：否 ** QueryTemporalRange ** 提供有关查询时间范围的见解，包括具有最长（最大）时间范围的表。以下是一些可行方案，用于优化基于时间的修剪： + 添加缺失的时间谓词。 + 移除时间谓词周围的函数。 + 向所有子查询添加时间谓词。类型：[QueryTemporalRange](API_query_QueryTemporalRange.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [适用于 Ruby V3 的 AWS 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` 以获取值。类型：时间戳必需：否 ** QueryInsightsResponse ** 提供与计划查询运行摘要相关的多种见解和指标。类型：[ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) 对象必需：否 ** RunStatus ** 计划查询运行的状态。类型：字符串有效值：`AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 必需：否 ** TriggerTime ** 查询运行的实际时间。类型：时间戳必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) # SelectColumn 查询返回的列详细信息。 ## 内容 ** Aliased ** 如果查询给列名添加别名，则返回 true。否则返回 false。类型：布尔值必需：否 ** DatabaseName ** 包含此列的数据库。类型：字符串必需：否 ** Name ** 列的名称。类型：字符串必需：否 ** TableName ** 数据库中包含此列的表。类型：字符串必需：否 ** Type ** 包含查询结果集中列的数据类型。数据类型可以是标量，也可以是复数。支持的标量数据类型包括整数、布尔值、字符串、双精度、时间戳、日期、时间和间隔。支持的复数数据类型包括数组、行和时间序列。类型：[Type](API_query_Type.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) # SnsConfiguration 发送通知所需的 SNS 的详细信息。 ## 内容 ** TopicArn ** 计划查询状态通知将发送到的 SNS 主题 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) # Tag 标签是指为 Timestream 数据库和/或表分配的标识。每个标签都包含定义的一个键和一个可选值。标签允许按用途、所有者或环境等对数据库和/或表进行分类。 ## 内容 ** Key ** 标签的密钥。标签键区分大小写。类型：字符串长度限制：长度下限为 1。最大长度为 128。必需：是 ** Value ** 标签的值。标签值区分大小写，可以为空值。类型：字符串长度约束：最小长度为 0。最大长度为 256。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) # TargetConfiguration 用于写入查询输出的配置。 ## 内容 ** TimestreamConfiguration ** 将数据写入 Timestream 数据库和表所需的配置。类型：[TimestreamConfiguration](API_query_TimestreamConfiguration.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) # TargetDestination 为目标数据来源写入数据的目标详细信息。当前支持的数据来源为 Timestream。 ## 内容 ** TimestreamDestination ** Timestream 数据来源的查询结果目标详细信息。类型：[TimestreamDestination](API_query_TimestreamDestination.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) # TimeSeriesDataPoint 时间序列数据类型表示一段时间内的度量值。时间序列是由时间戳和度量值组成的行数组，其中各行按时间升序进行排列。TimeSeriesDataPoint 是时间序列中的单个数据点。表示时间序列中的元组（时间，度量值）。 ## 内容 ** Time ** 采集度量值的时间戳。类型：字符串必需：是 ** Value ** 数据点的度量值。类型：[Datum](API_query_Datum.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) + [适用于 Ruby V3 的 AWS 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 SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) # TimestreamDestination 计划查询的目标。 ## 内容 ** DatabaseName ** Timestream 数据库名称。类型：字符串必需：否 ** TableName ** Timestream 表名称。类型：字符串必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) + [适用于 Ruby V3 的 AWS 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 ** 指示列是否为时间序列数据类型。类型：[ColumnInfo](API_query_ColumnInfo.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type)