Bir veri satırını siler.
İstek sözdizimi
message DeleteRowRequest {
required string table_name = 1;
required bytes primary_key = 2; // The primary key is encoded as binary data in the PlainBuffer format.
required Condition condition = 3;
optional ReturnContent return_content = 4;
optional string transaction_id = 5;
}|
Parametre |
Tür |
Zorunlu |
Açıklama |
|
table_name |
string |
Evet |
Veri tablosunun adı. |
|
primary_key |
bytes |
Evet |
Silmek istediğiniz satırın birincil anahtarı. Birincil anahtar, PlainBuffer biçiminde kodlanır. PlainBuffer hakkında daha fazla bilgi için bkz. PlainBuffer. |
|
condition |
Evet |
Veri işleminden önce satır varlık kontrolünün yapılıp yapılmayacağını belirtir. Varsayılan değer: IGNORE. Geçerli değerler:
|
|
|
return_content |
Hayır |
Satır başarıyla yazıldıktan sonra döndürülecek verinin türü. Yalnızca birincil anahtar döndürülebilir. Bu parametre çoğunlukla otomatik artan birincil anahtar sütunu özelliği tarafından kullanılır. |
|
|
transaction_id |
string |
Hayır |
Yerel işlemin ID değeri. Verileri silmek için yerel bir işlem kullanmak istiyorsanız bu parametre gereklidir. |
Yanıt sözdizimi
message DeleteRowResponse {
required ConsumedCapacity consumed = 1;
optional bytes row = 2;
}|
|
|
|
|
|
|
|
|
|
|
return_content için bir değer belirttiyseniz döndürülen veriler. return_content için bir değer belirtmezseniz veya döndürülen bir değer yoksa NULL döndürülür. Döndürülen veriler PlainBuffer biçiminde kodlanır. PlainBuffer hakkında daha fazla bilgi için bkz. PlainBuffer. |
Tablestore SDK'lerini kullanma
Tek bir veri satırını silmek için aşağıdaki Tablestore SDK'lerini kullanabilirsiniz:
Tablestore SDK for Java: Tek bir veri satırını silin
Tablestore SDK for Go: Tek bir veri satırını silin
Tablestore SDK for Python: Tek bir veri satırını silin
Tablestore SDK for Node.js: Tek bir veri satırını silin
Tablestore SDK for .NET: Tek bir veri satırını silin
Tablestore SDK for PHP: Tek bir veri satırını silin
CU tüketimi
-
Silmek istediğiniz satır mevcut değilse, tüketilen CU sayısı condition parametresi için belirttiğiniz değere göre değişir.
condition parametresinin değeri IGNORE ise, tüketilen yazma CU sayısı aşağıdaki formül kullanılarak hesaplanan değerden yukarı yuvarlanır: Tüketilen yazma CU sayısı = Satırın tüm birincil anahtar sütunlarındaki veri boyutu / 4 KB.
condition parametresinin değeri EXPECT_EXIST ise, satır silinemez. Bir yazma CU ve bir okuma CU tüketilir.
-
Silmek istediğiniz satır mevcut ise, tüketilen CU sayısı condition parametresi için belirttiğiniz değere göre değişir.
condition parametresinin değeri IGNORE ise, tüketilen yazma CU sayısı aşağıdaki formül kullanılarak hesaplanan değerden yukarı yuvarlanır: Tüketilen yazma CU sayısı = Satırın tüm birincil anahtar sütunlarındaki veri boyutu / 4 KB.
condition parametresinin değeri EXPECT_EXIST ise hem yazma hem de okuma CU'ları tüketilir. Tüketilen yazma CU sayısı aşağıdaki formül kullanılarak hesaplanan değerden yukarı yuvarlanır: Tüketilen yazma CU sayısı = Satırın tüm birincil anahtar sütunlarındaki veri boyutu / 4 KB. Tüketilen okuma CU sayısı aşağıdaki formül kullanılarak hesaplanan değerden yukarı yuvarlanır: Tüketilen okuma CU sayısı = Satırın tüm birincil anahtar sütunlarındaki veri boyutu / 4 KB.
Veri boyutunun nasıl hesaplanacağı hakkında daha fazla bilgi için bkz. Faturalandırmaya genel bakış.
İstek zaman aşımına uğrar ve sonuçlar tanımsız olursa CU'lar tüketilebilir veya tüketilmeyebilir.
Dahili bir hata oluştuğunu gösteren bir HTTP durum kodu 5xx döndürülürse işlem CU tüketmez. Diğer hatalar döndürülürse bir yazma CU tüketilir.