Rufen Sie DynamoDB-APIs mit Step Functions auf

Step Functions kann bestimmte AWS Dienste direkt von Amazon States Language (ASL) aus steuern. Weitere Informationen hierzu finden Sie unter Arbeiten mit anderen -Services und Parameter an eine Service-API übergeben.

Anmerkung

In Step Functions gibt es ein Kontingent für die maximale Eingabe- oder Ergebnisdatengröße für eine Aufgabe. Dadurch sind Sie auf 256 KB an Daten als UTF-8-kodierte Zeichenfolge beschränkt, wenn Sie Daten an einen anderen Dienst senden oder von einem anderen Dienst empfangen. Siehe Kontingente im Zusammenhang mit der Ausführung von Zustandsmaschinen.

Wie sich die optimierte DynamoDB-Integration von der AWS DynamoDB-SDK-Integration unterscheidet

• Es gibt keine Optimierung für das Integrationsmuster. Request Response (Antwort anfordern)

• Das Warten auf einen Callback mit dem Aufgabentoken Integrationsmuster wird nicht unterstützt.

• Nur DeleteItemAPI-Aktionen GetItemPutItem, UpdateItem, und sind im Rahmen der optimierten Integration verfügbar. Andere API-Aktionen, wie sie beispielsweise über die AWS DynamoDB-SDK-Integration verfügbar CreateTablesind.

Unterstützte Amazon DynamoDB DynamoDB-APIs und -Syntax:

• GetItem

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Key

    • TableName

    • AttributesToGet

    • ConsistentRead

    • ExpressionAttributeNames

    • ProjectionExpression

    • ReturnConsumedCapacity

  • Antwortsyntax

• PutItem

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Item

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Antwortsyntax

• DeleteItem

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Key

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Antwortsyntax

• UpdateItem

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Key

    • TableName

    • AttributeUpdates

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

    • UpdateExpression

  • Antwortsyntax

Anmerkung

Parameter in Step Functions werden in ausgedrückt PascalCase, auch wenn sich die native Service-API in CamelCase befindet. Sie könnten beispielsweise die Step Functions API-Aktion verwenden startSyncExecution und ihren Parameter als angeben. StateMachineArn

Der folgende Task Status ruft eine Nachricht von DynamoDB ab.

    "Read Next Message from DynamoDB": {
      "Type": "Task",
      "Resource": "arn:aws:states:::dynamodb:getItem",
      "Parameters": {
        "TableName": "TransferDataRecords-DDBTable-3I41R5L5EAGT",
        "Key": {
          "MessageId": {"S.$": "$.List[0]"}
        }
      },
      "ResultPath": "$.DynamoDB",
      "Next": "Send Message to SQS"
    },
        

In einem funktionierenden Beispiel sehen Sie diesen Status im Beispielprojekt Datensätze übertragen (Lambda,DynamoDB,Amazon SQS).

Informationen zur Konfiguration von IAM Berechtigungen bei der Verwendung Step Functions mit anderen AWS Diensten finden Sie unter. IAM-Richtlinien für integrierte Dienste