主键列自增

配置自增主键列

创建数据表时，调用 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 包含以下与主键列自增相关的参数。