

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

# Sinkronkan

Dokumen pemetaan `Sync` permintaan memungkinkan Anda mengambil semua hasil dari tabel DynamoDB dan kemudian menerima hanya data yang diubah sejak kueri terakhir Anda (pembaruan delta). `Sync`permintaan hanya dapat dibuat ke sumber data DynamoDB berversi. Anda dapat menentukan sebagai berikut:
+ Filter untuk mengecualikan hasil
+ Berapa banyak barang yang harus dikembalikan
+ Token Paginasi
+ Ketika `Sync` operasi terakhir Anda dimulai

Dok `Sync` umen pemetaan memiliki struktur sebagai berikut:

```TypeScript
{
    "version" : "2018-05-29",
    "operation" : "Sync",
    "basePartitionKey": "Base Tables PartitionKey",
    "deltaIndexName": "delta-index-name",
    "limit" : 10,
    "nextToken" : "aPaginationToken",
    "lastSync" :  1550000000000,
    "filter" : {
        ...
    }
}
```

Bidang didefinisikan sebagai berikut:

## Sinkronisasi bidang
<a name="sync-list"></a>

### Daftar bidang sinkronisasi
<a name="sync-list-col"></a>

** `version` **  
Versi definisi template. Hanya saat `2018-05-29` ini didukung. Nilai ini diperlukan.

** `operation` **  
Operasi DynamoDB untuk melakukan. Untuk melakukan `Sync` operasi, ini harus diatur ke`Sync`. Nilai ini diperlukan.

** `filter` **  
Filter yang dapat digunakan untuk memfilter hasil dari DynamoDB sebelum dikembalikan. Untuk informasi selengkapnya tentang filter, lihat [ Filter](aws-appsync-resolver-mapping-template-reference-dynamodb-filter.md). Ini adalah bidang opsional.

** `limit` **  
Jumlah maksimum item untuk dievaluasi pada satu waktu. Ini adalah bidang 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. Ini adalah bidang opsional.

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

**`basePartitionKey`**  
Kunci partisi dari * tabel * Base digunakan saat melakukan `Sync` operasi. Bidang ini memungkinkan `Sync` operasi dilakukan ketika tabel menggunakan kunci partisi khusus. Ini adalah bidang opsional.

**`deltaIndexName`**  
Indeks yang digunakan untuk `Sync` operasi. Indeks ini diperlukan untuk mengaktifkan `Sync` operasi pada seluruh tabel penyimpanan delta ketika tabel menggunakan kunci partisi khusus. `Sync`Operasi akan dilakukan pada GSI (dibuat pada `gsi_ds_pk` dan`gsi_ds_sk`). Ini adalah bidang opsional.

Hasil yang dikembalikan oleh sinkronisasi 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). ](aws-appsync-resolver-mapping-template-reference-dynamodb-typed-values-responses.md)

Untuk informasi selengkapnya tentang templat pemetaan respons, lihat ikhtisar templ [ at pemetaan Resolver. ](resolver-mapping-template-reference-overview.md#aws-appsync-resolver-mapping-template-reference-overview)

Hasilnya memiliki struktur sebagai berikut:

```TypeScript
{
    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 resolver yang berbeda.

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

** `startedAt` **  
Momen, dalam milidetik zaman, 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
<a name="id14"></a>

Contoh berikut adalah template pemetaan untuk kueri 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 yang `lastSync` dikembalikan.

```TypeScript
{
    "version" : "2018-05-29",
    "operation" : "Sync",
    "limit": 100,
    "nextToken": $util.toJson($util.defaultIfNull($ctx.args.nextToken, null)),
    "lastSync": $util.toJson($util.defaultIfNull($ctx.args.lastSync, null))
}
```