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

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

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

狀態Map執行的一組步驟。

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

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

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

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

設定狀態類型，例如 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。解析後，參考路徑必須選取值為非負整數的欄位。

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

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

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

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

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

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

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

arn:aws:states:us-east-1:123456789012: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 的物件陣列，可定義重試政策。如果狀態遇到執行時間錯誤，則執行會使用重試政策。如需詳細資訊，請參閱使用重試和 Catch 的狀態機器範例。

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

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

輸出欄位接受任何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"
    ...
  }
}