ItemReader (地圖)

「分散式貼圖」狀態可以接受從工作流程中先前步驟傳遞的JSON輸入。此輸入必須是陣列，或者必須包含特定節點內的陣列。若要選取包含陣列的節點，您可以使用ItemsPath (地圖)欄位。

若要處理陣列中的個別項目，分散式對應狀態會啟動每個陣列項目的子工作流程執行。下列標籤顯示傳遞至Map狀態的輸入範例，以及對應輸入至子工作流程執行的範例。

分散式地圖狀態可以重複存放在 Amazon S3 儲存貯體中的物件。當工作流程執行到達Map狀態時，Step Functions 數會叫用 ListObjectsV2 API 動作，該動作會傳回 Amazon S3 物件中繼資料的陣列。在此陣列中，每個項目都包含儲存在值區中之資料的資料，例如ETag和 Key。

若要處理陣列中的個別項目，「分散式對應」狀態會啟動子工作流程執行。例如，假設您的 Amazon S3 儲存貯體包含 100 個映像檔。然後，調用ListObjectsV2API動作後返回的數組包含 100 個項目。然後，「分散式對應」狀態會啟動 100 個子工作流程執行，以處理每個陣列項目。

下列索引標籤顯示ItemReader欄位語法範例，以及為此資料集傳遞至子工作流程執行的輸入。

分散式地圖狀態可以接受存放在 Amazon S3 儲存貯體中的JSON檔案做為資料集。該JSON文件必須包含一個數組。

當工作流程執行到達狀Map態時，「Step Functions」會叫用GetObjectAPI動作來擷取指定的JSON檔案。然後，Map狀態會重複執行陣列中的每個項目，並針對每個項目啟動子工作流程執行。例如，如果您的JSON檔案包含 1000 個陣列項目，則Map狀態會啟動 1000 個子工作流程執行。

下列索引標籤顯示ItemReader欄位語法範例，以及為此資料集傳遞至子工作流程執行的輸入。

在此範例中，假設您有一個JSON名為factcheck.json. 您已將此檔案存放在 Amazon S3 儲存貯體jsonDataset中名為的前置詞內。以下是資JSON料集的範例。

[
  {
    "verdict": "true",
    "statement_date": "6/11/2008",
    "statement_source": "speech"
  },
  {
    "verdict": "false",
    "statement_date": "6/7/2022",
    "statement_source": "television"
  },
  {
    "verdict": "mostly-true",
    "statement_date": "5/18/2016",
    "statement_source": "news"
  },
  ...
]

分散式地圖狀態可以接受存放在 Amazon S3 儲存貯體中的CSV檔案做為資料集。如果您使用CSV檔案做為資料集，則必須指定資料CSV欄標題。若要取得有關如何指定CSV標頭的資訊，請參閱〈〉該 ItemReader 領域的內容。

Step Functions 根據以下規則解析CSV文件：

如需「Step Functions」如何剖析CSV檔案的詳細資訊，請參閱Example of parsing an input CSV file。

當工作流程執行到達狀Map態時，「Step Functions」會叫用GetObjectAPI動作來擷取指定的CSV檔案。然後，Map狀態會重複執行CSV檔案中的每一列，並啟動子工作流程執行，以處理每一列中的項目。例如，假設您提供的CSV檔案包含 100 列作為輸入。然後，解釋器將每一行傳遞給Map狀態。狀Map態會以序列順序處理項目，從標題列之後開始。

下列索引標籤顯示ItemReader欄位語法範例，以及為此資料集傳遞至子工作流程執行的輸入。

分散式地圖狀態可以接受以資料集形式存放在 Amazon S3 儲存貯體中的 Amazon S3 庫存資訊清單檔案。

當工作流程執行到達狀Map態時，Step Functions 會叫用GetObjectAPI動作以擷取指定的 Amazon S3 庫存資訊清單檔案。然後，Map狀態會重複執行詳細目錄中的物件，以傳回 Amazon S3 庫存物件中繼資料的陣列。

以下是CSV格式的詳細目錄檔案範例。此檔案包含名為csvDataset和的物件imageDataset，這些物件存放在名為的 Amazon S3 儲存貯體中amzn-s3-demo-source-bucket。

"amzn-s3-demo-source-bucket","csvDataset/","0","2022-11-16T00:27:19.000Z"
"amzn-s3-demo-source-bucket","csvDataset/titles.csv","3399671","2022-11-16T00:29:32.000Z"
"amzn-s3-demo-source-bucket","imageDataset/","0","2022-11-15T20:00:44.000Z"
"amzn-s3-demo-source-bucket","imageDataset/n02085620_10074.jpg","27034","2022-11-15T20:02:16.000Z"
...

下列詳細目錄資訊清單檔案範例顯示詳細目錄物件中繼資料的CSV標頭。

{
  "sourceBucket" : "amzn-s3-demo-source-bucket",
  "destinationBucket" : "arn:aws:s3:::amzn-s3-demo-inventory",
  "version" : "2016-11-30",
  "creationTimestamp" : "1668560400000",
  "fileFormat" : "CSV",
  "fileSchema" : "Bucket, Key, Size, LastModifiedDate",
  "files" : [ {
    "key" : "amzn-s3-demo-bucket/destination-prefix/data/20e55de8-9c21-45d4-99b9-46c732000228.csv.gz",
    "size" : 7300,
    "MD5checksum" : "a7ff4a1d4164c3cd55851055ec8f6b20"
  } ]
}

下列索引標籤顯示ItemReader欄位語法範例，以及為此資料集傳遞至子工作流程執行的輸入。