ynamoDBvD.2 - AWS IoT Core
PrérequisParamètresExemplesConsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ynamoDBvD.2

L'action D ynamoDBv 2 (dynamoDBv2) écrit tout ou partie d'un MQTT message dans une table Amazon DynamoDB. Chaque attribut de la charge utile est écrit dans une colonne distincte de la base de données DynamoDB.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • IAMRôle qui AWS IoT peut assumer la réalisation de l'dynamodb:PutItemopération. Pour de plus amples informations, veuillez consulter Accorder à une AWS IoT règle l'accès dont elle a besoin.

    Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.

  • La charge utile du MQTT message doit contenir une clé de niveau racine correspondant à la clé de partition principale de la table et une clé de niveau racine correspondant à la clé de tri principale de la table, le cas échéant.

  • Si vous utilisez une KMS clé gérée par AWS KMS key le client pour chiffrer des données inactives dans DynamoDB, le service doit être autorisé à utiliser la clé au nom de KMS l'appelant. Pour plus d'informations, consultez la section KMSClé gérée par le client dans le guide de démarrage d'Amazon DynamoDB.

Paramètres

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

putItem

Un objet qui indique la table DynamoDB dans laquelle les données de message seront écrites. Cet objet doit contient les informations suivantes :

tableName

Le nom de la table DynamoDB.

Supporte les modèles de substitution : API et AWS CLI uniquement

roleARN

IAMRôle qui autorise l'accès à la table DynamoDB. Pour de plus amples informations, veuillez consulter Prérequis.

Prend en charge les modèles de substitution : Non

Les données écrites dans la table DynamoDB sont le résultat de l'énoncé de SQL la règle.

Exemples

L'JSONexemple suivant définit une action ynamoDBv D2 dans une AWS IoT règle.

{
    "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'JSONexemple suivant définit une action DynamoDB avec des modèles de substitution dans une règle. 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"
                }
            }
        ]
    }
}

Consultez aussi