Step Functions를 사용하여 DynamoDB API 직접 호출

Step Functions는 Amazon States Language (ASL) 에서 직접 특정 AWS 서비스를 제어할 수 있습니다. 자세한 내용은 다른 서비스와 함께 사용 및 파라미터를 서비스 API에 전달 섹션을 참조하세요.

참고

Step Functions에는 작업의 최대 입력 또는 결과 데이터 크기에 대한 할당량이 있습니다. 이를 통해 다른 서비스에 데이터를 보내거나 다른 서비스로부터 데이터를 받을 때 UTF-8 인코딩 문자열로 데이터 256KB까지 제한됩니다. 상태 시스템 실행과 관련된 할당량 섹션을 참조하십시오.

최적화된 DynamoDB 통합이 DynamoDB SDK 통합과 어떻게 다른지 AWS

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

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

• 최적화된 통합을 통해 GetItem, PutItem, UpdateItem 및 DeleteItem API 작업만 사용할 수 있습니다. 기타 API 작업 (예 CreateTable: AWS DynamoDB SDK 통합을 사용하여 사용 가능).

지원되는 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 API가 PascalCase CamelCase인 경우에도 의 파라미터는 로 표현됩니다. 예를 들어 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 정책