使用 Step Functions 调用 DynamoDB API

Step Functions 可以直接从 Amazon States Language (ASL) 控制某些 AWS 服务。要了解更多信息，请参阅使用其他服务和将参数传递给服务 API。

注意

在 Step Functions 中，任务的最大输入或结果数据大小有一个配额。在向另一个服务发送数据或从另一个服务接收数据时，数据大小不得超过 256 KB（UTF-8 编码字符串）。请参阅 与状态机执行相关的配额。

优化后的 DynamoDB 集成与 DynamoDB 软件开发工具包集成有何不同 AWS

• 请求响应集成模式没有优化。

• 不支持等待具有任务令牌的回调集成模式。

• 通过优化集成，只有 GetItem、PutItem、UpdateItem and DeleteItem API 操作可用。其他 API 操作（例如 CreateTable）可通过 DynamoDB AWS 软件开发工具包集成获得。

支持的 Amazon DynamoDB API 和语法：

• GetItem

  • 请求语法

  • 支持的参数：

    • Key

    • TableName

    • AttributesToGet

    • ConsistentRead

    • ExpressionAttributeNames

    • ProjectionExpression

    • ReturnConsumedCapacity

  • 响应语法

• PutItem

  • 请求语法

  • 支持的参数：

    • Item

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • 响应语法

• DeleteItem

  • 请求语法

  • 支持的参数：

    • Key

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • 响应语法

• UpdateItem

  • 请求语法

  • 支持的参数：

    • Key

    • TableName

    • AttributeUpdates

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

    • UpdateExpression

  • 响应语法

注意

中的Step Functions参数以表示 PascalCase，即使本机服务 API 采用驼峰大小写。例如，您可以使用 Step Functions API 操作 startSyncExecution 并将其参数指定为 StateMachineArn。

下面是从 DynamoDB 检索消息的 Task 状态。

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

要在可正常使用的示例中查看此状态，请参阅传输数据记录（Lambda、DynamoDB、Amazon SQS）示例项目。

有关在与其他 AWS 服务Step Functions一起使用时如何配置IAM权限的信息，请参阅集成服务的 IAM 策略。