View a markdown version of this page

DynamoDBv2 - AWS IoT Core
VoraussetzungenParametersBeispieleWeitere Informationen finden Sie auch unter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

DynamoDBv2

Die Aktion DynamoDBv2 (dynamoDBv2) schreibt eine MQTT-Nachricht ganz oder teilweise in eine Amazon DynamoDB-Tabelle. Jedes Attribut in der Nutzlast wird in eine separate Spalte in der DynamoDB-Datenbank geschrieben.

Voraussetzungen

Diese Regelaktion hat die folgenden Anforderungen:

  • Eine IAM-Rolle, die die Ausführung des Vorgangs übernehmen kann. AWS IoT dynamodb:PutItem Weitere Informationen finden Sie unter Gewährung eines AWS IoT regeln Sie den Zugriff, den es benötigt.

    In der AWS IoT Konsole können Sie eine Rolle auswählen oder erstellen, um die Ausführung dieser Regelaktion AWS IoT zu ermöglichen.

  • Die MQTT-Nachrichtnutzlast muss einen Schlüssel auf Stammebene enthalten, der mit dem primären Partitionsschlüssel der Tabelle übereinstimmt, sowie über einen Schlüssel auf Stammebene, der mit dem primären Sortierschlüssel der Tabelle (sofern definiert) übereinstimmt.

  • Wenn Sie einen vom Kunden verwalteten AWS KMS key (KMS-Schlüssel) verwenden, um ruhende Daten in DynamoDB zu verschlüsseln, muss der Dienst über die Berechtigung verfügen, den KMS-Schlüssel im Namen des Anrufers zu verwenden. Weitere Informationen finden Sie unter Kundenverwalteter KMS-Schlüssel im Amazon DynamoDB Einführungshandbuch..

Parameters

Wenn Sie mit dieser Aktion eine AWS IoT Regel erstellen, müssen Sie die folgenden Informationen angeben:

putItem

Ein Objekt, das die DynamoDB-Tabelle angibt, in die die Nachrichtendaten geschrieben werden sollen. Dieses Objekt muss die folgenden Informationen enthalten:

tableName

Der Name der DynamoDB-Tabelle.

Unterstützt Ersatzvorlagen: API und nur AWS CLI

roleARN

Die IAM-Rolle, die den Zugriff auf die DynamoDB-Tabelle erlaubt. Weitere Informationen finden Sie unter Voraussetzungen.

Unterstützt Ersatzvorlagen: Nein

Die in die DynamoDB-Tabelle geschriebenen Daten sind das Ergebnis der SQL-Anweisung der Regel.

Beispiele

Das folgende JSON-Beispiel definiert eine DynamoDBv2-Aktion in einer Regel. 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", 
                }
            }
        ]
    }
}

Das folgende JSON-Beispiel definiert eine DynamoDB-Aktion mit Ersatzvorlagen in einer Regel. 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"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter