Sinkronkan

Objek Sync permintaan memungkinkan Anda mengambil semua hasil dari tabel DynamoDB dan kemudian hanya menerima data yang diubah sejak kueri terakhir Anda (pembaruan delta). Syncpermintaan hanya dapat dibuat ke sumber data DynamoDB berversi. Anda dapat menentukan sebagai berikut:

• Filter untuk mengecualikan hasil

• Berapa banyak item yang akan dikembalikan

• Token Paginasi

• Ketika Sync operasi terakhir Anda dimulai

Objek Sync permintaan memiliki struktur berikut:

type DynamoDBSyncRequest = {
  operation: 'Sync';
  basePartitionKey?: string;
  deltaIndexName?: string;
  limit?: number;
  nextToken?: string;
  lastSync?: number;
  filter?: {
    expression: string;
    expressionNames?: { [key: string]: string };
    expressionValues?: { [key: string]: any };
  };
};

Bidang didefinisikan sebagai berikut:

Bidang sinkronisasi

Daftar bidang sinkronisasi

operation

Operasi DynamoDB untuk melakukan. Untuk melakukan Sync operasi, ini harus diatur keSync. Nilai ini diperlukan.

filter

Filter yang dapat digunakan untuk memfilter hasil dari DynamoDB sebelum dikembalikan. Untuk informasi selengkapnya tentang filter, lihat Menyaring. Bidang ini bersifat opsional.

limit

Jumlah maksimum item untuk dievaluasi pada satu waktu. Bidang ini bersifat opsional. Jika dihilangkan, batas default akan diatur ke 100 item. Nilai maksimum untuk bidang ini adalah 1000 item.

nextToken

Token pagination untuk melanjutkan kueri sebelumnya. Ini akan diperoleh dari kueri sebelumnya. Bidang ini bersifat opsional.

lastSync

Momen, dalam milidetik zaman, ketika Sync operasi sukses terakhir dimulai. Jika ditentukan, hanya item yang telah berubah setelah lastSync dikembalikan. Bidang ini opsional, dan hanya boleh diisi setelah mengambil semua halaman dari operasi awalSync. Jika dihilangkan, hasil dari tabel Base akan dikembalikan, jika tidak, hasil dari tabel Delta akan dikembalikan.

basePartitionKey

Kunci partisi dari tabel Basis yang digunakan saat melakukan Sync operasi. Bidang ini memungkinkan Sync operasi yang akan dilakukan ketika tabel menggunakan kunci partisi kustom. Ini adalah bidang opsional.

deltaIndexName

Indeks yang digunakan untuk Sync operasi. Indeks ini diperlukan untuk mengaktifkan Sync operasi di seluruh tabel penyimpanan delta saat tabel menggunakan kunci partisi khusus. SyncOperasi akan dilakukan pada GSI (dibuat pada gsi_ds_pk dangsi_ds_sk). Bidang ini bersifat opsional.

Daftar bidang sinkronisasi

operation

Operasi DynamoDB untuk melakukan. Untuk melakukan Sync operasi, ini harus diatur keSync. Nilai ini diperlukan.

filter

Filter yang dapat digunakan untuk memfilter hasil dari DynamoDB sebelum dikembalikan. Untuk informasi selengkapnya tentang filter, lihat Menyaring. Bidang ini bersifat opsional.

limit

Jumlah maksimum item untuk dievaluasi pada satu waktu. Bidang ini bersifat opsional. Jika dihilangkan, batas default akan diatur ke 100 item. Nilai maksimum untuk bidang ini adalah 1000 item.

nextToken

Token pagination untuk melanjutkan kueri sebelumnya. Ini akan diperoleh dari kueri sebelumnya. Bidang ini bersifat opsional.

lastSync

Momen, dalam milidetik zaman, ketika Sync operasi sukses terakhir dimulai. Jika ditentukan, hanya item yang telah berubah setelah lastSync dikembalikan. Bidang ini opsional, dan hanya boleh diisi setelah mengambil semua halaman dari operasi awalSync. Jika dihilangkan, hasil dari tabel Base akan dikembalikan, jika tidak, hasil dari tabel Delta akan dikembalikan.

basePartitionKey

Kunci partisi dari tabel Basis yang digunakan saat melakukan Sync operasi. Bidang ini memungkinkan Sync operasi yang akan dilakukan ketika tabel menggunakan kunci partisi kustom. Ini adalah bidang opsional.

deltaIndexName

Indeks yang digunakan untuk Sync operasi. Indeks ini diperlukan untuk mengaktifkan Sync operasi di seluruh tabel penyimpanan delta saat tabel menggunakan kunci partisi khusus. SyncOperasi akan dilakukan pada GSI (dibuat pada gsi_ds_pk dangsi_ds_sk). Bidang ini bersifat opsional.

Hasil yang dikembalikan oleh sinkronisasi DynamoDB secara otomatis diubah menjadi tipe primitif GraphQL dan 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.

Hasilnya memiliki struktur sebagai berikut:

{
    items = [ ... ],
    nextToken = "a pagination token",
    scannedCount = 10,
    startedAt = 1550000000000
}

Bidang didefinisikan sebagai berikut:

items

Daftar yang berisi item yang dikembalikan oleh sinkronisasi.

nextToken

Jika mungkin ada lebih banyak hasil, nextToken berisi token pagination yang dapat Anda gunakan dalam permintaan lain. AWS AppSync mengenkripsi dan mengaburkan token pagination yang dikembalikan dari DynamoDB. Ini mencegah data tabel Anda bocor secara tidak sengaja ke penelepon. Selain itu, token pagination ini tidak dapat digunakan di berbagai fungsi atau resolver.

scannedCount

Jumlah item yang diambil oleh DynamoDB sebelum ekspresi filter (jika ada) diterapkan.

startedAt

Saat ini, dalam milidetik epoch, ketika operasi sinkronisasi dimulai yang dapat Anda simpan secara lokal dan gunakan dalam permintaan lain sebagai argumen Anda. lastSync Jika token pagination disertakan dalam permintaan, nilai ini akan sama dengan yang dikembalikan oleh permintaan untuk halaman pertama hasil.

Contoh

Contoh berikut adalah handler permintaan fungsi untuk query GraphQL:. syncPosts(nextToken: String, lastSync: AWSTimestamp)

Dalam contoh ini, jika lastSync dihilangkan, semua entri dalam tabel dasar dikembalikan. Jika lastSync disediakan, hanya entri dalam tabel sinkronisasi delta yang telah berubah sejak itu lastSync dikembalikan.

export function request(ctx) {
  const { nextToken, lastSync } = ctx.args;
  return { operation: 'Sync', limit: 100, nextToken, lastSync };
}