Tablestore Node.js SDK baca data secara batch - Tablestore

Baca beberapa baris dari satu atau beberapa tabel Tablestore dalam satu permintaan menggunakan metode batchGetRow pada Node.js SDK.

Catatan

Satu operasi baca batch mendukung pembacaan hingga 100 baris data.

Prasyarat

Inisialisasi client Tablestore

Metode

batchGetRow: function batchGetRow(params, callback)

Deskripsi parameter params

tables (wajib) (Array): Parameter ini menentukan informasi untuk membaca data secara batch dan mencakup subparameter berikut.

Nama	Tipe	Deskripsi
tableName (wajib)	string	Nama tabel data.
primaryKey (wajib)	Array	Informasi kunci primer, termasuk nama dan nilai kolom kunci primer. Tipe data kolom kunci primer yang didukung adalah STRING, INTEGER, dan BINARY. Jumlah dan tipe kunci primer harus sesuai dengan yang didefinisikan di tabel data.
maxVersions (opsional)	number	Jumlah maksimum versi yang dikembalikan. Nilai default-nya adalah 1. Jika jumlah versi data yang memenuhi kondisi kueri melebihi nilai ini, sistem akan mengembalikan jumlah versi yang ditentukan dalam urutan menurun berdasarkan timestamp versi (terbaru lebih dahulu).
timeRange (opsional)	object	Rentang versi data yang akan dikembalikan. Setiap kolom atribut dalam tabel data Tablestore dapat memiliki beberapa versi. Saat Anda menentukan rentang versi, hanya data dalam rentang tersebut yang dikembalikan.
columnsToGet (opsional)	Array	Kolom yang akan dibaca. Kolom ini dapat berupa kolom kunci primer atau kolom atribut. Jika columnsToGet tidak diatur, seluruh baris akan dikembalikan. Jika columnsToGet diatur dan tidak ada kolom yang ditentukan dalam baris tersebut, null akan dikembalikan.
columnFilter (opsional)	TableStore.ColumnCondition	Kondisi filter. Untuk informasi selengkapnya, lihat Filters. Jika columnsToGet dan columnFilter keduanya diatur, sistem terlebih dahulu memfilter baris berdasarkan columnsToGet, lalu menerapkan columnFilter pada hasilnya.

Contoh

Kode contoh berikut membaca dua baris dengan nilai kunci primer row1 dan row2 dari tabel test_table.

var table = {
    // Setel nama tabel
    tableName: 'test_table',
    primaryKey: [
        // Tambahkan informasi kunci primer untuk baris 1
        [{ 'id': 'row1' }],
        // Tambahkan informasi kunci primer untuk baris 2
        [{ 'id': 'row2' }]
    ]
};
var params = {
    tables: [
        table
    ]
}

// Panggil metode batchGetRow untuk melakukan kueri data batch
client.batchGetRow(params, function (err, data) {
    if (err) {
        console.log('Batch get row failed with error: ', err);
        return;
    }

    // Proses respons
    console.log('* RequestId: ', data.RequestId);
    console.log('* Rows Data: ');
    data.tables.forEach(function (rows) {
        rows.forEach(function (row) {
            if (row.isOk) {
                console.log('Succeeded Row:', row.tableName, JSON.stringify(row.primaryKey), JSON.stringify(row.attributes));
            } else {
                console.log('Failed Row:', row.tableName, row.errorMessage);
            }
        });
    });
});

Gunakan kode contoh berikut sebagai referensi saat mengatur parameter untuk pembacaan data batch.

Baca data dari beberapa tabel. Baca batch mendukung pembacaan data dari beberapa tabel dalam satu permintaan. Anda dapat menentukan kondisi kueri untuk setiap tabel.

var table1 = {
    tableName: 'orders_small',
    primaryKey: [
        [{ 'order_id': '90fb478c-1360-11f0-a34d-00163e30a2a9' }]
    ]
};

var params = {
    tables: [
        table,
        table1
    ]
};

Tentukan rentang versi data. Hanya data dalam rentang yang ditentukan yang dikembalikan.

// Atur rentang versi ke 24 jam terakhir dari waktu saat ini
table.timeRange = {
    startTime: (Date.now() - 86400 * 1000).toString(),
    endTime: Date.now().toString()
}

Tentukan kolom atribut yang akan dibaca.
```
table.columnsToGet = ['col2']
```

Referensi

Baca data berdasarkan rentang