Parallel - AWS Step Functions

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.

Parallel

Mithilfe des Zustands Parallel ("Type": "Parallel") können parallele Ausführungsverzweigungen in Ihrem Zustandsautomaten erstellt werden.

Zusätzlich zu den allgemeinen Zustandsfeldern führen Parallel-Zustände diese zusätzlichen Felder ein.

Branches (Erforderlich)

Ein Array von Objekten, das Zustandsautomaten bestimmt, die parallel ausgeführt werden. Jedes dieser Zustandsautomatenobjekte muss über Felder namens States und StartAt verfügen, die dasselbe bedeuten wie diejenigen im oberen Level eines Zustandsautomaten.

ResultPath (Optional)

Gibt an, wo (in der Eingabe) die Ausgabe der Verzweigungen platziert werden soll. Die Eingabe wird dann wie vom Feld OutputPath festgelegt gefiltert (falls vorhanden), bevor sie als Ausgabe des Zustands verwendet wird. Weitere Informationen finden Sie unter Verarbeitung von Eingabe und Ausgabe.

ResultSelector (Optional)

Übergeben Sie eine Auflistung von Schlüssel-Wert-Paaren, wobei die Werte statisch sind oder aus dem Ergebnis ausgewählt sind. Weitere Informationen finden Sie unter ResultSelector.

Retry (Optional)

Ein Array von Objekten namens Retrier, die eine Wiederholungsrichtlinie für den Fall definieren, dass der Zustand auf Laufzeitfehler trifft. Weitere Informationen finden Sie unter Beispiele für die Verwendung von Retry und Catch.

Catch (Optional)

Ein Array von Objekten namens Catcher, die einen Fallback-Zustand definieren, der ausgeführt wird, wenn der Zustand auf Laufzeitfehler trifft und seine Wiederholungsrichtlinie ausgeschöpft wurde oder nicht definiert ist. Weitere Informationen finden Sie unter Fallback-Zustände.

Ein Parallel-Zustand bewirkt, dass AWS Step Functions jede Verzweigung möglichst gleichzeitig ausführt, beginnend mit dem Zustand, der im Feld StartAt dieser Verzweigung genannt ist, und wartet, bis alle Verzweigungen beendet sind (einen Beendigungszustand erreichen), bevor das Feld Next des Parallel-Zustands verarbeitet wird.

Beispiel für den Parallelzustand

{ "Comment": "Parallel Example.", "StartAt": "LookupCustomerInfo", "States": { "LookupCustomerInfo": { "Type": "Parallel", "End": true, "Branches": [ { "StartAt": "LookupAddress", "States": { "LookupAddress": { "Type": "Task", "Resource": "arn:aws:lambda:us-east-1:123456789012:function:AddressFinder", "End": true } } }, { "StartAt": "LookupPhone", "States": { "LookupPhone": { "Type": "Task", "Resource": "arn:aws:lambda:us-east-1:123456789012:function:PhoneFinder", "End": true } } } ] } } }

In diesem Beispiel werden die Verzweigungen LookupAddress und LookupPhone parallel ausgeführt. So sieht der visuelle Workflow in der Step Functions Functions-Konsole aus.


      Paralleler Workflow.

Jede Verzweigung muss unabhängig sein. Ein Zustand in einer Verzweigung eines Parallel-Zustands darf kein Next-Feld haben, das auf ein Feld außerhalb dieser Verzweigung abzielt, noch darf ein anderer Zustand außerhalb der Verzweigung in diese Verzweigung übergehen.

Ein- und Ausgabeverarbeitung des Parallelzustands

Ein Parallel-Zustand stellt jeder Verzweigung eine Kopie seiner eigenen Eingabedaten bereit (Änderungen durch das Feld InputPath unterliegend). Er generiert eine Ausgabe, die ein Array mit einem Element für jede Verzweigung ist, das die Ausgabe von dieser Verzweigung enthält. Es ist nicht erforderlich, dass alle Elemente vom selben Typ sind. Das Ausgabe-Array kann in die Eingabedaten eingefügt werden (und das Ganze als Ausgabe des Parallel-Zustands gesendet werden), indem ein ResultPath-Feld auf die übliche Weise verwendet wird (siehe Verarbeitung von Eingabe und Ausgabe).

{ "Comment": "Parallel Example.", "StartAt": "FunWithMath", "States": { "FunWithMath": { "Type": "Parallel", "End": true, "Branches": [ { "StartAt": "Add", "States": { "Add": { "Type": "Task", "Resource": "arn:aws:states:us-east-1:123456789012:activity:Add", "End": true } } }, { "StartAt": "Subtract", "States": { "Subtract": { "Type": "Task", "Resource": "arn:aws:states:us-east-1:123456789012:activity:Subtract", "End": true } } } ] } } }

Wenn dem Zustand FunWithMath das Array [3, 2] als Eingabe übergeben wird, dann erhalten die Zustände Add und Subtract dieses Array als Eingabe. Die -Ausgabe vonAddundSubtractaufgaben wären die Summe von und der Unterschied zwischen den Array-Elementen 3 und 2, was ist5und1, während die Ausgabe desParallelstate wäre ein Array.

[ 5, 1 ]

Fehlerbehandlung

Wenn eine der Verzweigungen aufgrund eines unbehandelten Fehlers oder durch den Übergang zu einem Fail-Zustand fehlschlägt, wird der gesamte Parallel-Zustand als fehlgeschlagen betrachtet und alle seine Verzweigungen werden gestoppt. Wenn der Fehler nicht vonParallel-Status selbst stoppt Step Functions die Ausführung mit einem Fehler.

Anmerkung

Bei Ausfall eines parallel Status werden die aufgerufenen Lambda-Funktionen weiterhin ausgeführt und Aktivitäts-Worker, die ein Aufgabentoken verarbeiten, werden nicht gestoppt.

  • Verwenden Sie Heartbeats zum Anhalten lange andauernder Aktivitäten, um zu erkennen, ob die Verzweigung von Step Functions angehalten wurde, und halten Sie Worker an, die Aufgaben verarbeiten. Durch das Aufrufen von SendTaskHeartbeat, SendTaskSuccess oder SendTaskFailure wird ein Fehler gemeldet, wenn der Status einen Fehler aufweist. Weitere Informationen finden Sie unter Heartbeat-Fehler.

  • Das Ausführen von Lambda-Funktionen kann nicht angehalten werden. Wenn Sie einen Fallback implementiert haben, verwenden Sie eineWaitGeben Sie an, dass die Bereinigung nach Fertigstellen der Lambda-Funktion erfolgt.