Step Functions를 사용하여 DynamoDB CRUD 작업 수행

Step Functions를 DynamoDB와 통합하여 DynamoDB 테이블에서 CRUD 작업을 수행할 수 있습니다. 이 페이지에는 지원되는 DynamoDB API가 나열되어 있으며 DynamoDB에서 항목을 검색할 수 있는 예제 Task 상태가 나와 있습니다.

Step Functions의 AWS 서비스와 통합하는 방법에 대한 자세한 내용은 서비스 통합 및 섹션을 참조하세요Step Functions의 서비스 API에 파라미터 전달.

최적화된 DynamoDB 통합의 주요 기능

• 요청 및 응답 통합 패턴에 대한 최적화는 없습니다.

• 작업 토큰을 사용하여 콜백 대기 통합 패턴은 지원되지 않습니다.

• 최적화된 통합을 통해 GetItem, PutItem, UpdateItem 및 DeleteItem API 작업만 사용할 수 있습니다. 와 같은 다른 API 작업은 DynamoDB AWS SDK 통합을 사용하여 CreateTable 사용할 수 있습니다.

다음은 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를 사용하여 데이터 레코드 전송 샘플 프로젝트를 확인하십시오.

참고

Step Functions에는 작업의 최대 입력 또는 결과 데이터 크기에 대한 할당량이 있습니다. 이렇게 하면 다른 서비스로 데이터를 보내거나 받을 때 256KiB의 데이터를 UTF-8 인코딩 문자열로 제한합니다. 상태 시스템 실행과 관련된 할당량을 참조하세요.

최적화된 DynamoDB APIs

• 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가 API 작업 startSyncExecution과 같은 camelCase에 있더라도 StateMachineArn과 같은 파라미터를 PascalCase에 지정합니다.

DynamoDB 호출을 위한 IAM 정책

다음 예제 템플릿은가 상태 시스템 정의의 리소스를 기반으로 IAM 정책을 AWS Step Functions 생성하는 방법을 보여줍니다. 자세한 내용은 Step Functions가 통합 서비스용 IAM 정책을 생성하는 방법 및 Step Functions에서 서비스 통합 패턴 검색 단원을 참조하세요.

정적 리소스

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "dynamodb:GetItem",
                "dynamodb:PutItem",
                "dynamodb:UpdateItem",
                "dynamodb:DeleteItem"
            ],
            "Resource": [
                "arn:aws:dynamodb:[[region]]:[[accountId]]:table/[[tableName]]"
            ]
        }
    ]
}
        

동적 리소스

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "dynamodb:GetItem",
                "dynamodb:PutItem",
                "dynamodb:UpdateItem",
                "dynamodb:DeleteItem"
            ],
            "Resource": "*"
        }
    ]
}

모든 DynamoDB API 작업에 대한 IAM 정책에 대한 자세한 내용은 Amazon DynamoDB 개발자 안내서의 DynamoDB의 IAM 정책을 참조하세요. 또한 DynamoDB용 PartiQL의 IAM 정책에 대한 자세한 내용은 Amazon DynamoDB 개발자 안내서의 DynamoDB용 PartiQL의 IAM 정책을 참조하세요.