View a markdown version of this page

DynamoDB - AWS IoT Core
PersyaratanParameterContohLihat juga

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

DynamoDB

Tindakan DynamoDB (dynamoDB) menulis semua atau sebagian pesan MQTT ke tabel Amazon DynamoDB.

Anda dapat mengikuti tutorial yang menunjukkan cara membuat dan menguji aturan dengan tindakan DynamoDB. Untuk informasi selengkapnya, lihat Tutorial: Menyimpan data perangkat dalam tabel DynamoDB.

catatan

Aturan ini menulis data non-JSON ke DynamoDB sebagai data biner. Konsol DynamoDB menampilkan data sebagai teks yang dikodekan base64.

Persyaratan

Tindakan aturan ini memiliki persyaratan sebagai berikut:

  • Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan dynamodb:PutItem operasi. Untuk informasi selengkapnya, lihat Pemberian AWS IoT mengatur akses yang dibutuhkannya.

    Di AWS IoT konsol, Anda dapat memilih atau membuat peran AWS IoT untuk memungkinkan melakukan tindakan aturan ini.

  • Jika Anda menggunakan kunci yang dikelola pelanggan AWS KMS key (kunci KMS) untuk mengenkripsi data diam di DynamoDB, layanan harus memiliki izin untuk menggunakan kunci KMS atas nama pemanggil. Untuk informasi selengkapnya, lihat kunci KMS yang Dikelola Pelang gan di Panduan Memulai Amazon DynamoDB.

Parameter

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

tableName

Nama dari tabel DynamoDB.

Men dukung template substitusi: API dan AWS CLI hanya

hashKeyField

Nama kunci hash (juga disebut kunci partisi).

Men dukung template substitusi: API dan AWS CLI hanya

hashKeyType

(Opsional) Jenis data dari kunci hash (juga disebut kunci partisi). Nilai-nilai yang valid: STRING, NUMBER.

Men dukung template substitusi: API dan AWS CLI hanya

hashKeyValue

Nilai kunci hash. Pertimbangkan untuk menggunakan template substitusi seperti ${topic()} atau${timestamp()}.

Mendukung template substitusi: Ya

rangeKeyField

(Opsional) Nama kunci rentang (juga disebut kunci pengurutan).

Men dukung template substitusi: API dan AWS CLI hanya

rangeKeyType

(Opsional) Jenis data dari kunci rentang (juga disebut kunci pengurutan). Nilai-nilai yang valid: STRING, NUMBER.

Men dukung template substitusi: API dan AWS CLI hanya

rangeKeyValue

(Opsional) Nilai tombol rentang. Pertimbangkan untuk menggunakan template substitusi seperti ${topic()} atau${timestamp()}.

Mendukung template substitusi: Ya

payloadField

(Opsional) Nama kolom tempat muatan ditulis. Jika Anda menghilangkan nilai ini, payload ditulis ke kolom bernama. payload

Mendukung template substitusi: Ya

operation

(Opsional) Jenis operasi yang akan dilakukan. Nilai-nilai yang valid: INSERT, UPDATE, DELETE.

Mendukung template substitusi: Ya

roleARN

Peran IAM yang memungkinkan akses ke tabel DynamoDB. Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: Tidak

Data yang ditulis ke tabel DynamoDB adalah hasil dari pernyataan SQL aturan.

Contoh

Contoh JSON berikut mendefinisikan tindakan DynamoDB dalam aturan. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * AS message FROM 'some/topic'", 
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "dynamoDB": {
                    "tableName": "my_ddb_table",
                    "hashKeyField": "key",
                    "hashKeyValue": "${topic()}",
                    "rangeKeyField": "timestamp",
                    "rangeKeyValue": "${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_dynamoDB"
                }
            }
        ]
    }
}

Lihat juga