本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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,請參閱下列內容: