Record - Amazon Timestream
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

从2025年6月20日起,亚马逊Timestream版 LiveAnalytics 将不再向新客户开放。如果您想使用亚马逊 Timestream LiveAnalytics,请在该日期之前注册。现有客户可以继续照常使用该服务。有关更多信息,请参阅 Amazon Timestream 以了解 LiveAnalytics 可用性变更。

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

Record

表示正在写入 Timestream 的时间序列数据点。每条记录都包含一个维度数组。维度表示时间序列数据点的元数据属性,例如实例名称或 EC2 实例的可用区。记录还包含度量名称,即正在收集的度量的名称(例如, EC2 实例的 CPU 使用率)。此外,记录还包含度量值和值类型,即测量值的数据类型。此外,该记录还包含收集度量的时间戳和时间戳单位,后者表示时间戳的粒度。

记录中有一个 64 位Version字段long,可用于更新数据点。只有在写入请求中记录的属性高于现有记录的Version属性时,才会成功写入具有相同维度、时间戳和度量名称但度量值不同的重复记录。1对于没有该Version字段Version的记录,时间流默认为 a of。

内容

Dimensions

包含时间序列数据点的维度列表。

类型:Dimension 对象数组

数组成员:最大数量为 128 项。

必需:否

MeasureName

度量表示时间序列的数据属性。例如, EC2 实例的 CPU 利用率或风力涡轮机的 RPM 就是衡量标准。

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:否

MeasureValue

包含时间序列数据点的度量值。

类型:字符串

长度限制:最小长度为 0。最大长度为 2048。

必需:否

MeasureValues

包含时间序列数据点 MeasureValue 的列表。

这仅允许用于类型MULTI。对于标量值,请直接使用记录的MeasureValue属性。

类型:MeasureValue 对象数组

必需:否

MeasureValueType

包含时间序列数据点的度量值的数据类型。默认类型为DOUBLE。有关更多信息,请参阅数据类型

类型:字符串

有效值:DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

必需:否

Time

包含收集数据点测量值的时间。时间值加上单位提供了自纪元以来经过的时间。例如,如果时间值为,单位为 12345ms,则自纪元以来12345 ms已经过去了。

类型:字符串

长度限制:最小长度为 1。最大长度为 256。

必需:否

TimeUnit

时间戳单位的粒度。它指示时间值是以秒、毫秒、纳秒还是其他支持的值为单位。默认值为 MILLISECONDS

类型:字符串

有效值:MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

必需:否

Version

用于更新记录的 64 位属性。对具有更高版本号的重复数据的写入请求将更新现有的度量值和版本。如果测量值相同,则仍Version会更新。默认值为 1

注意

Version必须等于1或更大,否则您将收到ValidationException错误消息。

类型:长整型

必需:否

另请参阅

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs,请参阅以下内容: