Record - Amazon Timestream

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Record

代表寫入 Timestream 的時間序列資料點。每個記錄都包含維度陣列。維度代表時間序列資料點的中繼資料屬性,例如執行個體名稱或EC2執行個體的可用區域。記錄也包含量值名稱,即收集的量值名稱 (例如,EC2執行個體的使用CPU率)。此外,記錄包含測量值和值類型,這是測量值的資料類型。此外,記錄包含收集量值時的時間戳記,以及時間戳記單位,其代表時間戳記的精細度。

記錄有一個Version欄位,這是 64 位元long,可用來更新資料點。只有在寫入請求中記錄的Version屬性高於現有記錄時,才會寫入具有相同維度、時間戳記和量值名稱但不同量值的重複記錄。對於沒有 Version 欄位的記錄,時間串流預設為 Version 1的 。

目錄

Dimensions

包含時間序列資料點的維度清單。

類型:Dimension 物件陣列

陣列成員:最多 128 個項目。

必要:否

MeasureName

Measure 代表時間序列的資料屬性。例如,EC2執行個體的CPU利用率或風力發電機RPM的 是指標。

類型:字串

長度限制:長度下限為 1。長度上限為 256。

必要:否

MeasureValue

包含時間序列資料點的測量值。

類型:字串

長度限制:長度下限為 1。長度上限為 2048。

必要:否

MeasureValues

包含時間序列資料點 MeasureValue 的 清單。

這僅適用於類型 MULTI。對於純量值,請直接使用記錄的MeasureValue屬性。

類型:MeasureValue 物件陣列

必要:否

MeasureValueType

包含時間序列資料點的測量值資料類型。預設類型為 DOUBLE。如需詳細資訊,請參閱資料類型

類型:字串

有效值: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

必要:否

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: