D 2 ynamoDBv - AWS IoT Core
RequisitiParametriEsempiConsulta anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

D 2 ynamoDBv

L'azione D ynamoDBv 2 (dynamoDBv2) scrive tutto o parte di un MQTT messaggio in una tabella Amazon DynamoDB. Ogni attributo nel payload viene scritto in una colonna separata del database Dynamo DB.

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un IAM ruolo che AWS IoT può assumere per eseguire l'dynamodb:PutItemoperazione. Per ulteriori informazioni, consulta Concedere a qualsiasi AWS IoT regola l'accesso richiesto.

    Nella AWS IoT console, è possibile scegliere o creare un ruolo per consentire l'esecuzione di questa azione relativa AWS IoT alla regola.

  • Il payload del MQTT messaggio deve contenere una chiave a livello di root che corrisponda alla chiave di partizione primaria della tabella e una chiave a livello di root che corrisponda alla chiave di ordinamento primaria della tabella, se ne è stata definita una.

  • Se si utilizza una KMS chiave gestita AWS KMS key dal cliente per crittografare i dati inattivi in DynamoDB, il servizio deve disporre dell'autorizzazione a utilizzare la chiave per conto KMS del chiamante. Per ulteriori informazioni, consulta Customer Managed KMS key nella Amazon DynamoDB Getting Started Guide.

Parametri

Quando crei una AWS IoT regola con questa azione, devi specificare le seguenti informazioni:

putItem

Un oggetto che specifica la tabella Dynamo DB in cui verranno scritti i dati del messaggio. Questo oggetto deve contenere le seguenti informazioni:

tableName

Nome della tabella DynamoDB.

Supporta modelli sostitutivi: API e solo AWS CLI

roleARN

Il IAM ruolo che consente l'accesso alla tabella DynamoDB. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

I dati scritti nella tabella DynamoDB sono il risultato dell'istruzione SQL della regola.

Esempi

L'JSONesempio seguente definisce un'azione D ynamoDBv 2 in una AWS IoT regola.

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

L'JSONesempio seguente definisce un'azione DynamoDB con modelli di sostituzione in una regola. 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"
                }
            }
        ]
    }
}

Consulta anche