本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 Step Functions 工作流程的內嵌模式中使用映射狀態

根據預設， Map 狀態會以內嵌模式執行。在內嵌模式中，映射狀態僅接受 JSON 陣列做為輸入。它會從工作流程中的上一個步驟接收此陣列。在此模式中，狀態的每個反覆運算都會在包含 Map 狀態的工作流程內容中Map執行。Step Functions 會將這些反覆運算的執行歷史記錄新增至父工作流程的執行歷史記錄。

在此模式中， Map 狀態最多支援 40 個並行反覆運算。

設定為內嵌Map的狀態稱為內嵌映射狀態。如果工作流程的執行歷史記錄不超過 25，000 個項目，或者您不需要超過 40 個並行反覆運算，請在內嵌模式中使用 Map 狀態。

如需使用內嵌地圖狀態的簡介，請參閱教學課程 使用內嵌映射重複動作。

本主題的主要概念

內嵌映射狀態欄位

若要在工作流程中使用內嵌映射狀態，請指定一個或多個這些欄位。除了常見狀態欄位之外，您還會指定這些欄位。

已棄用的欄位

內嵌映射狀態範例 (JSONPath)

請考慮下列在內嵌模式下執行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的狀態會針對 shipped 欄位中陣列的每個項目叫用名為 ship-val 一次的 AWS Lambda 函數。

"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

假設上一個範例中的 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"
}

在先前的內嵌映射狀態範例中， ResultPath 欄位會以與輸入相同的格式產生輸出。不過，它會使用陣列覆寫 detail.shipped 欄位，其中每個元素都是每個反覆 ship-val Lambda 調用的輸出。

如需使用內嵌映射狀態及其欄位的詳細資訊，請參閱以下內容。

內嵌Map狀態輸入和輸出處理

對於指定Map狀態， 會InputPath選取狀態輸入的子集。

Map 狀態的輸入必須包含 JSON 陣列。Map 狀態會針對陣列中的每個項目執行 ItemProcessor區段一次。如果您指定 ItemsPath 欄位，Map狀態會選取輸入中要反覆運算的陣列位置。如果未指定，則 ItemsPath 的值為 $，而 ItemProcessor 區段預期陣列是唯一的輸入。如果您指定 ItemsPath 欄位，其值必須是參考路徑。Map 狀態會在套用 之後，將此路徑套用至有效輸入InputPath。必須ItemsPath識別值為 JSON 陣列的欄位。

根據預設，每個反覆運算的輸入是 ItemsPath值所識別陣列欄位的單一元素。您可以使用 ItemSelector （地圖） 欄位覆寫此值。

完成時，Map 狀態的輸出為 JSON 陣列，其中每個項目都是反覆運算的輸出。

如需內嵌映射狀態輸入和輸出的詳細資訊，請參閱以下內容：