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為例介紹主鍵自增列的使用。

1. 創建帶有自增主鍵列的數據表。

   創建表時，只需將自增的主鍵屬性設置為AUTO_INCREMENT。

   以下示例用于創建數據表時配置主鍵自增列。該表的主鍵為pk1（String類型）和pk2（Integer類型），其中pk1主鍵列為分區鍵，pk2主鍵列為自增列。

   private static void createTable(SyncClient client) {
       //設置數據表名稱。
       TableMeta tableMeta = new TableMeta("<TABLE_NAME>");
       //為數據表添加主鍵列。第一列為分區鍵。
       tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema("pk1", PrimaryKeyType.STRING));
       //為數據表添加主鍵列。第二列為自增列，類型為INTEGER，屬性為AUTO_INCREMENT。
       tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema("pk2", PrimaryKeyType.INTEGER, PrimaryKeyOption.AUTO_INCREMENT));
       //數據的過期時間，單位為秒，-1表示數據永不過期。
       int timeToLive = -1;  
       //保存的最大版本數，1表示每列上最多保存一個版本即保存最新的版本。
       int maxVersions = 1; 
       TableOptions tableOptions = new TableOptions(timeToLive, maxVersions);
       CreateTableRequest request = new CreateTableRequest(tableMeta, tableOptions);
       client.createTable(request);
   }

2. 寫入數據。

   寫入數據時，無需為自增列設置具體值，只需將自增列的值設置為占位符AUTO_INCREMENT。

   以下示例用于向數據表中寫入一行數據，并返回完整主鍵值和消耗的預留讀寫吞吐量。

   private static void putRow(SyncClient client, String receive_id) {
       //構造主鍵。
       PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
       //第一列的值為receive_id（String類型）參數的值。
       primaryKeyBuilder.addPrimaryKeyColumn("pk1", PrimaryKeyValue.fromString(receive_id));
       //第二列是主鍵自增列，此處無需填入具體值，只需要一個占位符AUTO_INCREMENT，表格存儲會自動生成此值。
       primaryKeyBuilder.addPrimaryKeyColumn("pk2", PrimaryKeyValue.AUTO_INCREMENT);
       PrimaryKey primaryKey = primaryKeyBuilder.build();
       //設置數據表名稱。
       RowPutChange rowPutChange = new RowPutChange("<TABLE_NAME>", primaryKey);
       //此處設置返回類型為RT_PK，即在返回結果中包含PK列的值。如果不設置ReturnType，默認不返回。
       rowPutChange.setReturnType(ReturnType.RT_PK);
       //加入屬性列。
       rowPutChange.addColumn(new Column("content", ColumnValue.fromString("content")));
       //寫入數據到表格存儲。
       PutRowResponse response = client.putRow(new PutRowRequest(rowPutChange));
       //打印返回的PK列。
       Row returnRow = response.getRow();
       if (returnRow != null) {
           System.out.println("PrimaryKey:" + returnRow.getPrimaryKey().toString());
       }
       //打印消耗的CU。
       CapacityUnit  cu = response.getConsumedCapacity().getCapacityUnit();
       System.out.println("Read CapacityUnit:" + cu.getReadCapacityUnit());
       System.out.println("Write CapacityUnit:" + cu.getWriteCapacityUnit());
   }