Use auto-increment primary key columns - Tablestore SDK for Python - Tablestore

Önkoşullar

Tablestore SDK for Python yükleyin ve bir istemci başlatın. Otomatik artan birincil anahtar sütunları 4.0.0 veya sonraki bir sürümü gerektirir. En son sürümü kullanmanızı öneririz.

İşlev açıklaması

Tablestore, otomatik artan birincil anahtar sütunu için işaretli 64 bitlik bir tamsayı oluşturur. Oluşturulan değerler aynı bölüm anahtarı içinde benzersizdir ve kesinlikle artan sırada olur ancak ardışık olmayabilir.

Otomatik artan birincil anahtar sütunu yapılandırma

Tablo oluştururken, INTEGER türündeki bölüm anahtarı olmayan bir birincil anahtar sütununu PK_AUTO_INCR olarak ayarlayın. Her tabloda en fazla bir otomatik artan birincil anahtar sütunu bulunabilir. Tablo oluşturulduktan sonra bu sütunu ekleyemezsiniz.

Aşağıdaki örnek, example_table tablosunu id bölüm anahtarı ve sequence_id otomatik artan birincil anahtar sütunu ile oluşturur.

table_meta = TableMeta(
    "example_table",
    [
        ("id", "STRING"),
        ("sequence_id", "INTEGER", PK_AUTO_INCR),
    ],
)
table_options = TableOptions()
reserved_throughput = ReservedThroughput(CapacityUnit(0, 0))

client.create_table(table_meta, table_options, reserved_throughput)

Veri yazma ve oluşturulan değeri alma

Veri yazarken, otomatik artan birincil anahtar sütununun değerini PK_AUTO_INCR olarak ayarlayın. Oluşturulan değeri sonraki sorgularda veya güncellemelerde kullanmak için return_type parametresini ReturnType.RT_PK olarak ayarlayın.

primary_key = [
    ("id", "device-001"),
    ("sequence_id", PK_AUTO_INCR),
]
attribute_columns = [("status", "online")]
row = Row(primary_key, attribute_columns)

_, return_row = client.put_row(
    "example_table",
    row,
    return_type=ReturnType.RT_PK,
)

print(return_row.primary_key)

Parametreler

Otomatik artan birincil anahtar sütunu yapılandırması

Otomatik artan birincil anahtar sütununu yapılandıran schema_of_primary_key[] dizisi aşağıdaki öğeleri içerir.

Ad	Tür	Açıklama
name (gerekli)	`str`	Birincil anahtar sütununun adı.
type (gerekli)	`str`	Birincil anahtar sütununun türü. Değeri `INTEGER` olarak ayarlayın.
option (gerekli)	`PrimaryKeyOption`	Birincil anahtar seçeneği. Değeri `PK_AUTO_INCR` olarak ayarlayın. Otomatik artan birincil anahtar sütunu bölüm anahtarı olamaz.

Yazma parametreleri

put_row yöntemi, otomatik artan birincil anahtar sütunlarıyla ilgili aşağıdaki parametreleri içerir.

Ad	Tür	Açıklama
table_name (gerekli)	`str`	Tablonun adı.
row (gerekli)	`Row`	Yazılacak satır. Otomatik artan birincil anahtar sütununun değerini `PK_AUTO_INCR` olarak ayarlayın.
return_type (isteğe bağlı)	`ReturnType`	Yanıt türü. Yazılan satırın birincil anahtarını döndürmek için değeri `RT_PK` olarak ayarlayın. Bu parametreyi belirtmezseniz birincil anahtar döndürülmez.

Yanıt

put_row yöntemi aşağıdaki bilgileri içeren bir dizi döndürür.

Alan	Tür	Açıklama
consumed	`CapacityUnit`	İşlem tarafından tüketilen okuma ve yazma CU'ları.
return_row	`Row`	`return_type` değeri `RT_PK` olarak ayarlandığında, bu alan Tablestore tarafından oluşturulan tam birincil anahtarı içerir. Aksi takdirde değer `None` olur.