Menggunakan jalur untuk mengakses input untuk alur kerja Step Functions - AWS Step Functions
Jalur Referensi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan jalur untuk mengakses input untuk alur kerja Step Functions

Di Amazon States Language, path adalah string yang dimulai dengan $ yang dapat Anda gunakan untuk mengidentifikasi komponen dalam JSON teks. Jalur mengikuti JsonPathsintaks. Anda dapat menentukan jalur untuk mengakses himpunan bagian dari input ketika menentukan nilai untuk InputPath, ResultPath, dan OutputPath. Untuk informasi selengkapnya, lihat Memproses input dan output di Step Functions.

catatan

Anda juga dapat menentukan JSON simpul input atau objek konteks dengan menggunakan jalur dalam Parameters bidang definisi negara. Lihat Meneruskan parameter ke layanan API di Step Functions.

Anda harus menggunakan notasi kurung siku jika nama bidang Anda berisi karakter apa pun yang tidak termasuk dalam member-name-shorthand definisi aturan. JsonPath ABNF Oleh karena itu, untuk menyandikan karakter khusus, seperti tanda baca (tidak termasuk_), Anda harus menggunakan notasi braket siku. Misalnya, $.abc.['def ghi'].

Jalur Referensi

Jalur referensi adalah jalur yang sintaksnya terbatas sedemikian rupa sehingga hanya dapat mengidentifikasi satu simpul dalam JSON struktur:

  • Anda dapat mengakses bidang objek hanya menggunakan notasi titik (.) dan kurung persegi ([ ]).

  • Fungsi seperti length() tidak didukung.

  • Operator leksikal, yang non-simbolis, seperti subsetof tidak didukung.

  • Pemfilteran dengan ekspresi reguler atau dengan mereferensikan nilai lain dalam JSON struktur tidak didukung.

  • Operator@, ,:,, dan ? tidak didukung

Misalnya, jika data input status berisi nilai berikut:

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

Jalur referensi berikut akan mengembalikan berikut.

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

Status tertentu menggunakan jalur dan jalur referensi untuk mengontrol aliran mesin status atau mengonfigurasi pengaturan status atau opsi. Untuk informasi selengkapnya, lihat Pemodelan alur kerja input dan pemrosesan jalur output dengan simulator aliran data dan Menggunakan JSONPath secara efektif di AWS Step Functions.

Meratakan array array

Jika Memetakan status alur kerja status Status alur kerja paralel atau di mesin status Anda mengembalikan array array, Anda dapat mengubahnya menjadi array datar dengan ResultSelector bidang. Anda dapat menyertakan bidang ini di dalam definisi status Paralel atau Peta untuk memanipulasi hasil status ini.

Untuk meratakan array, gunakan JMESPathsintaks [*] di ResultSelector bidang seperti yang ditunjukkan pada contoh berikut.

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

Untuk contoh yang menunjukkan cara meratakan array, lihat Langkah 3 dalam tutorial berikut: