View a markdown version of this page

GetItem - AWS AppSync GraphQL
GetItem bidangContoh

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

GetItem

Dokumen pemetaan GetItem permintaan memungkinkan Anda memberi tahu resolver AWS AppSync DynamoDB untuk membuat GetItem permintaan ke DynamoDB, dan memungkinkan Anda untuk menentukan:

  • Kunci item di DynamoDB

  • Apakah akan menggunakan bacaan yang konsisten atau tidak

Dok GetItem umen pemetaan memiliki struktur sebagai berikut:

{
    "version" : "2017-02-28",
    "operation" : "GetItem",
    "key" : {
        "foo" : ... typed value,
        "bar" : ... typed value
    },
    "consistentRead" : true,
    "projection" : {
        ...
    }
}

Bidang didefinisikan sebagai berikut:

GetItem bidang

version

Versi definisi template. 2017-02-28dan 2018-05-29 saat ini didukung. Nilai ini diperlukan.

operation

Operasi DynamoDB untuk melakukan. Untuk melakukan operasi GetItem DynamoDB, ini harus disetel ke. GetItem Nilai ini diperlukan.

key

Kunci item di DynamoDB. Item DynamoDB mungkin memiliki kunci hash tunggal, atau kunci hash dan kunci pengurutan, tergantung pada struktur tabel. Untuk informasi selengkapnya tentang cara menentukan “nilai yang diketik”, lihat Sistem tipe (pemetaan permintaan). Nilai ini diperlukan.

consistentRead

Apakah akan melakukan pembacaan yang sangat konsisten dengan DynamoDB atau tidak. Ini opsional, dan defaultnya. false

projection

Proyeksi yang digunakan untuk menentukan atribut yang akan dikembalikan dari operasi DynamoDB. Untuk informasi selengkapnya tentang proyeksi, lihat Pro yeksi. Ini adalah bidang opsional.

Item yang dikembalikan dari DynamoDB secara otomatis diubah menjadi tipe primitif GraphQL dan JSON, dan tersedia dalam konteks pemetaan (). $context.result

Untuk informasi selengkapnya tentang konversi tipe DynamoDB, lihat Sistem tipe (pemetaan respons).

Untuk informasi selengkapnya tentang templat pemetaan respons, lihat ikhtisar templ at pemetaan Resolver.

Contoh

Contoh berikut adalah template pemetaan untuk kueri GraphQL: getThing(foo: String!, bar: String!)

{
    "version" : "2017-02-28",
    "operation" : "GetItem",
    "key" : {
        "foo" : $util.dynamodb.toDynamoDBJson($ctx.args.foo),
        "bar" : $util.dynamodb.toDynamoDBJson($ctx.args.bar)
    },
    "consistentRead" : true
}

Untuk informasi selengkapnya tentang DynamoDB GetItem API, lihat dokumentasi DynamoDB API.