All Products
Search
Document Center

Tablestore:Perbarui satu baris data

Last Updated:Apr 21, 2026

Perbarui satu baris dalam tabel Tablestore dengan memanggil updateRow pada Node.js SDK. Anda dapat mengubah nilai kolom atribut, menambahkan kolom atribut, menghapus versi tertentu, atau menghapus seluruh kolom atribut.

Prasyarat

Inisialisasi client Tablestore

Metode

updateRow: function updateRow(params, callback)

Parameter

Name

Type

Description

tableName (Required)

string

Nama tabel data.

primaryKey (Required)

Array

Informasi kunci primer, yang mencakup nama dan nilai kolom kunci primer.

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

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

updateOfAttributeColumns (Required)

Array

Informasi tentang kolom atribut yang akan diperbarui dan jenis operasinya.

condition (Required)

TableStore.Condition

Kondisi pembaruan. Untuk informasi selengkapnya, lihat Conditional update.

returnContent (Optional)

object

Konten data yang akan dikembalikan.

  • returnType (Optional) number: Tipe pengembalian.

    • TableStore.ReturnType.NONE: Nilai default. Tidak ada data yang dikembalikan.

    • TableStore.ReturnType.Primarykey: Mengembalikan kolom kunci primer.

    • TableStore.ReturnType.AfterModify: Mengembalikan nilai kolom setelah pembaruan. Ini digunakan untuk atomic counters.

transactionId (Optional)

string

ID transaksi lokal. ID ini secara unik mengidentifikasi sebuah transaksi lokal. Untuk informasi selengkapnya, lihat Local transaction.

Contoh

Kode contoh berikut mengubah nilai kolom atribut col1 menjadi changed_val1 untuk baris yang memiliki kunci primer row1 di tabel test_table.

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }],
    // Kondisi pembaruan diperlukan untuk memperbarui baris. TableStore.RowExistenceExpectation.IGNORE berarti keberadaan baris tidak diperiksa.
    condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null)
};
params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col1': 'changed_val1' }] }
]

client.updateRow(params, function (err, data) {
    if (err) {
        console.log('Update row failed with error:', err);
        return;
    }
    console.log('RequestId: ', data.RequestId);
    console.log('Read CU Cost: ', data.consumed.capacityUnit.read);
    console.log('Write CU Cost: ', data.consumed.capacityUnit.write);
});

Lakukan juga operasi baris berikut.

  • Tambahkan kolom atribut.

    params.updateOfAttributeColumns = [
        { 'PUT': [{ 'col2': 'val2' }] }
    ]
  • Tetapkan nomor versi untuk kolom atribut.

    params.updateOfAttributeColumns = [
        { 'PUT': [{ 'col2': 'val2', 'timestamp': Date.now() }] }
    ]
  • Hapus data versi tertentu dari kolom atribut.

    params.updateOfAttributeColumns = [
        { 'DELETE': [{ 'col2': TableStore.Long.fromNumber(1496826473186) }] },
    ]
  • Hapus semua data dari kolom atribut.

    params.updateOfAttributeColumns = [
        { 'DELETE_ALL': ['col2'] }
    ]

Referensi

Batch update data