Gunakan kolom kunci utama auto-increment - Tablestore SDK untuk Python - Tablestore

Gunakan Tablestore SDK untuk Python guna mengonfigurasi kolom kunci utama auto-increment dan memperoleh nilai yang dihasilkannya saat menulis data.

Prasyarat

Instal Tablestore SDK untuk Python dan inisialisasi klien. Kolom kunci utama auto-increment memerlukan versi 4.0.0 atau lebih baru. Disarankan untuk menggunakan versi terbaru.

Deskripsi fungsi

Tablestore menghasilkan bilangan bulat bertanda 64-bit untuk kolom kunci utama auto-increment. Nilai yang dihasilkan bersifat unik dan selalu meningkat dalam partisi kunci yang sama, meskipun mungkin tidak berurutan.

Konfigurasi kolom kunci utama auto-increment

Saat membuat tabel, atur kolom kunci utama non-partisi dengan tipe INTEGER ke PK_AUTO_INCR. Setiap tabel hanya dapat memiliki satu kolom kunci utama auto-increment, dan kolom tersebut tidak dapat ditambahkan setelah tabel dibuat.

Contoh berikut membuat tabel example_table dengan kunci partisi id dan kolom kunci utama auto-increment sequence_id.

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)

Tulis data dan peroleh nilai yang dihasilkan

Saat menulis data, atur nilai kolom kunci utama auto-increment ke PK_AUTO_INCR. Untuk menggunakan nilai yang dihasilkan dalam kueri atau pembaruan berikutnya, atur return_type ke ReturnType.RT_PK.

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)

Parameter

Konfigurasi kolom kunci utama auto-increment

Tupel dalam schema_of_primary_key[] yang mengonfigurasi kolom kunci utama auto-increment berisi elemen-elemen berikut.

Name	Type	Description
name (required)	`str`	Nama kolom kunci utama.
type (required)	`str`	Tipe kolom kunci utama. Atur nilainya ke `INTEGER`.
option (required)	`PrimaryKeyOption`	Opsi kunci utama. Atur nilainya ke `PK_AUTO_INCR`. Kolom kunci utama auto-increment tidak dapat menjadi kunci partisi.

Parameter penulisan

Metode put_row mencakup parameter berikut yang terkait dengan kolom kunci utama auto-increment.

Name	Type	Description
table_name (required)	`str`	Nama tabel.
row (required)	`Row`	Baris yang akan ditulis. Atur nilai kolom kunci utama auto-increment ke `PK_AUTO_INCR`.
return_type (optional)	`ReturnType`	Tipe respons. Atur nilainya ke `RT_PK` untuk mengembalikan kunci utama dari baris yang ditulis. Jika Anda tidak menentukan parameter ini, kunci utama tidak dikembalikan.

Respons

Metode put_row mengembalikan tupel yang berisi informasi berikut.

Field	Type	Description
consumed	`CapacityUnit`	CU baca dan tulis yang dikonsumsi oleh operasi.
return_row	`Row`	Jika `return_type` diatur ke `RT_PK`, bidang ini berisi kunci utama lengkap yang dihasilkan oleh Tablestore. Jika tidak, nilainya adalah `None`.