Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pindai
Per Scan mintaan memungkinkan Anda memberi tahu fungsi AWS AppSync DynamoDB untuk membuat Scan permintaan ke DynamoDB, dan memungkinkan Anda untuk menentukan yang berikut:
-
Filter untuk mengecualikan hasil
-
Indeks mana yang akan digunakan
-
Berapa banyak barang yang harus dikembalikan
-
Apakah akan menggunakan bacaan yang konsisten
-
Token paginasi
-
Pemindaian paralel
Ob Scan jek permintaan memiliki struktur sebagai berikut:
type DynamoDBScanRequest = { operation: 'Scan'; index?: string; limit?: number; consistentRead?: boolean; nextToken?: string; totalSegments?: number; segment?: number; filter?: { expression: string; expressionNames?: { [key: string]: string }; expressionValues?: { [key: string]: any }; }; projection?: { expression: string; expressionNames?: { [key: string]: string }; }; };
Bidang didefinisikan sebagai berikut:
Pindai bidang
-
operation -
Operasi DynamoDB untuk melakukan. Untuk melakukan operasi
ScanDynamoDB, ini harus disetel ke.ScanNilai ini diperlukan. -
filter -
Filter yang dapat digunakan untuk memfilter hasil dari DynamoDB sebelum dikembalikan. Untuk informasi selengkapnya tentang filter, lihat Filter. Ini adalah bidang opsional.
-
index -
Nama indeks untuk kueri. Operasi kueri DynamoDB memungkinkan Anda untuk memindai Indeks Sekunder Lokal dan Indeks Sekunder Global selain indeks kunci utama untuk kunci hash. Jika ditentukan, ini memberitahu DynamoDB untuk menanyakan indeks yang ditentukan. Jika dihilangkan, indeks kunci utama ditanyakan.
-
limit -
Jumlah maksimum item untuk dievaluasi pada satu waktu. Ini adalah bidang opsional.
-
consistentRead -
Sebuah Boolean yang menunjukkan apakah akan menggunakan pembacaan yang konsisten saat menanyakan DynamoDB. Bidang ini opsional, dan defaultnya.
false -
nextToken -
Token pagination untuk melanjutkan kueri sebelumnya. Ini akan diperoleh dari kueri sebelumnya. Ini adalah bidang opsional.
-
select -
Secara default, fungsi AWS AppSync DynamoDB hanya mengembalikan atribut apa pun yang diproyeksikan ke dalam indeks. Jika lebih banyak atribut diperlukan, maka bidang ini dapat diatur. Ini adalah bidang opsional. Nilai yang didukung adalah:
-
ALL_ATTRIBUTES -
Mengembalikan semua atribut item dari tabel atau indeks yang ditentukan. Jika Anda menanyakan indeks sekunder lokal, DynamoDB mengambil seluruh item dari tabel induk untuk setiap item yang cocok dalam indeks. Jika indeks dikonfigurasi untuk memproyeksikan semua atribut item, semua data dapat diperoleh dari indeks sekunder lokal dan tidak diperlukan pengambilan.
-
ALL_PROJECTED_ATTRIBUTES -
Diizinkan hanya saat menanyakan indeks. Mengambil semua atribut yang telah diproyeksikan ke dalam indeks. Jika indeks dikonfigurasi untuk memproyeksikan semua atribut, nilai pengembalian ini setara dengan menentukan
ALL_ATTRIBUTES. SPECIFIC_ATTRIBUTES-
Mengembalikan hanya atribut yang tercantum dalam
projection'sexpression. Nilai pengembalian ini setara dengan menentukan nilaiprojectionexpressiontanpa menentukan nilai apa pun untukSelect.
-
-
totalSegments -
Jumlah segmen untuk mempartisi tabel saat melakukan pemindaian paralel. Bidang ini opsional, tetapi harus ditentukan jika
segmentditentukan. -
segment -
Segmen tabel dalam operasi ini saat melakukan pemindaian paralel. Bidang ini opsional, tetapi harus ditentukan jika
totalSegmentsditentukan. 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.
Hasil yang dikembalikan oleh pemindaian 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 Sistem tipe (pemetaan respons).
Untuk informasi selengkapnya tentang JavaScript resolver, lihat ikhtisar JavaScript resolver.
Hasilnya memiliki struktur sebagai berikut:
{ items = [ ... ], nextToken = "a pagination token", scannedCount = 10 }
Bidang didefinisikan sebagai berikut:
-
items -
Daftar yang berisi item yang dikembalikan oleh pemindaian DynamoDB.
-
nextToken -
Jika mungkin ada lebih banyak hasil,
nextTokenberisi 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.
Contoh 1
Contoh berikut adalah handler permintaan fungsi untuk kueri GraphQL:allPosts.
Dalam contoh ini, semua entri dalam tabel dikembalikan.
export function request(ctx) { return { operation: 'Scan' }; }
Contoh 2
Contoh berikut adalah handler permintaan fungsi untuk kueri GraphQL:postsMatching(title: String!).
Dalam contoh ini, semua entri dalam tabel dikembalikan di mana judul dimulai dengan title argumen.
export function request(ctx) { const { title } = ctx.args; const filter = { filter: { beginsWith: title } }; return { operation: 'Scan', filter: JSON.parse(util.transform.toDynamoDBFilterExpression(filter)), }; }
Untuk informasi selengkapnya tentang DynamoDB Scan API, lihat dokumentasi DynamoDB API.