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

Menggunakan status Peta dalam mode Inline

Secara default, Map status berjalan dalam mode Inline. Dalam mode Inline, status Peta hanya menerima array JSON sebagai input. Ia menerima array ini dari langkah sebelumnya dalam alur kerja. Dalam mode ini, setiap iterasi Map status berjalan dalam konteks alur kerja yang berisi status. Map Step Functions menambahkan riwayat eksekusi iterasi ini ke riwayat eksekusi alur kerja induk.

Dalam mode ini, Map status mendukung hingga 40 iterasi bersamaan.

MapStatus yang disetel ke Inline dikenal sebagai status Peta Inline. Gunakan Map status dalam mode Inline jika riwayat eksekusi alur kerja Anda tidak akan melebihi 25.000 entri, atau jika Anda tidak memerlukan lebih dari 40 iterasi bersamaan.

Untuk pengenalan menggunakan status Peta Inline, lihat tutorialnyaUlangi tindakan menggunakan status Peta Inline.

Konsep kunci dalam topik ini

Bidang status Peta Inline

Untuk menggunakan status Peta Sebaris dalam alur kerja Anda, tentukan satu atau beberapa bidang ini. Anda menentukan bidang ini selain bidang status umum.

Bidang usang

Contoh status Peta Sebaris

Pertimbangkan data input berikut untuk Map status yang berjalan dalam mode Inline.

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

Mengingat masukan sebelumnya, Map status dalam contoh berikut memanggil AWS Lambda fungsi bernama ship-val sekali untuk setiap item array di shipped bidang.

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

Setiap iterasi Map status mengirimkan item dalam array, dipilih dengan ItemsPathbidang, sebagai input ke fungsi ship-val Lambda. Nilai-nilai berikut adalah contoh masukan yang dikirimkan Map status ke pemanggilan fungsi Lambda:

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

Setelah selesai, output status Map adalah array JSON, saat setiap item adalah output dari perulangan. Dalam hal ini, array ini berisi output dari fungsi ship-val Lambda.

Contoh status Peta Sebaris dengan ItemSelector

Misalkan fungsi ship-val Lambda pada contoh sebelumnya juga membutuhkan informasi tentang kurir pengiriman. Informasi ini merupakan tambahan untuk item dalam array untuk setiap iterasi. Anda dapat menyertakan informasi dari input, bersama dengan informasi khusus untuk iterasi Map status saat ini. Perhatikan ItemSelector bidang dalam contoh berikut:

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

ItemSelectorBlok menggantikan input ke iterasi dengan node JSON. Node ini berisi data item saat ini dari objek konteks dan informasi kurir dari delivery-partner bidang input Map status. Berikut ini adalah contoh input ke iterasi tunggal. MapStatus meneruskan input ini ke pemanggilan fungsi Lambdaship-val.

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

Dalam contoh status Peta Inline sebelumnya, ResultPath bidang menghasilkan output dalam format yang sama dengan input. Namun, ia menimpa detail.shipped bidang dengan array di mana setiap elemen adalah output dari setiap pemanggilan Lambda ship-val iterasi.

Untuk informasi selengkapnya tentang penggunaan status Peta Sebaris dan bidangnya, lihat berikut ini.

Pemrosesan input dan output Map status sebaris

Untuk Map status tertentu, InputPathpilih subset dari masukan negara.

Masukan dari sebuah Map negara harus menyertakan array JSON. MapStatus menjalankan ItemProcessor bagian satu kali untuk setiap item dalam array. Jika Anda menentukan ItemsPathbidang, Map status memilih di mana di input untuk menemukan array untuk diulang. Jika tidak ditentukan, nilai ItemsPath berupa $, dan bagian ItemProcessor berharap agar array adalah satu-satunya input. Jika Anda menentukan ItemsPath bidang, nilainya harus berupa Jalur Referensi. MapStatus menerapkan jalur ini ke input efektif setelah menerapkanInputPath. ItemsPathHarus mengidentifikasi bidang yang nilainya adalah array JSON.

Masukan untuk setiap iterasi, secara default, adalah elemen tunggal dari bidang array yang diidentifikasi oleh ItemsPath nilai. Anda dapat mengganti nilai ini dengan ItemSelector bidang.

Setelah selesai, output status Map adalah array JSON, saat setiap item adalah output dari perulangan.

Untuk informasi selengkapnya tentang input dan output status Peta Inline, lihat berikut ini: