Tablestore:Operasi DML

Penyisipan satu baris

INSERT INTO user_table VALUES (1, 'value1', 100);

Penyisipan batch dalam satu partisi

Beberapa baris yang memiliki kunci partisi yang sama dapat disisipkan secara atomik dalam satu batch hingga maksimal 200 baris. Misalnya, asumsikan struktur tabel adalah user_table(pk1 BIGINT, pk2 VARCHAR(1024), value BIGINT), dengan pk1 sebagai kunci partisi. Dua baris yang keduanya memiliki kunci partisi pk1 bernilai 1 berada dalam partisi yang sama dan oleh karena itu dapat disisipkan secara atomik dalam satu batch.

INSERT INTO user_table VALUES (1, 'attr1', 100), (1, 'attr2', 200);

Catatan

• Konflik kunci primer: Menyisipkan baris dengan kunci primer yang sudah ada mengembalikan kesalahan dengan kode kesalahan OTSParameterInvalid dan pesan kesalahan yang berisi Duplicate entry for key 'PRIMARY'. Data yang sudah ada tidak ditimpa.

• Penyisipan batch lintas partisi: Semua baris dalam pernyataan INSERT batch harus memiliki kunci partisi yang sama.

• Batas ukuran batch: Pernyataan INSERT batch yang berisi lebih dari 200 baris akan ditolak.

• Baris yang terpengaruh: INSERT satu baris yang berhasil mengembalikan nilai 1. Penyisipan batch N baris yang berhasil mengembalikan nilai N. Jika terjadi konflik kunci primer, operasi mengembalikan kesalahan alih-alih jumlah baris yang terpengaruh.

Pembaruan dengan nilai konstan

Anda dapat memperbarui satu atau beberapa kolom sekaligus.

-- Perbarui satu kolom
UPDATE user_table SET attr_col = 999 WHERE pk_col = 1;

-- Perbarui beberapa kolom
UPDATE user_table SET c1 = 10, c2 = 20, c3 = 'updated' WHERE id = 1;

-- Perbarui baris dengan kunci primer komposit. Urutan kolom dalam klausa WHERE boleh berbeda dari definisi kunci.
UPDATE user_table SET value = 999 WHERE pk2 = 2 AND pk1 = 1;

Increment dan decrement atomik

Anda dapat melakukan increment atau decrement nilai kolom atribut bertipe BIGINT secara atomik. Ini berguna untuk skenario seperti pencacah (counter). Operasi ini hanya didukung untuk kolom atribut integer, bukan untuk tipe lain seperti DOUBLE, BOOL, atau VARCHAR.

-- Increment sebesar 1
UPDATE user_table SET counter = counter + 1 WHERE id = 1;

-- Increment dengan nilai tertentu
UPDATE user_table SET counter = counter + 10 WHERE id = 1;

-- Decrement
UPDATE user_table SET counter = counter - 5 WHERE id = 1;

Atur kolom atribut menjadi NULL

Mengatur kolom atribut menjadi NULL secara efektif menghapusnya; sistem menghapus kolom tersebut dari baris alih-alih menyimpan nilai NULL.

UPDATE user_table SET attr_col = NULL WHERE pk_col = 1;

Catatan

• Klausa WHERE harus menentukan kondisi kesetaraan untuk kunci primer lengkap: Kasus-kasus berikut tidak didukung, dan kesalahan OTSParameterInvalid atau OTSUnsupportOperation akan dikembalikan:

  • Klausa WHERE tidak mencakup kunci primer lengkap.

  • Klausa WHERE menggunakan kondisi pada kolom non-kunci primer.

  • Klausa WHERE menggunakan kueri rentang (seperti >, <, atau BETWEEN).

  • Klausa WHERE menggunakan kondisi non-kesetaraan seperti IN, LIKE, OR, atau !=.

  • Klausa WHERE mencakup kondisi pada kolom atribut selain kunci primer lengkap.

• Tidak dapat memodifikasi kolom kunci primer: Klausul SET tidak dapat digunakan untuk mengubah nilai kolom kunci primer.

• Baris target tidak ada: Operasi UPDATE pada baris yang tidak ada selesai secara diam-diam dengan 0 baris terpengaruh. Tidak ada kesalahan yang dikembalikan.

Catatan

• Klausa WHERE harus berupa kondisi kesetaraan pada kunci primer lengkap: Batasan ini sama dengan pernyataan UPDATE. Klausa WHERE yang hilang, kondisi pada kolom kunci primer parsial atau non-kunci primer, kondisi rentang, operator IN, LIKE, atau OR, atau kondisi pada kolom atribut tambahan tidak didukung.

• Baris target tidak ada: Operasi DELETE pada baris yang tidak ada selesai secara diam-diam dengan 0 baris terpengaruh. Tidak ada kesalahan yang dikembalikan.

Batasan sintaksis SQL

Operasi DML pada tabel non-transaksional tidak mendukung sintaksis SQL berikut:

Batasan tipe data

Opsi dan kendala kolom

Saat menggunakan CREATE TABLE, hanya opsi kolom berikut yang didukung: PRIMARY KEY, NOT NULL, NULL, DEFAULT VALUE, dan ON UPDATE.

Hanya kendala PRIMARY KEY yang didukung.

Batasan jenis tabel khusus

Tabel berindeks pencarian dan tabel alias tidak mendukung operasi DML apa pun (INSERT, UPDATE, DELETE).