Record - Amazon Timestream

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Record

Timestream に書き込まれる時系列データポイントを表します。各レコードにはディメンションの配列が含まれています。ディメンションは、EC2 インスタンスのインスタンス名やアベイラビリティーゾーンなど、時系列データポイントのメタデータ属性を表します。レコードには、収集されるメジャーの名前であるメジャー名 (EC2 インスタンスの CPU 使用率など) も含まれます。さらに、レコードにはメジャー値と、メジャー値のデータ型である値型が含まれます。また、レコードには、メジャーが収集された時刻のタイムスタンプと、タイムスタンプの詳細度を表すタイムスタンプ単位が含まれます。

レコードには Version フィールドがあり、このフィールドはデータポイントの更新に使用できる 64 ビットの long です。ディメンション、タイムスタンプ、メジャー名が同じであるが、メジャー値が異なる重複レコードの書き込みは、書き込みリクエスト内のレコードの Version 属性が既存のレコードの属性よりも新しい場合にのみ成功します。Timestream は、Version フィールドのないレコードの場合、デフォルトで 1Version になります。

内容

Dimensions

時系列データポイントのディメンションのリストが含まれます。

型: Dimension オブジェクトの配列

配列メンバー: 最大数は 128 項目です。

必須: いいえ

MeasureName

メジャーは、時系列のデータ属性を表します。例えば、EC2 インスタンスの CPU 使用率や風力タービンの RPM がメジャーです。

型: 文字列

長さの制約: 最小長は 1 です。最大長は 256 です。

必須: いいえ

MeasureValue

時系列データポイントのメジャー値が含まれます。

型: 文字列

長さの制約: 最小長は 1 です。最大長は 2,048 です。

必須: いいえ

MeasureValues

時系列データポイントの MeasureValue のリストが含まれます。

これは MULTI 型でのみ許可されます。スカラー値の場合は、レコードの MeasureValue 属性を直接使用します。

型: MeasureValue オブジェクトの配列

必須: いいえ

MeasureValueType

時系列データポイントのメジャー値のデータ型が含まれます。デフォルトの型は DOUBLE です。詳細については、「データ型」を参照してください。

型: 文字列

有効な値:DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

必須: いいえ

Time

データポイントのメジャー値が収集された時刻が含まれます。時間値と単位は、エポックからの経過時間を示します。例えば、時間値が 12345 で、単位が ms の場合、エポックから 12345 ms が経過しています。

型: 文字列

長さの制約: 最小長は 1 です。最大長は 256 です。

必須: いいえ

TimeUnit

タイムスタンプ単位の詳細度。時間値が秒単位、ミリ秒単位、ナノ秒単位、またはその他のサポートされている値であるかどうかを示します。デフォルトは MILLISECONDS です。

型: 文字列

有効な値:MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

必須: いいえ

Version

レコードの更新に使用される 64 ビット属性。より大きなバージョン番号の重複データの書き込みリクエストは、既存のメジャー値とバージョンを更新します。メジャー値が同じ場合でも Version は更新されます。デフォルト値は 1 です。

注記

Version1 以降である必要があります。そうでない場合は ValidationException エラーが発生します。

型: 長整数

必須: いいえ

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。