Utilizzo dei percorsi per accedere all'input per i flussi di lavoro Step Functions - AWS Step Functions
Percorsi di riferimento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dei percorsi per accedere all'input per i flussi di lavoro Step Functions

In Amazon States Language, un percorso è una stringa che inizia con e $ che puoi utilizzare per identificare i componenti all'interno JSON del testo. I percorsi seguono la JsonPathsintassi. È possibile specificare un percorso per accedere a sottoinsiemi di input quando si specificano i valori di InputPath, ResultPath e OutputPath. Per ulteriori informazioni, consulta Elaborazione di input e output in Step Functions.

Nota

È inoltre possibile specificare un JSON nodo dell'input o dell'oggetto contestuale utilizzando percorsi all'interno del Parameters campo di una definizione di stato. Per informazioni, consulta Passaggio di parametri a un servizio API in Step Functions.

È necessario utilizzare la notazione tra parentesi quadre se il nome del campo contiene caratteri non inclusi nella member-name-shorthand definizione della JsonPath ABNFregola. Pertanto, per codificare caratteri speciali, come i segni di punteggiatura (esclusi_), è necessario utilizzare la notazione tra parentesi quadre. Ad esempio $.abc.['def ghi'].

Percorsi di riferimento

Un percorso di riferimento è un percorso la cui sintassi è limitata in modo tale da poter identificare solo un singolo nodo in una struttura: JSON

  • Puoi accedere a campi di oggetto unicamente con la notazione del punto (.) e tra parentesi quadra ([ ]).

  • Le funzioni come length() non sono supportate.

  • Operatori lessicali, che non sono simbolici, ad esempio non sono supportati. subsetof

  • Il filtraggio mediante espressioni regolari o facendo riferimento a un altro valore nella struttura non è JSON supportato.

  • Gli operatori@, ,:, e non ? sono supportati

Ad esempio, se i dati di input dello stato contengono i seguenti valori:

{
  "foo": 123,
  "bar": ["a", "b", "c"],
  "car": {
      "cdr": true
  }
}

I percorsi di riferimento seguenti restituirebbero quanto segue.

$.foo => 123
$.bar => ["a", "b", "c"]
$.car.cdr => true

Alcuni stati utilizzano percorsi e percorsi di riferimento per controllare il flusso di una macchina a stati o configurare impostazioni o opzioni di uno stato. Per ulteriori informazioni, vedere Modellazione dell'elaborazione del percorso di input e output del flusso di lavoro con il simulatore di flusso di dati e Utilizzo JSONPath efficace in. AWS Step Functions

Appiattimento di una serie di array

Se lo Stato del flusso di lavoro della mappa stato Stato del flusso di lavoro parallelo o nelle tue macchine a stati restituisce un array di array, puoi trasformarli in una matrice piatta con il campo. ResultSelector Puoi includere questo campo nella definizione dello stato Parallel o Map per manipolare il risultato di questi stati.

Per appiattire gli array, utilizzate la JMESPathsintassi del ResultSelector campo, come illustrato [*] nell'esempio seguente.

"ResultSelector": {
    "flattenArray.$": "$[*][*]"
  }

Per esempi che mostrano come appiattire un array, consultate il passaggio 3 nei seguenti tutorial: