Gunakan Python SDK untuk menulis satu baris data ke tabel Tablestore.
Metode
put_row(self, table_name, row, condition=None, return_type=None, transaction_id=None)
Parameter
|
Parameter
|
Tipe
|
Deskripsi
|
|
table_name (Wajib)
|
str
|
Nama tabel data.
|
|
row (Wajib)
|
Row
|
Baris yang akan ditulis. Parameter ini mencakup hal-hal berikut:
-
primary_key (Wajib) List[Tuple]: Nama dan nilai kolom kunci primer.
-
Tipe data kolom kunci primer adalah STRING, INTEGER, dan BINARY.
-
Jumlah dan tipe data kolom kunci primer harus sesuai dengan yang telah didefinisikan untuk tabel data.
-
Jika kolom kunci primer merupakan kolom auto-increment, atur nilainya ke placeholder. Untuk informasi selengkapnya, lihat Kolom kunci utama auto-increment.
-
attribute_columns (Wajib) List[Tuple]: Nama, nilai, dan versi data kolom atribut.
-
Tipe data kolom atribut adalah STRING, INTEGER, BINARY, DOUBLE, dan BOOLEAN.
-
Versi data berupa timestamp. Secara default, Tablestore secara otomatis menghasilkan versi, tetapi Anda juga dapat menentukan versi kustom. Untuk informasi selengkapnya, lihat Versi data dan siklus hidup data.
|
|
condition (Opsional)
|
Condition
|
Kondisi untuk operasi penulisan. Untuk informasi selengkapnya, lihat Pembaruan bersyarat.
|
|
return_type (Opsional)
|
ReturnType
|
Jenis data yang dikembalikan.
|
|
transaction_id (Opsional)
|
str
|
ID unik untuk transaksi lokal. Untuk informasi selengkapnya, lihat Transaksi lokal.
|
Contoh
Contoh berikut menulis satu baris dengan nilai kunci primer row1 ke tabel test_table.
try:
# Membuat kunci primer dan kolom atribut.
primary_key = [('id', 'row1')]
attribute_columns = []
# Membuat baris yang akan ditulis.
row = Row(primary_key, attribute_columns)
# Memanggil metode put_row untuk menulis baris.
consumed, return_row = client.put_row('test_table', row)
print('* Biaya CU Baca: %s' % consumed.read)
print('* Biaya CU Tulis: %s' % consumed.write)
except Exception as e:
print("Gagal menulis baris dengan error: %s" % e)
-
Untuk menambahkan kolom atribut:
attribute_columns = [('col1','val1')]
-
Untuk menentukan versi data, tetapkan versi pada setiap kolom atribut.
attribute_columns = [('col1','val1', int(time.time() * 1000))]