Menulis satu atau lebih baris data - Tablestore

Tablestore menyediakan operasi PutRow untuk menulis satu baris data, operasi UpdateRow untuk memperbarui satu baris data, dan operasi BatchWriteRow untuk menulis beberapa baris data sekaligus.

Catatan

Baris adalah unit dasar tabel. Baris terdiri dari kolom kunci utama dan kolom atribut. Kunci utama diperlukan untuk setiap baris. Nama dan tipe kolom kunci utama dari setiap baris sama. Kolom atribut bersifat opsional dan dapat berbeda untuk setiap baris. Untuk informasi lebih lanjut, lihat Ikhtisar.

Menyisipkan satu baris data

Anda dapat memanggil operasi PutRow untuk menyisipkan satu baris data. Sistem akan menghapus semua versi data di semua kolom baris yang ada dan menulis baris data baru. Operasi ini cocok untuk skenario di mana Anda ingin menulis sejumlah kecil data.

Sebelum menulis satu baris data, Anda dapat mengonfigurasi pengaturan berikut sesuai dengan kebutuhan bisnis Anda:

Secara default, sistem menggunakan timestamp UNIX saat ini sebagai nomor versi data. Timestamp UNIX mewakili jumlah milidetik yang telah berlalu sejak 1 Januari 1970, 00:00:00 UTC. Anda juga dapat menentukan nomor versi data kustom. Untuk informasi lebih lanjut, lihat Versi Data dan TTL.
Tentukan kondisi keberadaan baris atau kondisi berdasarkan nilai kolom untuk pembaruan bersyarat. Untuk informasi lebih lanjut, lihat Pembaruan Bersyarat.

Respon bervariasi tergantung pada apakah operasi berhasil.

Jika operasi berhasil, Tablestore mengembalikan jumlah unit kapasitas (CUs) yang dikonsumsi oleh operasi tersebut.
Jika terjadi kesalahan, Tablestore mengembalikan kode kesalahan. Misalnya, kode kesalahan dikembalikan ketika parameter gagal dalam pemeriksaan, terdapat data berlebih dalam satu baris, atau pemeriksaan keberadaan baris gagal.
Catatan
Untuk informasi lebih lanjut tentang kode kesalahan, lihat Kode Kesalahan.

Memperbarui satu baris data

Anda dapat memanggil operasi UpdateRow untuk memperbarui data dalam satu baris. Anda dapat menambahkan kolom atribut ke baris, menghapus kolom atribut dari baris, menghapus versi tertentu dari data dari kolom atribut, atau memperbarui nilai kolom atribut. Jika baris tidak ada, baris baru akan ditambahkan. Operasi ini cocok untuk skenario di mana Anda ingin memperbarui data yang ada. Misalnya, Anda ingin menghapus kolom atribut, menghapus versi tertentu dari data, atau memperbarui nilai kolom atribut.

Catatan

Sebelum memperbarui satu baris data, Anda dapat mengonfigurasi pengaturan berikut sesuai dengan kebutuhan bisnis Anda:

Anda dapat menambahkan kolom atribut ke baris, menghapus kolom atribut dari baris, menghapus versi tertentu dari data dari kolom atribut, atau memperbarui nilai kolom atribut dalam permintaan.
Secara default, sistem menggunakan timestamp UNIX saat ini sebagai nomor versi data. Timestamp UNIX mewakili jumlah milidetik yang telah berlalu sejak 1 Januari 1970, 00:00:00 UTC. Anda juga dapat menentukan nomor versi data kustom. Untuk informasi lebih lanjut, lihat Versi Data dan TTL.
Tentukan kondisi keberadaan baris atau kondisi berdasarkan nilai kolom untuk pembaruan bersyarat. Untuk informasi lebih lanjut, lihat Pembaruan Bersyarat.

Menulis beberapa baris data sekaligus

Anda dapat memanggil operasi BatchWriteRow untuk menulis beberapa baris data ke satu atau lebih tabel sekaligus. Operasi ini cocok untuk skenario di mana Anda ingin menulis, menghapus, atau memperbarui sejumlah besar data dan skenario di mana Anda ingin menulis, menghapus, dan memperbarui data secara bersamaan.

Sebelum menulis beberapa baris data sekaligus, Anda dapat mengonfigurasi pengaturan berikut sesuai dengan kebutuhan bisnis Anda:

Anda dapat menulis data ke, memperbarui data di, atau menghapus data dari beberapa tabel sekaligus dalam satu permintaan.
Anda dapat mengonfigurasi kondisi pembaruan secara terpisah untuk setiap operasi PutRow, UpdateRow, atau DeleteRow dalam satu permintaan.
Secara default, sistem menggunakan timestamp UNIX saat ini sebagai nomor versi data. Timestamp UNIX mewakili jumlah milidetik yang telah berlalu sejak 1 Januari 1970, 00:00:00 UTC. Anda juga dapat menentukan nomor versi data kustom. Untuk informasi lebih lanjut, lihat Versi Data dan TTL.
Tentukan kondisi keberadaan baris atau kondisi berdasarkan nilai kolom untuk pembaruan bersyarat. Untuk informasi lebih lanjut, lihat Pembaruan Bersyarat.

Metode

Menggunakan konsol Tablestore

Anda dapat menulis atau memperbarui satu baris data di konsol Tablestore.

Masuk ke konsol Tablestore.
Di halaman Overview, temukan instance yang ingin Anda kelola dan klik Manage Instance di kolom Actions.
Di tab Tables dari tab Instance Details, klik nama tabel yang ingin Anda kelola.
Di tab Query Data dari halaman Kelola Tabel, sisipkan atau perbarui data berdasarkan kebutuhan bisnis Anda.
Menyisipkan satu baris data
1. Klik Insert.
2. Dalam kotak dialog Insert, masukkan nilai pada kolom Primary Key Value.
3. Klik ikon dan konfigurasikan parameter Nama, Tipe, Nilai, dan Versi.
  Jika Anda ingin menambahkan beberapa kolom atribut, klik ikon dan konfigurasikan parameter yang sesuai setiap kali Anda menambahkan kolom atribut.
4. Klik OK.
Memperbarui satu baris data
1. Pilih baris yang ingin Anda perbarui dan klik Update.
2. Di kotak dialog Update, sesuaikan informasi kolom atribut dengan kebutuhan bisnis Anda.
  Untuk menambahkan kolom atribut, klik ikon dan konfigurasikan parameter yang sesuai. Untuk menghapus kolom atribut, pilih Delete All dari daftar drop-down Actions. Untuk menghapus versi tertentu dari data, pilih Delete dari daftar drop-down Actions dan pilih nomor versi data yang ingin Anda hapus. Untuk memperbarui nilai kolom atribut, pilih Update dari daftar drop-down Actions dan modifikasi nilainya.
3. Klik OK.

Menggunakan CLI Tablestore

Anda dapat menjalankan perintah berikut untuk menulis data di CLI Tablestore:

Jalankan perintah put untuk menulis satu baris data. Untuk informasi lebih lanjut, lihat Menyisipkan Data.
Kode contoh berikut memberikan contoh cara menyisipkan baris data ke tabel. Nilai kolom kunci utama pertama dari baris adalah 86, dan nilai kolom kunci utama kedua adalah 6771. Baris memiliki dua kolom atribut: kolom nama tipe STRING dan kolom negara tipe STRING.
```
put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'
```
Jalankan perintah update untuk memperbarui baris data. Untuk informasi lebih lanjut, lihat Memperbarui Data.
Kode contoh berikut memberikan contoh cara memperbarui data dalam baris di mana nilai kolom kunci utama pertama adalah 86 dan nilai kolom kunci utama kedua adalah 6771. Data dimasukkan tanpa memandang apakah baris sudah ada. Jika baris sudah ada, data yang dimasukkan akan menimpa data yang ada.
```
update --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition ignore
```

Menggunakan SDK Tablestore

Anda dapat menggunakan SDK Tablestore untuk Java, SDK Tablestore untuk Go, SDK Tablestore untuk Python, SDK Tablestore untuk Node.js, SDK Tablestore untuk .NET, atau SDK Tablestore untuk PHP untuk menulis data. Dalam contoh ini, SDK Tablestore untuk Java digunakan.

Menyisipkan satu baris data

Saat menyisipkan data, Anda dapat menentukan nomor versi data kustom. Anda juga dapat menentukan kondisi berdasarkan nilai kolom dan kondisi keberadaan baris.

Gunakan nomor versi data yang dihasilkan secara otomatis oleh sistem saat menyisipkan baris data.
Tentukan nomor versi data kustom saat menyisipkan baris data.
Tentukan kondisi keberadaan baris saat menyisipkan baris data.
Tentukan kondisi keberadaan baris atau kondisi berdasarkan nilai kolom saat menyisipkan baris data.

Memperbarui satu baris data

Saat memperbarui satu baris data, Anda dapat menentukan nomor versi data kustom. Anda juga dapat menentukan kondisi berdasarkan nilai kolom dan kondisi keberadaan baris.

Perbarui baris data tanpa menentukan kondisi.
Tentukan kondisi keberadaan baris atau kondisi berdasarkan nilai kolom saat memperbarui data.

Menulis beberapa baris data sekaligus

Aturan Penagihan

Anda dikenakan biaya berdasarkan jumlah CU yang dikonsumsi oleh suatu operasi. Anda dikenakan biaya secara terpisah untuk CU baca-tulis on-demand dan CU baca-tulis cadangan. Jenis instansi yang Anda akses menentukan apakah CU baca-tulis on-demand atau CU baca-tulis cadangan yang dikonsumsi.

Catatan

Untuk informasi tentang jenis instansi dan CU, lihat Instansi dan Throughput Baca-Tulis.

Operasi	Konsumsi CU
PutRow	Jumlah CU tulis yang dikonsumsi dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah CU tulis yang dikonsumsi = (Ukuran data di semua kolom kunci utama baris + Ukuran data di kolom atribut yang dimasukkan)/4 KB. Jumlah CU baca yang dikonsumsi bervariasi berdasarkan kondisi yang Anda tentukan. Anda dapat menentukan parameter condition dalam permintaan untuk operasi PutRow untuk menentukan apakah akan melakukan pemeriksaan keberadaan baris sebelum operasi PutRow dilakukan. Jika nilai parameter condition bukan IGNORE, operasi PutRow mengonsumsi CU baca. Jumlah CU baca yang dikonsumsi dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah CU baca yang dikonsumsi = Ukuran data di semua kolom kunci utama baris/4 KB. Jika kondisi keberadaan baris yang ditentukan tidak terpenuhi, operasi gagal dan mengonsumsi satu CU tulis dan satu CU baca.
UpdateRow	Jumlah CU tulis yang dikonsumsi dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah CU tulis yang dikonsumsi = (Ukuran data di semua kolom kunci utama baris + Ukuran data di kolom atribut yang diperbarui)/4 KB. Jika permintaan untuk operasi UpdateRow berisi instruksi untuk menghapus kolom atribut, panjang nama setiap kolom atribut yang ingin dihapus digunakan sebagai ukuran kolom. Jumlah CU baca yang dikonsumsi bervariasi berdasarkan kondisi yang Anda tentukan. Anda dapat menentukan parameter condition dalam permintaan untuk operasi UpdateRow untuk menentukan apakah akan melakukan pemeriksaan keberadaan baris sebelum operasi UpdateRow dilakukan. Jika nilai parameter condition bukan IGNORE, operasi UpdateRow mengonsumsi CU baca. Jumlah CU baca yang dikonsumsi dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah CU baca yang dikonsumsi = Ukuran data di semua kolom kunci utama baris/4 KB. Jika kondisi keberadaan baris yang ditentukan tidak terpenuhi, operasi gagal dan mengonsumsi satu CU tulis dan satu CU baca.
BatchWriteRow	Jumlah CU baca dan tulis yang dikonsumsi dihitung secara terpisah berdasarkan operasi PutRow, UpdateRow, dan DeleteRow yang termasuk dalam permintaan untuk operasi BatchWriteRow. Jumlah CU baca dan tulis yang dikonsumsi oleh operasi DeleteRow dihitung berdasarkan aturan berikut: Jumlah CU tulis yang dikonsumsi dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah CU tulis yang dikonsumsi = Ukuran data di semua kolom kunci utama baris yang dihapus/4 KB. Jika nilai parameter condition bukan IGNORE, operasi DeleteRow mengonsumsi CU baca. Jumlah CU baca yang dikonsumsi dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah CU baca yang dikonsumsi = Ukuran data di semua kolom kunci utama baris/4 KB. Jika kondisi keberadaan baris yang ditentukan tidak terpenuhi, operasi gagal dan mengonsumsi satu CU tulis.