TransactGetItems - AWS AppSync GraphQL
TransactGetItems bidang

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

TransactGetItems

Dokumen pemetaan TransactGetItems permintaan memungkinkan Anda memberi tahu AWS AppSync DynamoDB resolver untuk membuat TransactGetItems permintaan ke DynamoDB untuk mengambil beberapa item, berpotensi di beberapa tabel. Untuk templat permintaan ini, Anda harus menentukan yang berikut:

  • Nama tabel dari setiap item permintaan tempat untuk mengambil item dari

  • Kunci dari setiap item permintaan untuk diambil dari setiap tabel

Batas TransactGetItems DynamoDB berlaku dan tidak ada ekspresi kondisi yang dapat diberikan.

Dokumen TransactGetItems pemetaan memiliki struktur sebagai berikut:

{
    "version": "2018-05-29",
    "operation": "TransactGetItems",
    "transactItems": [
       ## First request item
       {
           "table": "table1",
           "key": {
               "foo": ... typed value,
               "bar": ... typed value
           },
           "projection" : {
                ...
           }
       },
       ## Second request item
       {
           "table": "table2",
           "key": {
               "foo": ... typed value,
               "bar": ... typed value
           },
           "projection" : {
                ...
           }
       }
    ]
}

Bidang didefinisikan sebagai berikut:

TransactGetItems bidang

version

Versi definisi template. Hanya 2018-05-29 didukung. Nilai ini diperlukan.

operation

Operasi DynamoDB untuk melakukan. Untuk melakukan operasi TransactGetItems DynamoDB, ini harus diatur ke. TransactGetItems Nilai ini diperlukan.

transactItems

Item permintaan untuk disertakan. Nilai adalah array item permintaan. Setidaknya satu item permintaan harus disediakan. transactItemsNilai ini diperlukan.

table

Tabel DynamoDB untuk mengambil item dari. Nilai adalah string dari nama tabel. tableNilai ini diperlukan.

key

Kunci DynamoDB mewakili kunci utama item yang akan diambil. Item DynamoDB mungkin memiliki kunci hash tunggal, atau kunci hash dan kunci sortir, tergantung pada struktur tabel. Untuk informasi selengkapnya tentang cara menentukan “nilai yang diketik”, lihat Mengetik sistem (pemetaan permintaan).

projection

Proyeksi yang digunakan untuk menentukan atribut untuk kembali dari operasi DynamoDB. Untuk informasi selengkapnya tentang proyeksi, lihat Proyeksi. Bidang ini bersifat opsional.

Hal-hal yang perlu diingat:

  • Jika transaksi berhasil, urutan item yang diambil di items blok akan sama dengan urutan item permintaan.

  • Transaksi dilakukan dengan all-or-nothing cara tertentu. Jika ada item permintaan yang menyebabkan kesalahan, seluruh transaksi tidak akan dilakukan dan rincian kesalahan akan dikembalikan.

  • Item permintaan yang tidak dapat diambil bukanlah kesalahan. Sebagai gantinya, elemen null muncul di blok item di posisi yang sesuai.

  • Jika kesalahan transaksi adalah TransactionCanceledException, cancellationReasons blok akan diisi. Urutan alasan pembatalan di cancellationReasons blok akan sama dengan urutan item permintaan.

  • TransactGetItemsterbatas pada 100 item permintaan.

Untuk contoh template pemetaan permintaan berikut:

{
    "version": "2018-05-29",
    "operation": "TransactGetItems",
    "transactItems": [
       ## First request item
       {
           "table": "posts",
           "key": {
               "post_id": {
                 "S": "p1"
               }
           }
       },
       ## Second request item
       {
           "table": "authors",
           "key": {
               "author_id": {
                 "S": a1
               }
           }
       }
    ]
}

Jika transaksi berhasil dan hanya item yang diminta pertama yang diambil, hasil pemanggilan yang tersedia adalah sebagai berikut: $ctx.result

{
    "items": [
       {
           // Attributes of the first requested item
           "post_id": "p1",
           "post_title": "title",
           "post_description": "description"
       },
       // Could not retrieve the second requested item
       null,
    ],
    "cancellationReasons": null
}

Jika transaksi gagal karena TransactionCanceledExceptiondisebabkan oleh item permintaan pertama, hasil pemanggilan yang tersedia $ctx.result adalah sebagai berikut:

{
    "items": null,
    "cancellationReasons": [
       {
           "type":"Sample error type",
           "message":"Sample error message"
       },
       {
           "type":"None",
           "message":"None"
       }
    ]
}

$ctx.errorBerisi rincian tentang kesalahan. Item kunci dan CancellationReasons dijamin akan hadir di. $ctx.result

Untuk contoh yang lebih lengkap, ikuti tutorial Transaksi DynamoDB AppSync dengan tutorial di sini: DynamoDB transaction resolvers.