針對 Step Functions 中的大規模平行工作負載，在分散式模式中使用映射狀態

Map 狀態的處理模式。在此模式中，狀態的每個反覆運算Map都會執行為啟用高並行的子工作流程執行。每個子工作流程執行都有自己的執行歷史記錄，與父工作流程的執行歷史記錄分開。此模式支援從大規模 Amazon S3 資料來源讀取輸入。

映射狀態設定為分散式處理模式。

狀態Map執行的一組步驟。

包含一或多個分散式映射狀態的工作流程。

分散式地圖狀態的反覆運算。子工作流程執行有自己的執行歷史記錄，與父工作流程的執行歷史記錄分開。

當您在分散式模式下執行 Map 狀態時，Step Functions 會建立 Map Run 資源。Map Run 是指分散式映射狀態啟動的一組子工作流程執行，以及控制這些執行的執行時間設定。Step Functions 會將 Amazon Resource Name (ARN) 指派給您的 Map Run。您可以在 Step Functions 主控台中檢查 Map Run。您也可以叫用 DescribeMapRun API 動作。

Map Run 的子工作流程執行會向 發出指標 CloudWatch；。這些指標會有標記的狀態機器 ARN，格式如下：

arn:partition:states:region:account:stateMachine:stateMachineName/MapRunLabel or UUID

如需詳細資訊，請參閱檢視地圖執行。

{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachineName"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution"
      ],
      "Resource": "arn:aws:states:us-east-1:123456789012:execution:myStateMachineName:*"
    }
  ]
}

設定狀態類型，例如 Map。

包含下列指定Map狀態處理模式和定義的 JSON 物件。

指定資料集及其位置。Map 狀態會從指定的資料集接收其輸入資料。

在分散式模式中，您可以使用從先前狀態傳遞的 JSON 承載，或是使用大型 Amazon S3 資料來源做為資料集。如需詳細資訊，請參閱ItemReader （地圖）。

必須評估為陣列的 JSON 陣列或 JSONata 表達式。

使用 JsonPath 語法指定參考路徑，以選取包含狀態輸入內項目陣列的 JSON 節點。

在分散式模式中，只有當您使用上一個步驟的 JSON 陣列做為狀態輸入時，才指定此欄位。如需詳細資訊，請參閱ItemsPath （地圖，僅限 JSONPath)。

覆寫個別資料集項目的值，然後再傳遞至每個Map狀態反覆運算。

在此欄位中，您可以指定有效的 JSON 輸入，其中包含鍵值對的集合。這些對可以是您在狀態機器定義中定義的靜態值、使用路徑從狀態輸入中選取的值，或從內容物件存取的值。如需詳細資訊，請參閱ItemSelector （地圖）。

指定 批次處理資料集項目。然後，每個子工作流程執行都會收到這些項目的批次做為輸入。如需詳細資訊，請參閱ItemBatcher （地圖）。

指定可平行執行的子工作流程執行數目。解譯器最多只允許指定數量的平行子工作流程執行。如果您未指定並行值或將其設為零，Step Functions 不會限制並行並執行 10，000 個平行子工作流程執行。在 JSONata 狀態下，您可以指定評估為整數的 JSONata 表達式。

如果您想要使用參考路徑從狀態輸入動態提供最大並行值，請使用 MaxConcurrencyPath。解析後，參考路徑必須選取值為非負整數的欄位。

定義映射執行中要容忍的失敗項目百分比。如果 Map Run 超過此百分比，則會自動失敗。Step Functions 計算失敗項目的百分比，是失敗或逾時項目總數除以項目總數的結果。您必須指定介於零到 100 之間的值。如需詳細資訊，請參閱在 Step Functions 中設定分散式映射狀態的失敗閾值。

在 JSONata 狀態下，您可以指定評估為整數的 JSONata 表達式。

如果您想要使用參考路徑從狀態輸入動態提供可容忍的失敗百分比值，請使用 ToleratedFailurePercentagePath。解析後，參考路徑必須選取值介於零和 100 之間的欄位。

定義映射執行中要容忍的失敗項目數量。如果 Map Run 超過此數字，則會自動失敗。如需詳細資訊，請參閱在 Step Functions 中設定分散式映射狀態的失敗閾值。

在 JSONata 狀態下，您可以指定評估為整數的 JSONata 表達式。

如果您想要使用參考路徑從狀態輸入動態提供容錯計數值，請使用 ToleratedFailureCountPath。解析後，參考路徑必須選取值為非負整數的欄位。

唯一識別Map狀態的字串。對於每個映射執行，Step Functions 會將標籤新增至映射執行 ARN。以下是具有名為 之自訂標籤的 Map Run ARN 範例demoLabel：

arn:aws:states:region:account-id:mapRun:demoWorkflow/demoLabel:3c39a231-69bb-3d89-8607-9e124eddbb0b

如果您未指定標籤，Step Functions 會自動產生唯一的標籤。

指定 Step Functions 寫入所有子工作流程執行結果的 Amazon S3 位置。

Step Functions 會合併所有子工作流程執行資料，例如執行輸入和輸出、ARN 和執行狀態。接著，它會將狀態相同的執行匯出至指定 Amazon S3 位置中的個別檔案。如需詳細資訊，請參閱ResultWriter （地圖）。

如果您不匯出Map狀態結果，它會傳回所有子工作流程執行結果的陣列。例如：

[1, 2, 3, 4, 5]

指定輸入中要放置反覆運算輸出的位置。輸入接著會依 OutputPath 欄位指定的存在進行篩選，再做為狀態的輸出傳遞。如需詳細資訊，請參閱輸入和輸出處理。

傳遞金鑰值對的集合，其中值為靜態或從結果中選取。如需詳細資訊，請參閱ResultSelector。

稱為 Retriers 的物件陣列，可定義重試政策。如果狀態遇到執行時間錯誤，則執行會使用重試政策。如需詳細資訊，請參閱使用重試和擷取的狀態機器範例。

稱為 Catcher 的物件陣列，可定義後援狀態。Catch 如果狀態遇到執行時間錯誤，Step Functions 會使用 中定義的 Catchers。發生錯誤時，執行會先使用 中定義的任何重試器Retry。如果未定義或耗盡重試政策，則如果已定義，則執行會使用其 Catchers。如需詳細資訊，請參閱備用狀態。

用來指定和轉換 狀態的輸出。指定時，值會覆寫狀態輸出預設值。

輸出欄位接受任何 JSON 值 （物件、陣列、字串、數字、布林值、 null)。任何字串值，包括物件或陣列內的值，如果被 {% %} 字元包圍，將評估為 JSONata。

輸出也直接接受 JSONata 表達式，例如：「輸出」：「{% jsonata 表達式 %}」

如需詳細資訊，請參閱在 Step Functions 中使用 JSONata 轉換資料。

用來存放變數。Assign 欄位接受 JSON 物件，其中包含定義變數名稱及其指派值的鍵/值對。任何字串值，包括物件或陣列內的值，都會在以{% %}字元包圍時評估為 JSONata

如需詳細資訊，請參閱使用變數在狀態之間傳遞資料。

定義要容忍的失敗項目百分比。如果超過此值，您的 Map Run 失敗。Step Functions 計算失敗項目的百分比，是失敗或逾時項目總數除以項目總數的結果。您必須指定介於零到 100 之間的值。預設百分比值為零，這表示如果其任何一個子工作流程執行失敗或逾時，工作流程就會失敗。如果您將百分比指定為 100，即使所有子工作流程執行都失敗，工作流程也不會失敗。

或者，您可以指定百分比做為分散式映射狀態輸入中現有鍵值對的參考路徑。此路徑必須在執行時間解析為介於 0 到 100 之間的正整數。您可以在 ToleratedFailurePercentagePath子欄位中指定參考路徑。

例如，假設有下列輸入：

{
  "percentage": 15
}

您可以使用該輸入的參考路徑指定百分比，如下所示：

{
  ...
  "Map": {
    "Type": "Map",
    ...
    "ToleratedFailurePercentagePath": "$.percentage"
    ...
  }
}

定義要容忍的失敗項目數量。如果超過此值，您的 Map Run 失敗。

或者，您可以指定計數做為分散式映射狀態輸入中現有鍵值對的參考路徑。此路徑必須在執行時間解析為正整數。您可以在 ToleratedFailureCountPath子欄位中指定參考路徑。

例如，假設有下列輸入：

{
  "count": 10
}

您可以使用該輸入的參考路徑指定數字，如下所示：

{
  ...
  "Map": {
    "Type": "Map",
    ...
    "ToleratedFailureCountPath": "$.count"
    ...
  }
}