ItemsPath ( JSONPath Nur Karte) - 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.

ItemsPath ( JSONPath Nur Karte)

Status verwalten und Daten transformieren

Diese Seite bezieht sich auf JSONPath. Step Functions hat kürzlich Variablen hinzugefügt und JSONata dient der Verwaltung von Zustands- und Transformationsdaten.

Erfahren Sie mehr über das Übergeben von Daten mit Variablen und das Transformieren von Daten mit JSONata.

Verwenden Sie in JSONPath basierten Zuständen das ItemsPath Feld, um ein Array oder Objekt innerhalb einer JSON-Eingabe auszuwählen, die für einen Map Status bereitgestellt wird. Standardmäßig ist der Map Status ItemsPath auf festgelegt$, wodurch die gesamte Eingabe ausgewählt wird.

  • Wenn es sich bei der Eingabe für den Map Status um ein JSON-Array handelt, wird für jedes Element im Array eine Iteration ausgeführt und dieses Element als Eingabe an die Iteration übergeben

  • Wenn es sich bei der Eingabe für den Map Status um ein JSON-Objekt handelt, führt es eine Iteration für jedes Schlüssel-Wert-Paar im Objekt durch und übergibt das Paar als Eingabe an die Iteration

Anmerkung

Sie können ItemsPath im Status Distributed Map nur verwenden, wenn Sie eine JSON-Eingabe verwenden, die aus einem früheren Status im Workflow übergeben wurde.

Der Wert von ItemsPath muss ein Referenzpfad sein, und dieser Pfad muss zu einem JSON-Array oder Objekt ausgewertet werden. Erwägen Sie beispielsweise die Eingabe in einen Map-Zustand, der zwei Arrays enthält, wie im folgenden Beispiel.

{
  "ThingsPiratesSay": [
    {
      "say": "Avast!"
    },
    {
      "say": "Yar!"
    },
    {
      "say": "Walk the Plank!"
    }
  ],
  "ThingsGiantsSay": [
    {
      "say": "Fee!"
    },
    {
      "say": "Fi!"
    },
    {
      "say": "Fo!"
    },
    {
      "say": "Fum!"
    }
  ]
}

In diesem Fall könnten Sie angeben, welches Array für Map State-Iterationen verwendet werden soll, indem Sie es mit ItemsPath auswählen. Die folgende State-Machine-Definition spezifiziert das ThingsPiratesSay Array in der Eingabe mithilfe von ItemsPath .IT. Anschließend wird für jedes Element im Array eine Iteration des SayWord Pass-Status ausgeführt. ThingsPiratesSay

{
  "StartAt": "PiratesSay",
  "States": {
    "PiratesSay": {
      "Type": "Map",
      "ItemsPath": "$.ThingsPiratesSay",
      "ItemProcessor": {
         "StartAt": "SayWord",
         "States": {
           "SayWord": {
             "Type": "Pass",
             "End": true
           }
         }
      },
      "End": true
    }
  }
}

Bei verschachtelten JSON-Objekten können Sie ItemsPath damit ein bestimmtes Objekt innerhalb der Eingabe auswählen. Betrachten Sie die folgende Eingabe mit verschachtelten Konfigurationsdaten:

{
  "environment": "production",
  "servers": {
    "web": {
      "server1": {"port": 80, "status": "active"},
      "server2": {"port": 8080, "status": "inactive"}
    },
    "database": {
      "primary": {"host": "db1.example.com", "port": 5432},
      "replica": {"host": "db2.example.com", "port": 5432}
    }
  }
}

Um über das Webserver-Objekt zu iterieren, würden Sie Folgendes einstellenItemsPath: $.servers.web

{
  "StartAt": "ProcessWebServers",
  "States": {
    "ProcessWebServers": {
      "Type": "Map",
      "ItemsPath": "$.servers.web",
      "ItemProcessor": {
         "StartAt": "CheckServer",
         "States": {
           "CheckServer": {
             "Type": "Pass",
             "End": true
           }
         }
      },
      "End": true
    }
  }
}

Bei der Verarbeitung von Eingaben gilt der Map Status ItemsPath danach InputPath. Er arbeitet mit der tatsächlichen Eingabe in den Status, nachdem die Eingabe InputPath gefiltert wurde.

Weitere Informationen zu Map-Zuständen finden Sie im Folgenden: