

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击[此处](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)了解更多信息。

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

# Record
<a name="API_Record"></a>

表示将写入 Timestream 的时间序列数据点。每条记录均包含维度数组。维度表示时间序列数据点的元数据属性，例如 EC2 实例的实例名称或可用区。记录还包含度量名称，即正在收集的度量名称（例如，EC2 实例的 CPU 利用率）。此外，记录还包含度量值及值类型，即度量值的数据类型。此外，记录包含收集度量的时间戳及时间戳单位，后者表示时间戳的粒度。

 记录包含 `Version` 字段，该字段是 64 位 `long`，可用于更新数据点。写入具有相同维度、时间戳和度量名称但度量值不同的重复记录时，仅当写入请求中记录的 `Version` 属性高于现有记录时才会成功。对于没有 `Version` 字段的记录，Timestream 默认使用 `1` 的 `Version`。

## 内容
<a name="API_Record_Contents"></a>

 ** Dimensions **   <a name="timestream-Type-Record-Dimensions"></a>
包含时间序列数据点的维度列表。  
类型：[Dimension](API_Dimension.md) 对象数组  
数组成员：最多 128 项。  
必需：否

 ** MeasureName **   <a name="timestream-Type-Record-MeasureName"></a>
度量表示时间序列的数据属性。例如，EC2 实例的 CPU 利用率或风力涡轮机的 RPM 都是度量。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

 ** MeasureValue **   <a name="timestream-Type-Record-MeasureValue"></a>
 包含时间序列数据点的度量值。  
类型：字符串  
长度限制：最小长度为 0。最大长度为 2048。  
必需：否

 ** MeasureValues **   <a name="timestream-Type-Record-MeasureValues"></a>
 包含时间序列数据的 MeasureValue 列表。  
 这仅限于类型 `MULTI`。对于标量值，直接使用记录的 `MeasureValue` 属性。  
类型：[MeasureValue](API_MeasureValue.md) 对象数组  
必需：否

 ** MeasureValueType **   <a name="timestream-Type-Record-MeasureValueType"></a>
 包含时间序列数据点的度量值数据类型。默认类型为 `DOUBLE`。有关更多信息，请参阅[数据类型](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)。  
类型：字符串  
有效值：`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI`  
必需：否

 ** Time **   <a name="timestream-Type-Record-Time"></a>
 包含收集数据点度量值的时间。时间值加上单位即为自 epoch 以来经过的时间。例如，如果时间值为 `12345`，单位为 `ms`，则自 epoch 以来已经过 `12345 ms`。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 256。  
必需：否

 ** TimeUnit **   <a name="timestream-Type-Record-TimeUnit"></a>
 时间戳单位的粒度。这指示时间值的单位是秒、毫秒、纳秒还是其他支持的值。默认值为 `MILLISECONDS`。  
类型：字符串  
有效值：`MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS`  
必需：否

 ** Version **   <a name="timestream-Type-Record-Version"></a>
用于更新记录的 64 位属性。具有更高版本号的重复数据写入请求将更新现有度量值和版本。如果度量值相同，`Version` 仍会进行更新。默认值为 `1`。  
 `Version` 必须等于或大于 `1`，否则将收到 `ValidationException` 错误。
类型：长整型  
必需：否

## 另请参阅
<a name="API_Record_SeeAlso"></a>

有关在特定语言的 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) 