GetItem - AWS AppSync
GetItem bidangContoh

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

GetItem

GetItemPermintaan memungkinkan Anda memberi tahu fungsi 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

GetItemPermintaan memiliki struktur sebagai berikut:

type DynamoDBGetItem = {
  operation: 'GetItem';
  key: { [key: string]: any };
  consistentRead?: ConsistentRead;
  projection?: {
    expression: string;
    expressionNames?: { [key: string]: string };
  };
};

Bidang didefinisikan sebagai berikut:

GetItem bidang

operation

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

key

Kunci item di DynamoDB. 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). Nilai ini diperlukan.

consistentRead

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

projection

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

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

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

Untuk informasi selengkapnya tentang JavaScript resolver, lihat ikhtisar JavaScript resolver.

Contoh

Contoh berikut adalah handler permintaan fungsi untuk query GraphQL: getThing(foo: String!, bar: String!)

export function request(ctx) {
  const {foo, bar} = ctx.args
  return {
    operation : "GetItem",
    key : util.dynamodb.toMapValues({foo, bar}),
    consistentRead : true
  }
}

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