Insert data by calling the PutRow operation - Tablestore - Alibaba Cloud Dokümantasyon Merkezi

Not

Satır mevcut değilse PutRow bu satırı oluşturur. Satır zaten varsa PutRow satırı üzerine yazar.
Başarılı bir çağrı hata döndürmez.

İstek mesajı yapısı

message PutRowRequest {
    required string table_name = 1;
    required bytes row = 2; // Plainbuffer-encoded binary data.
    required Condition condition = 3;
    optional ReturnContent return_content = 4;
    optional string transaction_id = 5;
}

Name	Type	Required	Description
table_name	string	Yes	Verilerin yazılacağı tablonun adı.
row	bytes	Yes	Yazılacak satır verileri (birincil anahtar sütunları ve öznitelik sütunları dahil). Plainbuffer biçiminde kodlanır. Daha fazla bilgi için bkz. Plainbuffer.
condition	Condition	Yes	Tablestore'un yazma öncesi satırı denetleyip denetlemeyeceğini belirler. Geçerli değerler: IGNORE (varsayılan): Varlık denetimini atlar. EXPECT_EXIST: Yazma işleminden önce satırın mevcut olmasını gerektirir. EXPECT_NOT_EXIST: Yazma işleminden önce satırın mevcut olmamasını gerektirir.
return_content	ReturnContent	No	Başarılı bir yazma işleminden sonra döndürülecek veri türü. Yalnızca birincil anahtar döndürülebilir. Bu parametreyi otomatik artan birincil anahtar sütunu özelliğiyle birlikte kullanın.
transaction_id	string	No	Yerel işlem kimliği. Yerel bir işlem kapsamında veri yazarken gereklidir.

Yanıt mesajı yapısı

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

Name

Type

Description

consumed

ConsumedCapacity

Bu işlem tarafından tüketilen kapasite birimleri. Ayrıntılar için bkz. Kapasite birimi tüketimi.

row

bytes

Döndürülen satır verileri. Yalnızca return_content ayarlandığında mevcuttur. return_content ayarlanmamışsa veya hiçbir veri döndürülmemişse bu alan NULL olur.

Döndürülen veriler PlainBuffer biçiminde kodlanır. PlainBuffer hakkında daha fazla bilgi için bkz. PlainBuffer.

SDK kullanma

Aşağıdaki SDK'lar tek bir satır veri eklemeyi destekler.

Kapasite birimi tüketimi

Satır mevcut değilse kapasite birimi tüketimi koşul denetimine bağlıdır.
- IGNORE: Yazma kapasite birimleri (WCU) tüketilir. WCU = ceil((birincil anahtar boyutu + öznitelik sütunu boyutu) / 4 KB).
- EXPECT_NOT_EXIST: Hem WCU hem de okuma kapasite birimleri (RCU) tüketilir. WCU = ceil((birincil anahtar boyutu + öznitelik sütunu boyutu) / 4 KB). RCU = ceil(birincil anahtar boyutu / 4 KB).
- EXPECT_EXIST: Yazma işlemi başarısız olur ve 1 WCU ile 1 RCU tüketilir.
Satır mevcutsa kapasite birimi tüketimi koşul denetimine bağlıdır.
- IGNORE: WCU tüketilir. WCU = ceil((birincil anahtar boyutu + öznitelik sütunu boyutu) / 4 KB).
- EXPECT_EXIST: Hem WCU hem de RCU tüketilir. WCU = ceil((birincil anahtar boyutu + öznitelik sütunu boyutu) / 4 KB). RCU = ceil(birincil anahtar boyutu / 4 KB).
- EXPECT_NOT_EXIST: Yazma işlemi başarısız olur ve 1 WCU ile 1 RCU tüketilir.
Veri boyutunun nasıl hesaplandığı hakkında bilgi için bkz. Fiyatlandırma.
Koşullu güncelleme işlemlerinde başarı durumunda tüketim yukarıdaki gibi hesaplanır. Başarısızlık durumunda işlem 1 WCU ve 1 RCU tüketir.
İstek zaman aşımına uğrar ve sonuçlar belirsizse kapasite birimleri tüketilebilir veya tüketilmeyebilir.
Bir iç hata (HTTP durum kodu 5xx) kapasite birimi tüketmez. Diğer tüm hatalar 1 WCU tüketir.