Tablestore Node.js SDK: Menulis satu baris data - Tablestore

Masukkan satu baris data ke dalam tabel Tablestore dengan memanggil putRow pada Node.js SDK. Metode ini memungkinkan Anda menulis kolom kunci primer dan kolom atribut opsional dengan dukungan kontrol versi.

Prasyarat

Inisialisasi client Tablestore

Metode

putRow: function putRow(params, callback)

Deskripsi parameter

Name	Type	Description
tableName (required)	string	Nama tabel.
primaryKey (required)	Array	Informasi kunci primer, termasuk nama dan nilai kolom kunci primer. Tipe data kolom kunci primer mencakup STRING, INTEGER, dan BINARY. Jumlah dan tipe kunci primer pada baris harus sesuai dengan yang telah ditentukan untuk tabel tersebut. Jika kolom kunci primer merupakan kolom auto-increment, atur nilainya ke placeholder. Untuk informasi selengkapnya, lihat auto-increment primary key column.
attributeColumns (optional)	Array	Informasi kolom atribut, termasuk nama, nilai, dan nomor versi kolom atribut. Tipe data kolom atribut mencakup STRING, INTEGER, BINARY, DOUBLE, dan BOOLEAN. Nomor versi berupa timestamp. Secara default, sistem menghasilkannya secara otomatis. Anda juga dapat menentukannya secara manual. Untuk informasi selengkapnya, lihat data versions and lifecycle.
condition (required)	TableStore.Condition	Kondisi penulisan. Untuk informasi selengkapnya, lihat conditional update.
returnContent (optional)	object	Data yang akan dikembalikan. returnType (optional) `number`: Tipe pengembalian. TableStore.ReturnType.NONE (default): Tidak mengembalikan data apa pun. TableStore.ReturnType.Primarykey: Mengembalikan kolom kunci primer. Gunakan opsi ini untuk kolom kunci primer auto-increment. TableStore.ReturnType.AfterModify: Mengembalikan nilai kolom yang diperbarui. Gunakan opsi ini untuk atomic counters.
transactionId (optional)	string	ID transaksi lokal, yang secara unik mengidentifikasi suatu transaksi lokal. Untuk informasi selengkapnya, lihat local transaction.

Contoh

Contoh berikut menulis satu baris data ke tabel test_table. Nilai kunci primernya adalah row1.

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }],
    // Tentukan kondisi penulisan saat menulis data. TableStore.RowExistenceExpectation.IGNORE berarti sistem tidak memeriksa apakah baris tersebut sudah ada.
    condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null)
};

client.putRow(params, function (err, data) {
    if (err) {
        console.log('Put 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);
});

Tambahkan kolom atribut.

params.attributeColumns = [{ 'col1': 'val1' }];

Tentukan nomor versi. Anda dapat memberikan nomor versi terpisah untuk setiap kolom atribut.
```
params.attributeColumns = [{ 'col1': 'val1', 'timestamp': Date.now() }];
```

Referensi

Batch update data