기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Step Functions 워크플로의 인라인 모드의 맵 상태 사용

기본적으로 Map 상태는 인라인 모드에서 실행됩니다. 인라인 모드에서 맵 상태는 JSON 배열만 입력으로 받아들입니다. 워크플로의 이전 단계에서 이 배열을 수신합니다. 이 모드에서는 각 Map 상태 반복이 Map 상태가 포함된 워크플로의 컨텍스트에서 실행됩니다. Step Functions는 이러한 반복 실행 내역을 상위 워크플로 실행 내역에 추가합니다.

이 모드에서 Map 상태는 동시 반복을 최대 40개까지 지원합니다.

인라인으로 설정된 Map 상태를 Inline Map 상태라고 합니다. 워크플로 실행 내역 항목이 25,000개를 초과하지 않거나 동시 반복이 40회 넘게 필요하지 않은 경우에 인라인 모드에서 Map 상태를 사용합니다.

Inline Map 상태 사용에 대한 소개는 자습서 인라인 맵으로 작업 반복 섹션을 참조하세요.

이 주제의 주요 개념

Inline Map 상태 필드

워크플로에서 Inline Map 상태를 사용하려면 다음 필드를 하나 이상을 지정합니다. 일반 상태 필드 외에 다음 필드를 지정합니다.

사용되지 않는 필드

Inline Map 상태 예제

인라인 모드에서 실행되는 Map 상태에 대한 다음 입력 데이터가 있다고 가정합니다.

{
  "ship-date": "2016-03-14T01:59:00Z",
  "detail": {
    "delivery-partner": "UQS",
    "shipped": [
      { "prod": "R31", "dest-code": 9511, "quantity": 1344 },
      { "prod": "S39", "dest-code": 9511, "quantity": 40 },
      { "prod": "R31", "dest-code": 9833, "quantity": 12 },
      { "prod": "R40", "dest-code": 9860, "quantity": 887 },
      { "prod": "R40", "dest-code": 9511, "quantity": 1220 }
    ]
  }
}

이전 입력이 주어지면 다음 예제의 Map 상태는 a를 호출합니다. AWS Lambda shipped필드에 있는 배열의 각 항목에 대해 ship-val 한 번씩 이름이 지정된 함수.

"Validate All": {
    "Type": "Map",
    "InputPath": "$.detail",
    "ItemProcessor": {
        "ProcessorConfig": {
            "Mode": "INLINE"
        },
        "StartAt": "Validate",
        "States": {
            "Validate": {
                "Type": "Task",
                "Resource": "arn:aws:states:::lambda:invoke",
                "OutputPath": "$.Payload",
                "Parameters": {
                    "FunctionName": "arn:aws:lambda:us-east-2:123456789012:function:ship-val:$LATEST"
                },
                "End": true
            }
        }
    },
    "End": true,
    "ResultPath": "$.detail.shipped",
    "ItemsPath": "$.shipped"
}

Map 상태를 반복할 때마다 ItemsPath 필드로 선택한 배열의 항목이 입력으로 ship-val Lambda 함수에 전송됩니다. 다음 값은 Map 상태에서 Lambda 함수 간접 호출에 보내는 입력의 예제입니다.

{
  "prod": "R31",
  "dest-code": 9511,
  "quantity": 1344
}

완료 시 Map 상태의 출력은 JSON 배열이며, 여기서 각 항목은 반복의 출력입니다. 이 경우 이 배열에는 ship-val Lambda 함수의 출력이 포함됩니다.

ItemSelector가 있는 Inline Map 상태 예제

앞의 예제의 ship-val Lambda 함수에 전송 주체에 대한 정보가 필요하다고 가정해보겠습니다. 이 정보는 각 반복의 배열에 있는 항목에 추가됩니다. 입력의 정보를 Map 상태의 현재 반복에 지정된 정보와 함께 포함할 수 있습니다. 다음 예제에서 ItemSelector 필드를 확인하세요.

"Validate-All": {
  "Type": "Map",
  "InputPath": "$.detail",
  "ItemsPath": "$.shipped",
  "MaxConcurrency": 0,
  "ResultPath": "$.detail.shipped",
  "ItemSelector": {
    "parcel.$": "$$.Map.Item.Value",
    "courier.$": "$.delivery-partner"
  },
  "ItemProcessor": {
    "StartAt": "Validate",
    "States": {
      "Validate": {
        "Type": "Task",
	"Resource": "arn:aws:lambda:us-east-1:123456789012:function:ship-val",
        "End": true
      }
    }
  },
  "End": true
}

ItemSelector블록은 반복에 대한 입력을 노드로 대체합니다. JSON 이 노드에는 컨텍스트 개체의 현재 항목 데이터와 Map 상태입력 delivery-partner 필드의 주체 정보가 모두 포함됩니다. 다음은 단일 반복에 대한 입력의 예제입니다. Map 상태는 이 입력을 ship-val Lambda 함수 간접 호출에 전달합니다.

{
  "parcel": {
    "prod": "R31",
    "dest-code": 9511,
    "quantity": 1344
   },
   "courier": "UQS"
}

이전 Inline Map 상태 예제에서 ResultPath 필드는 출력을 입력과 같은 형식으로 생성합니다. 하지만 각 요소가 각 반복의 ship-val Lambda 간접 호출의 출력인 배열로 detail.shipped 필드를 덮어씁니다.

Inline Map 상태 및 해당 필드 사용 방법에 대한 자세한 내용은 다음을 참조하세요.

Inline Map 상태 입력 및 출력 처리

지정된 Map 상태의 경우 InputPath에서 상태 입력의 하위 집합을 선택합니다.

Map상태 입력에는 배열이 포함되어야 합니다. JSON Map 상태는 배열의 항목마다 ItemProcessor 섹션을 한 번 실행합니다. ItemsPath 필드를 지정하면 Map 상태는 입력 위치를 선택하여 반복할 배열을 찾습니다. 지정하지 않으면 ItemsPath 값은 $가 되고, ItemProcessor 섹션에서는 배열이 유일한 입력일 것으로 예상합니다. ItemsPath 필드를 지정하는 경우 해당 값은 참조 경로여야 합니다. Map 상태는 InputPath를 적용한 후 이 경로를 유효 입력에 적용합니다. 는 값이 JSON 배열인 필드를 ItemsPath 식별해야 합니다.

각 반복에 대한 입력은 기본적으로 ItemsPath 값으로 식별되는 배열 필드의 단일 요소입니다. ItemSelector (지도) 필드를 사용하여 이 값을 재정의할 수 있습니다.

완료 시 Map 상태의 출력은 JSON 배열이며, 여기서 각 항목은 반복의 출력입니다.

Inline Map 상태 입력 및 출력에 대한 자세한 내용은 다음을 참조하세요.