View a markdown version of this page

DynamoDBv2 - 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.

DynamoDBv2

Tindakan DynamoDBv2 (dynamoDBv2) menulis semua atau sebagian pesan MQTT ke tabel Amazon DynamoDB. Setiap atribut dalam payload ditulis ke kolom terpisah dalam basis data DynamoDB.

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.

  • Payload pesan MQTT harus berisi kunci tingkat root yang cocok dengan kunci partisi utama tabel dan kunci tingkat root yang cocok dengan kunci pengurutan utama tabel, jika didefinisikan.

  • 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:

putItem

Objek yang menentukan tabel DynamoDB tempat data pesan akan ditulis. Objek ini harus berisi informasi berikut:

tableName

Nama dari tabel DynamoDB.

Men dukung template substitusi: API dan AWS CLI hanya

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 DynamoDBv2 dalam aturan. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * AS message FROM 'some/topic'", 
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "dynamoDBv2": {
                    "putItem": {
                        "tableName": "my_ddb_table"
                    },
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_dynamoDBv2", 
                }
            }
        ]
    }
}

Contoh JSON berikut mendefinisikan tindakan DynamoDB dengan template substitusi dalam aturan. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2015-10-08",
        "actions": [
            {
                "dynamoDBv2": {
                    "putItem": {
                        "tableName": "${topic()}"
                    },
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_dynamoDBv2"
                }
            }
        ]
    }
}

Lihat juga