Gunakan Tablestore SDK untuk Node.js guna menjalankan pencocokan semua kueri - Tablestore

Gunakan pencocokan semua kueri untuk mencocokkan setiap baris dalam tabel data—berguna untuk menghitung jumlah total baris atau mengambil sampel acak.

Prasyarat

Instans OTSClient telah diinisialisasi. Untuk informasi selengkapnya, lihat Inisialisasi instans OTSClient.
Sebuah tabel data telah dibuat dan data telah ditulis ke tabel tersebut. Untuk informasi selengkapnya, lihat Membuat tabel data dan Menulis data.
Indeks pencarian telah dibuat untuk tabel data tersebut. Untuk informasi selengkapnya, lihat Buat indeks pencarian.

Parameter

Parameter	Deskripsi
tableName	Nama tabel data.
indexName	Nama indeks pencarian.
offset	Posisi awal kueri.
limit	Jumlah maksimum baris yang akan dikembalikan. Untuk hanya mengembalikan jumlah baris tanpa data, atur nilai ini menjadi 0.
query	Jenis kueri. Atur ke `TableStore.QueryType.MATCH_ALL_QUERY` untuk pencocokan semua kueri.
getTotalCount	Apakah akan mengembalikan jumlah total baris yang sesuai dengan kondisi kueri. Nilai default: `false`. Mengatur nilai ini ke `true` akan menurunkan performa kueri.
columnToGet	Kolom yang akan dikembalikan untuk setiap baris yang cocok. Konfigurasikan menggunakan `returnType` dan `returnNames`. Jika Anda mengatur returnType ke TableStore.ColumnReturnType.RETURN_SPECIFIED, Anda perlu mengonfigurasi returnNames untuk menentukan kolom yang ingin dikembalikan. Jika Anda mengatur parameter returnType ke TableStore.ColumnReturnType.RETURN_ALL, semua kolom akan dikembalikan. Jika Anda mengatur parameter returnType ke TableStore.ColumnReturnType.RETURN_ALL_FROM_INDEX, semua kolom dalam indeks pencarian akan dikembalikan. . Jika Anda mengatur parameter returnType ke TableStore.ColumnReturnType.RETURN_NONE, hanya kolom kunci primer yang akan dikembalikan.

Contoh

Contoh berikut menggunakan pencocokan semua kueri untuk menghitung jumlah total baris dalam tabel data:

/**
 * Jalankan pencocokan semua kueri untuk mendapatkan jumlah total baris dalam tabel data.
 */
client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10, // Atur ke 0 untuk hanya mengembalikan jumlah baris tanpa data.
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true // Atur ke true untuk mengembalikan jumlah total baris yang cocok. Default: false.
    },
    columnToGet: { // RETURN_SPECIFIED: hanya kolom tertentu; RETURN_ALL: semua kolom; RETURN_ALL_FROM_INDEX: semua kolom dalam indeks pencarian; RETURN_NONE: hanya kolom kunci primer.
        returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
        returnNames: ["Col_1", "Col_2", "Col_3"]
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

FAQ

Bagaimana cara mengkueri jumlah total baris dalam tabel?

Referensi

Jenis kueri berikut didukung oleh indeks pencarian: kueri tepat, kueri istilah, pencocokan semua kueri, kueri cocok, permintaan pencocokan frasa, kueri awalan, kueri rentang, kueri wildcard, Boolean query, kueri geografis, kueri bersarang, kueri vektor, dan kueri exists. Anda dapat memilih jenis kueri sesuai kebutuhan bisnis Anda.
Jika Anda ingin mengurutkan atau membagi hasil kueri ke dalam halaman, Anda dapat menggunakan fitur pengurutan dan penomoran halaman. Untuk informasi selengkapnya, lihat Pengurutan dan penomoran halaman.
Jika Anda ingin menciutkan set hasil berdasarkan kolom tertentu, Anda dapat menggunakan fitur collapse (distinct). Dengan cara ini, data dari tipe tertentu hanya muncul sekali dalam hasil kueri. Untuk informasi selengkapnya, lihat Collapse (distinct).
Jika Anda ingin menganalisis data dalam tabel data, seperti mendapatkan nilai ekstrem, jumlah total, dan jumlah baris, Anda dapat menjalankan operasi agregasi atau mengeksekusi pernyataan SQL. Untuk informasi selengkapnya, lihat Agregasi dan Kueri SQL.
Jika Anda ingin dengan cepat mendapatkan semua baris yang memenuhi kondisi kueri tanpa perlu mengurutkannya, Anda dapat memanggil operasi ParallelScan dan ComputeSplits untuk menggunakan fitur pemindaian paralel. Untuk informasi selengkapnya, lihat Pemindaian paralel.