本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Step Functions 工作流程中以内联模式使用地图状态

默认情况下，Map 状态以内联模式运行。在内联模式下，Map 状态仅接受JSON数组作为输入。它接收来自工作流中上一步的数组。在此模式下，Map 状态的每次迭代都在包含 Map 状态的工作流的上下文中运行。Step Functions 会将这些迭代的执行历史记录添加到父工作流的执行历史记录中。

在此模式下，Map 状态最多支持 40 次并发迭代。

设置为内联的 Map 状态称为内联 Map 状态。如果工作流的执行历史记录不超过 2.5 万个条目，或者需要的并发迭代次数不超过 40 次，则可以使用内联模式的 Map 状态。

有关使用内联 Map 状态的介绍，请参阅教程使用内联地图重复操作。

本主题中的关键概念

内联 Map 状态字段

要在工作流中使用内联 Map 状态，请指定以下字段中的一个或多个。除了公共状态字段外，您还可以指定以下字段。

已弃用的字段

内联 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状态会调用 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 的内联 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"
}

在前面的内联 Map 状态示例中，ResultPath 字段以与输入相同的格式生成输出。但是，它会用一个数组覆盖 detail.shipped 字段，数组中每个元素都是每次迭代的 ship-val Lambda 调用的输出。

有关使用内联 Map 状态及其字段的更多信息，请参阅以下内容。

内联 Map 状态输入和输出处理

对于给定的 Map 状态，InputPath 选择该状态输入的子集。

Map状态的输入必须包含JSON数组。Map 状态为数组中的每个项目运行一次 ItemProcessor 部分。如果指定了 ItemsPath 字段，则 Map 状态会选择在输入中的哪个位置查找要迭代的数组。如果未指定，ItemsPath 的值为 $，而 ItemProcessor 部分预期此数组是唯一的输入。如果指定了 ItemsPath 字段，则其值必须为参考路径。Map 状态在应用 InputPath 之后，会将此路径应用于有效输入。ItemsPath必须标识值为JSON数组的字段。

默认情况下，每次迭代的输入都是由 ItemsPath 值标识的数组字段的单个元素。您可以使用 ItemSelector （地图） 字段覆盖此值。

完成后，Map状态的输出是一个JSON数组，其中每个项目都是迭代的输出。

有关内联 Map 状态输入和输出的更多信息，请参阅以下内容：