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

Timestream

Timestream ルールアクションは、MQTTメッセージから Amazon Timestream テーブルに属性 (メジャー) を書き込みます。Amazon Timestream の詳細については、Amazon Timestream とはを参照してください。

このルールが Timestream データベースに保存する属性は、ルールのクエリステートメントから得られた属性です。クエリステートメントの結果の各属性の値は、そのデータタイプを (DynamoDBv2 アクションにおけるのと同様に) 推測するために解析されます。各属性の値は、Timestream テーブルの独自のレコードに書き込まれます。属性のデータ型を指定または変更するには、クエリステートメントでcast()関数を使用します。各 Timestream レコードの内容の詳細については、「Timestream レコードコンテンツ」を参照してください。

要件

このルールアクションには、以下の要件があります。

パラメータ

このアクションで AWS IoT ルールを作成するときは、次の情報を指定する必要があります。

Timestream レコードコンテンツ

このアクションによって Amazon Timestream テーブルに書き込まれるデータには、タイムスタンプ、Timestream ルールアクションからのメタデータ、およびルールのクエリステートメントの結果が含まれます。

クエリステートメントの結果の各属性 (メジャー) について、このルールアクションは、これらの列を持つ指定された Timestream テーブルにレコードを書き込みます。

* メッセージペイロードから読み取られた属性値は以下のように解釈されます。これらの各ケースの図については、「例」を参照してください。

例

次のJSON例では、 ルールで置換テンプレートを使用して Timestream AWS IoT ルールアクションを定義します。

{
  "topicRulePayload": {
    "sql": "SELECT * FROM 'iot/topic'",
    "ruleDisabled": false,
    "awsIotSqlVersion": "2016-03-23",
    "actions": [
      {
        "timestream": {
          "roleArn": "arn:aws:iam::123456789012:role/aws_iot_timestream",
          "tableName": "devices_metrics",
          "dimensions": [
            {
              "name": "device_id",
              "value": "${clientId()}"
            },
            {
              "name": "device_firmware_sku",
              "value": "My Static Metadata"
            }
          ],
          "databaseName": "record_devices"
        }
      }
    ]
  }
}

前の例で定義された Timestream トピックルールアクションを次のメッセージペイロードで使用すると、Amazon Timestream レコードが次の表に書き込まれます。

{
  "boolean_value": true,
  "integer_value": 123456789012,
  "double_value": 123.456789012,
  "string_value": "String value",
  "boolean_value_as_string": "true",
  "integer_value_as_string": "123456789012",
  "double_value_as_string": "123.456789012",
  "array_of_integers": [23,36,56,72],
  "array of strings": ["red", "green","blue"],
  "complex_value": {
    "simple_element": 42,
    "array_of_integers": [23,36,56,72],
    "array of strings": ["red", "green","blue"]
  }
}

次の表は、指定されたトピックルールアクションを使用して以前のメッセージペイロードが作成したものの処理を行うデータベースの列とレコードを示しています。列device_firmware_skuと device_id列は、トピックルールアクションでDIMENSIONS定義されている です。Timestream トピックルールアクションは、time 列と measure_name および measure_value::* 列を作成し、トピックルールアクションのクエリステートメントの結果からの値を入力します。