All Products
Search

This Product

    Tablestore:Membaca satu baris data

    Document Center

    Tablestore:Membaca satu baris data

    Last Updated:Apr 21, 2026

    Baca satu baris data dari tabel Tablestore dengan memanggil getRow pada Node.js SDK. Tentukan nilai kunci primer, rentang versi, dan filter kolom untuk mengontrol data yang dikembalikan.

    Catatan

    Anda harus menyediakan nilai kunci primer lengkap untuk membaca data, termasuk nilai kolom kunci utama auto-increment.

    Prasyarat

    Inisialisasi client Tablestore

    Metode

    getRow: function getRow(params, callback)

    Deskripsi parameter

    Nama

    Tipe

    Deskripsi

    tableName (Wajib)

    string

    Nama tabel data.

    primaryKey (Wajib)

    Array

    Informasi tentang kunci primer. Ini mencakup nama dan nilai kolom kunci primer.

    • Tipe data kolom kunci primer dapat berupa STRING, INTEGER, atau BINARY.

    • Jumlah dan tipe kunci primer harus sesuai dengan yang ada di tabel data.

    maxVersions (Opsional)

    number

    Jumlah maksimum versi yang akan dikembalikan. Nilai default-nya adalah 1.

    • Jika jumlah versi data yang memenuhi kondisi kueri melebihi jumlah maksimum versi yang ditentukan, versi sebanyak yang ditentukan akan dikembalikan dari yang terbaru ke yang terlama.

    timeRange (Opsional)

    object

    Menentukan rentang versi data.

    • Setiap kolom atribut dalam tabel Tablestore dapat memiliki versi data yang berbeda. Saat Anda menentukan rentang versi, hanya data dalam rentang tersebut yang dikembalikan.

    columnsToGet (Opsional)

    Array

    Kolom data yang akan dibaca. Kolom ini dapat berupa kolom kunci primer atau kolom atribut.

    • Jika Anda tidak mengatur columnsToGet, seluruh baris akan dikembalikan.

    • Jika Anda mengatur columnsToGet dan baris yang dibaca tidak berisi salah satu kolom data yang ditentukan, null akan dikembalikan.

    columnFilter (Opsional)

    TableStore.ColumnCondition

    Kondisi filter. Untuk informasi lebih lanjut, lihat Filters.

    • Jika Anda mengatur columnsToGet dan columnFilter secara bersamaan, sistem terlebih dahulu memilih baris berdasarkan columnsToGet, lalu memfilter data berdasarkan columnFilter.

    transactionId (Opsional)

    string

    ID transaksi lokal. ID ini secara unik mengidentifikasi sebuah transaksi lokal. Untuk informasi lebih lanjut, lihat Local transactions.

    Contoh

    Kode contoh berikut menunjukkan cara membaca satu baris data dengan nilai kunci primer row1.

    var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }]
};

client.getRow(params, function (err, data) {
    if (err) {
        console.log('Get row failed with error: ', err);
        return;
    }
    console.log('Read CU Cost: ', data.consumed.capacityUnit.read);
    console.log('Write CU Cost: ', data.consumed.capacityUnit.write);
    console.log('Row Data: ', JSON.stringify(data.row));
});

    • Tentukan rentang waktu untuk versi data yang akan dibaca. Hanya data dalam rentang waktu yang ditentukan yang dikembalikan.

      params.timeRange = {
    startTime: (Date.now() - 86400 * 1000).toString(),
    endTime: Date.now().toString()
}

    • Tentukan kolom atribut yang akan dibaca.

      params.columnsToGet = ['col2']

    Referensi