主键列自增

1. 创建带有自增主键列的数据表。

   1. 登录表格存储控制台。

   2. 在概览页面，单击实例操作列的实例管理。

   3. 在实例详情页签的数据表列表区域，单击创建数据表。

   4. 在创建数据表对话框，配置数据表名称和表主键，其他参数请根据实际场景进行配置。

      配置表主键时，您需要将其中一个非分区键的主键列类型选择为自增列。

      说明

      关于参数配置的更多信息，请参见数据表操作。

   5. 单击创建。

2. 写入数据。

   1. 在实例详情页签的数据表列表区域，单击数据表名称。

   2. 在数据管理页签，单击插入数据。

   3. 在插入数据对话框，输入主键值以及根据实际增加属性列。

      其中自增列的值无需填写，系统会在写入数据时自动生成自增列的值。通过多次单击图标并配置属性列的名称、类型、属性值等信息，您可以增加多个属性列。

   4. 单击确定。

      系统会显示写入成功的数据。请记录行数据的完整主键信息用于后续更新或者读取数据。

1. 创建并使用带有自增主键列的数据表。

   1. 执行create命令创建数据表。更多信息，请参见创建表。

      以下示例用于创建带有自增主键列的mytable数据表。该数据表有uid（string类型）和pid（integer类型）两个主键列并设置第二主键列pid（integer类型）为自增列，表中数据永不过期。

      create -t mytable --pk '[{"c":"uid", "t":"string"}, {"c":"pid", "t":"integer", "opt":"auto"}]'

   2. 执行use --wc -t mytable命令使用数据表。

2. 执行put命令写入一行数据。更多信息，请参见插入新数据。

   说明

   写入数据后，如果需要获取完整主键信息，您可以执行scan命令获取指定行数据。更多信息，请参见扫描数据或者导出数据。

   以下示例用于在数据表中插入一行数据。该行的第一主键列值为“86”，第二主键列值为null，属性列有name（string类型）和country（string类型）两列。

   put --pk '["86", null]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'

您可以通过Java SDK、Go SDK、Python SDK、Node.js SDK、.NET SDK和PHP SDK使用主键自增列功能。此处以Java SDK为例介绍主键自增列的使用。

以下示例代码在 test_table 表中写入一行数据，同时获取并打印写入行数据的主键信息。

public static void putRowTest(SyncClient client) {
    // 构造主键
    PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
    primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
    // 设置自增列为占位符
    primaryKeyBuilder.addPrimaryKeyColumn("incr", PrimaryKeyValue.AUTO_INCREMENT);
    PrimaryKey primaryKey = primaryKeyBuilder.build();

    // 构造写入行数据
    RowPutChange rowPutChange = new RowPutChange("test_table", primaryKey);
    rowPutChange.addColumn("col1", ColumnValue.fromString("val1"));
    // 设置返回类型为 RT_PK，返回写入行数据的主键信息
    rowPutChange.setReturnType(ReturnType.RT_PK);

    // 调用 putRow 方法写入行数据
    PutRowRequest putRowRequest = new PutRowRequest();
    putRowRequest.setRowChange(rowPutChange);
    PutRowResponse putRowResponse = client.putRow(putRowRequest);

    // RequestId 和 读写 CU 消耗
    System.out.println("RequestId: " + putRowResponse.getRequestId());
    System.out.println("Read CU Cost: " + putRowResponse.getConsumedCapacity().getCapacityUnit().getReadCapacityUnit());
    System.out.println("Write CU Cost: " + putRowResponse.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());

    // 获取返回的主键信息并打印，如果不设置返回类型为 RT_PK，默认不返回主键信息
    Row row = putRowResponse.getRow();
    if(row != null)
        System.out.println(row.getPrimaryKey().toString());
}