Tablestore：主鍵列自增

配置自增主鍵列

建立資料表時，調用 AddPrimaryKeyColumnOption 並將主鍵列配置設定為 AUTO_INCREMENT。

以下樣本建立 example_table 資料表，使用 user_id 作為分區鍵，使用 record_id 作為自增主鍵列。

tableMeta := &tablestore.TableMeta{TableName: "example_table"}
tableMeta.AddPrimaryKeyColumn("user_id", tablestore.PrimaryKeyType_STRING)
tableMeta.AddPrimaryKeyColumnOption(
    "record_id",
    tablestore.PrimaryKeyType_INTEGER,
    tablestore.AUTO_INCREMENT,
)

request := &tablestore.CreateTableRequest{
    TableMeta:          tableMeta,
    TableOption:        &tablestore.TableOption{TimeToAlive: -1, MaxVersion: 1},
    ReservedThroughput: &tablestore.ReservedThroughput{},
}

_, err := client.CreateTable(request)
if err != nil {
    log.Fatal(err)
}

建立資料表後，等待資料表載入完成再寫入資料。

寫入資料並擷取自增值

寫入資料時，調用 AddPrimaryKeyColumnWithAutoIncrement 為自增列設定預留位置，並調用 SetReturnPk 使響應返回包含自增值的完整主鍵。自增主鍵寫入的行存在性條件必須設定為 RowExistenceExpectation_IGNORE。

以下樣本寫入一行資料並擷取服務端產生的 record_id 值。

primaryKey := &tablestore.PrimaryKey{}
primaryKey.AddPrimaryKeyColumn("user_id", "user-a")
primaryKey.AddPrimaryKeyColumnWithAutoIncrement("record_id")

change := &tablestore.PutRowChange{
    TableName:  "example_table",
    PrimaryKey: primaryKey,
}
change.AddColumn("status", "created")
change.SetCondition(tablestore.RowExistenceExpectation_IGNORE)
change.SetReturnPk()

response, err := client.PutRow(&tablestore.PutRowRequest{PutRowChange: change})
if err != nil {
    log.Fatal(err)
}

fmt.Println(response.PrimaryKey)

自增主鍵列

PrimaryKeySchema 包含以下與主鍵列自增相關的參數。

寫入配置

PutRowChange 包含以下與主鍵列自增相關的參數。