Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Timestream

Tindakan aturan Timestream menulis atribut (pengukuran) dari pesan MQTT ke tabel Amazon Timestream. Untuk informasi selengkapnya tentang Amazon Timestream, lihat Apa itu Amazon Timestream? .

Atribut yang disimpan aturan ini dalam database Timestream adalah atribut yang dihasilkan dari pernyataan kueri aturan. Nilai setiap atribut dalam hasil pernyataan query diuraikan untuk menyimpulkan tipe datanya (seperti dalam DynamoDBv2 tindakan). Setiap nilai atribut ditulis ke catatannya sendiri di tabel Timestream. Untuk menentukan atau mengubah tipe data atribut, gunakan cast() fungsi dalam pernyataan query. Untuk informasi selengkapnya tentang isi setiap catatan Timestream, lihat. Konten rekaman aliran waktu

Persyaratan

Tindakan aturan ini memiliki persyaratan sebagai berikut:

Parameter

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

Konten rekaman aliran waktu

Data yang ditulis ke tabel Amazon Timestream oleh tindakan ini mencakup stempel waktu, metadata dari tindakan aturan Timestream, dan hasil pernyataan kueri aturan.

Untuk setiap atribut (ukuran) dalam hasil pernyataan query, tindakan aturan ini menulis catatan ke tabel Timestream yang ditentukan dengan kolom ini.

* Nilai atribut yang dibaca dari payload pesan ditafsirkan sebagai berikut. Lihat Contoh untuk ilustrasi masing-masing kasus ini.

Contoh

Contoh JSON berikut mendefinisikan tindakan aturan Timestream dengan template substitusi dalam aturan. 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"
        }
      }
    ]
  }
}

Menggunakan tindakan aturan topik Timestream yang ditentukan dalam contoh sebelumnya dengan payload pesan berikut menghasilkan catatan Amazon Timestream yang ditulis dalam tabel berikut.

{
  "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"]
  }
}

Tabel berikut menampilkan kolom database dan rekaman yang menggunakan tindakan aturan topik yang ditentukan untuk memproses payload pesan sebelumnya dibuat. device_idKolom device_firmware_sku dan adalah DIMENSI yang didefinisikan dalam tindakan aturan topik. Tindakan aturan topik Timestream time membuat kolom measure_name dan measure_value::* kolom and, yang diisi dengan nilai-nilai dari hasil pernyataan kueri tindakan aturan topik.