如需與 Amazon Timestream for LiveAnalytics 類似的功能，請考慮使用 Amazon Timestream for InfluxDB。它提供簡化的資料擷取和單一位數毫秒查詢回應時間，以進行即時分析。[在這裡](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` 欄位的記錄，時間串流預設為 `Version` `1`的 。

## 目錄
<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>
Measure 代表時間序列的資料屬性。例如，EC2 執行個體的 CPU 使用率或風力渦輪機的 RPM 是測量方式。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

 ** MeasureValue **   <a name="timestream-Type-Record-MeasureValue"></a>
 包含時間序列資料點的測量值。  
類型：字串  
長度限制：長度下限為 1。長度上限為 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`錯誤。
類型：Long  
必要：否

## 另請參閱
<a name="API_Record_SeeAlso"></a>

如需在其中一種語言特定 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)