Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden des Kartenstatus im Inline-Modus in Step Functions Functions-Workflows

Standardmäßig wird states Map im Inline-Modus ausgeführt. Im Inline-Modus akzeptiert der Map-Status nur ein JSON Array als Eingabe. Er erhält dieses Array aus einem früheren Schritt im Workflow. In diesem Modus wird jede Iteration des Map Status im Kontext des Workflows ausgeführt, der den Map Status enthält. Step Functions fügt die Ausführungshistorie dieser Iterationen zur Ausführungshistorie des übergeordneten Workflows hinzu.

In diesem Modus unterstützt der Map Status bis zu 40 gleichzeitige Iterationen.

Ein Map Status, der auf Inline gesetzt ist, wird als Inline Map-Status bezeichnet. Verwenden Sie den Map Status im Inline-Modus, wenn der Ausführungsverlauf Ihres Workflows 25.000 Einträge nicht überschreitet oder wenn Sie nicht mehr als 40 gleichzeitige Iterationen benötigen.

Eine Einführung in die Verwendung des Inline-Map-Status finden Sie im Tutorial. Wiederholen Sie Aktionen mit Inline Map

Die wichtigsten Konzepte in diesem Thema

Statusfelder in der Inline-Map

Um den Inline-Map-Status in Ihren Workflows zu verwenden, geben Sie eines oder mehrere dieser Felder an. Sie geben diese Felder zusätzlich zu den allgemeinen Statusfeldern an.

Veraltete Felder

Beispiel für einen Inline-Map-Status

Betrachten Sie die folgenden Eingabedaten für einen Map Status, der im Inlinemodus ausgeführt wird.

{
  "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 }
    ]
  }
}

Ausgehend von der vorherigen Eingabe ruft der Map Status im folgenden Beispiel eine AWS Lambda Funktion, die für jedes Element des Arrays im shipped Feld ship-val einmal benannt wurde.

"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"
}

Jede Iteration des Map Status sendet ein Element im Array, das mit dem ItemsPathFeld ausgewählt wurde, als Eingabe für die ship-val Lambda-Funktion. Die folgenden Werte sind ein Beispiel für Eingaben, die der Map Staat an einen Aufruf der Lambda-Funktion sendet:

{
  "prod": "R31",
  "dest-code": 9511,
  "quantity": 1344
}

Nach Abschluss des Map Zustands handelt es sich bei der Ausgabe um ein JSON Array, wobei jedes Element die Ausgabe einer Iteration ist. In diesem Fall enthält dieses Array die Ausgabe der ship-val Lambda-Funktion.

Beispiel für einen Inline-Map-Status mit ItemSelector

Angenommen, die ship-val Lambda-Funktion im vorherigen Beispiel benötigt auch Informationen über den Kurierdienst der Sendung. Diese Informationen werden zusätzlich zu den Elementen im Array für jede Iteration bereitgestellt. Sie können Informationen aus der Eingabe zusammen mit Informationen einbeziehen, die für die aktuelle Iteration des Map Status spezifisch sind. Beachten Sie das ItemSelector Feld im folgenden Beispiel:

"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
}

Der ItemSelector Block ersetzt die Eingabe für die Iterationen durch einen JSON Knoten. Dieser Knoten enthält sowohl die aktuellen Artikeldaten aus dem Kontextobjekt als auch die Kurierinformationen aus dem Feld der Map Statuseingabe. delivery-partner Das Folgende ist ein Beispiel für die Eingabe einer einzelnen Iteration. Der Map Staat übergibt diese Eingabe an einen Aufruf der ship-val Lambda-Funktion.

{
  "parcel": {
    "prod": "R31",
    "dest-code": 9511,
    "quantity": 1344
   },
   "courier": "UQS"
}

Im vorherigen Beispiel für einen Inline-Map-Status erzeugt das ResultPath Feld eine Ausgabe im gleichen Format wie die Eingabe. Es überschreibt das detail.shipped Feld jedoch mit einem Array, in dem jedes Element die Ausgabe des ship-val Lambda-Aufrufs jeder Iteration ist.

Weitere Informationen zur Verwendung des Inline Map-Statusstatus und seiner Felder finden Sie im Folgenden.

Eingabe- und Ausgabeverarbeitung im Map Inline-Status

InputPathWählt für einen bestimmten Map Status eine Teilmenge der Eingaben des Status aus.

Die Eingabe eines Map Zustands muss ein JSON Array enthalten. Der Map Status führt den ItemProcessor Abschnitt einmal für jedes Element im Array aus. Wenn Sie das ItemsPathFeld angeben, wählt der Map Status aus, an welcher Stelle in der Eingabe das Array gefunden werden soll, über das iteriert werden soll. Bei fehlender Angabe ist der Wert von ItemsPath $, und der Abschnitt ItemProcessor erwartet, dass das Array die einzige Eingabe ist. Wenn Sie das ItemsPath Feld angeben, muss es sich bei seinem Wert um einen Referenzpfad handeln. Der Map Staat wendet diesen Pfad auf die effektive Eingabe an, nachdem er den angewendet hatInputPath. Der ItemsPath muss ein Feld identifizieren, dessen Wert ein JSON Array ist.

Die Eingabe für jede Iteration ist standardmäßig ein einzelnes Element des Array-Feldes, das durch den ItemsPath Wert identifiziert wird. Sie können diesen Wert mit dem ItemSelector (Karte) Feld überschreiben.

Nach Abschluss des Map Zustands handelt es sich bei der Ausgabe um ein JSON Array, wobei jedes Element die Ausgabe einer Iteration ist.

Weitere Informationen zu Inline-Map-Statuseingaben und -ausgaben finden Sie im Folgenden: