Tablestore:自動インクリメントプライマリキー列の使用

自動インクリメントプライマリキー列の構成

テーブルを作成する際、INTEGER 型の非パーティションプライマリキー列を PK_AUTO_INCR に設定します。各テーブルには、最大 1 つの自動インクリメントプライマリキー列を設定できます。テーブル作成後に追加することはできません。

次の例では、パーティションキー id と自動インクリメントプライマリキー列 sequence_id を持つ example_table を作成します。

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)

データ書き込みと生成値の取得

データを書き込む際、自動インクリメントプライマリキー列の値を PK_AUTO_INCR に設定します。後続のクエリや更新で生成された値を使用する場合は、return_type を 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)

自動インクリメントプライマリキー列の構成

schema_of_primary_key[] 内で自動インクリメントプライマリキー列を構成するタプルには、以下の要素が含まれます。

書き込みパラメーター

put_row メソッドには、自動インクリメントプライマリキー列に関連する以下のパラメーターがあります。