Menghapus baris data - Tablestore

Menghapus baris data.

Sintaks permintaan

message DeleteRowRequest {
    required string table_name = 1;
    required bytes primary_key = 2; // Primary key dienkripsi sebagai data biner dalam format PlainBuffer. 
    required Condition condition = 3;
    optional ReturnContent return_content = 4;
    optional string transaction_id = 5;
}

Parameter	Tipe	Diperlukan	Deskripsi
table_name	string	Ya	Nama tabel data.
primary_key	bytes	Ya	Primary key dari baris yang ingin Anda hapus. Primary key dienkripsi dalam format PlainBuffer. Untuk informasi lebih lanjut tentang PlainBuffer, lihat PlainBuffer.
condition	Condition	Ya	Menentukan apakah akan melakukan pemeriksaan keberadaan baris sebelum operasi data. Nilai default: IGNORE. Nilai valid: IGNORE: Pemeriksaan keberadaan baris tidak dilakukan. Ketika Anda mengatur parameter condition ke IGNORE, operasi berhasil terlepas dari apakah baris ada atau tidak. EXPECT_EXIST: Baris diharapkan ada. Ketika Anda mengatur parameter condition ke EXPECT_EXIST, operasi penghapusan berhasil jika baris ada, dan operasi penghapusan gagal serta kesalahan dilaporkan jika baris tidak ada.
return_content	ReturnContent	Tidak	Jenis data yang dikembalikan setelah baris berhasil ditulis. Hanya primary key yang dapat dikembalikan. Dalam banyak kasus, parameter ini digunakan oleh fitur kolom primary key auto-increment.
transaction_id	string	Tidak	ID transaksi lokal. Parameter ini diperlukan jika Anda ingin menggunakan transaksi lokal untuk menghapus data.

Sintaks respons

message DeleteRowResponse {
    required ConsumedCapacity consumed = 1;
    optional bytes row = 2;
}

Parameter

Tipe

Deskripsi

consumed

ConsumedCapacity

Jumlah unit kapasitas (CUs) yang dikonsumsi oleh operasi. Untuk informasi lebih lanjut, lihat Konsumsi CU.

row

bytes

Data yang dikembalikan jika Anda menentukan nilai untuk return_content. Jika Anda tidak menentukan nilai untuk return_content atau tidak ada nilai kembali, NULL dikembalikan.

Data yang dikembalikan dienkripsi dalam format PlainBuffer. Untuk informasi lebih lanjut tentang PlainBuffer, lihat PlainBuffer.

Menggunakan Tablestore SDKs

Anda dapat menggunakan Tablestore SDK berikut untuk menghapus satu baris data:

Tablestore SDK for Java: Menghapus satu baris data
Tablestore SDK for Go: Menghapus satu baris data
Tablestore SDK for Python: Menghapus satu baris data
Tablestore SDK for Node.js: Menghapus satu baris data
Tablestore SDK for .NET: Menghapus satu baris data
Tablestore SDK for PHP: Menghapus satu baris data

Konsumsi CU

Jika baris yang ingin dihapus tidak ada, jumlah CUs yang dikonsumsi bervariasi berdasarkan nilai parameter condition.
- Jika nilai parameter condition adalah IGNORE, jumlah write CUs yang dikonsumsi dibulatkan ke atas dari hasil rumus berikut: Jumlah write CUs = Ukuran data di semua kolom primary key dari baris / 4 KB.
- Jika nilai parameter condition adalah EXPECT_EXIST, baris gagal dihapus. Satu write CU dan satu read CU dikonsumsi.
Jika baris yang ingin dihapus ada, jumlah CUs yang dikonsumsi bervariasi berdasarkan nilai parameter condition.
- Jika nilai parameter condition adalah IGNORE, jumlah write CUs yang dikonsumsi dibulatkan ke atas dari hasil rumus berikut: Jumlah write CUs = Ukuran data di semua kolom primary key dari baris / 4 KB.
- Jika nilai parameter condition adalah EXPECT_EXIST, baik write maupun read CUs dikonsumsi. Jumlah write CUs yang dikonsumsi dibulatkan ke atas dari hasil rumus berikut: Jumlah write CUs = Ukuran data di semua kolom primary key dari baris / 4 KB. Jumlah read CUs yang dikonsumsi dibulatkan ke atas dari hasil rumus berikut: Jumlah read CUs = Ukuran data di semua kolom primary key dari baris / 4 KB.
Untuk informasi lebih lanjut tentang cara menghitung ukuran data, lihat Ikhtisar Penagihan.
Jika permintaan habis waktu dan hasilnya tidak terdefinisi, CUs mungkin dikonsumsi atau mungkin tidak.
Jika kode status HTTP 5xx dikembalikan, yang menunjukkan kesalahan internal, operasi tidak mengonsumsi CUs. Jika kesalahan lain dikembalikan, satu write CU dikonsumsi.