表操作

接口

表操作包括CreateTable、ListTable、UpdateTable、DescribeTable和DeleteTable接口，详细说明请参见下表。

创建数据表（CreateTable）

使用CreateTable接口创建数据表时，需要指定数据表的结构信息和配置信息，高性能实例中的数据表还可以根据需要设置预留读/写吞吐量。创建数据表的同时支持创建一个或者多个索引表。

使用SDK

参数

示例

• 创建数据表（不带索引）

  private static void createTable(SyncClient client) {
          TableMeta tableMeta = new TableMeta(TABLE_NAME);
          tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema(PRIMARY_KEY_NAME, PrimaryKeyType.STRING)); //为主表添加主键列。
          int timeToLive = -1; //数据的过期时间，单位为秒，-1表示永不过期。带索引表的数据表数据生命周期必须设置为-1。
          int maxVersions = 3; //保存的最大版本数，1表示每列上最多保存一个版本即保存最新的版本。带索引表的数据表最大版本数必须设置为1。
          TableOptions tableOptions = new TableOptions(timeToLive, maxVersions);
          CreateTableRequest request = new CreateTableRequest(tableMeta, tableOptions);
          request.setReservedThroughput(new ReservedThroughput(new CapacityUnit(0, 0))); //设置预留读写吞吐量，容量型实例中的数据表只能设置为0，高性能实例中的数据表可以设置为非零值。
          client.createTable(request);
  }

• 创建数据表（带索引且索引类型为全局二级索引）

  private static void createTable(SyncClient client) {
      TableMeta tableMeta = new TableMeta(TABLE_NAME);
      tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema(PRIMARY_KEY_NAME_1, PrimaryKeyType.STRING)); //为数据表添加主键列。
      tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema(PRIMARY_KEY_NAME_2, PrimaryKeyType.INTEGER)); //为数据表添加主键列。
      tableMeta.addDefinedColumn(new DefinedColumnSchema(DEFINED_COL_NAME_1, DefinedColumnType.STRING)); //为数据表添加预定义列。
      tableMeta.addDefinedColumn(new DefinedColumnSchema(DEFINED_COL_NAME_2, DefinedColumnType.INTEGER)); //为数据表添加预定义列。
  
      int timeToLive = -1; //数据的过期时间，单位为秒，-1表示永不过期。带索引表的数据表数据生命周期必须设置为-1。
      int maxVersions = 1; //保存的最大版本数，1表示每列上最多保存一个版本即保存最新的版本。带索引表的数据表最大版本数必须设置为1。
  
      TableOptions tableOptions = new TableOptions(timeToLive, maxVersions);
  
      ArrayList<IndexMeta> indexMetas = new ArrayList<IndexMeta>();
      IndexMeta indexMeta = new IndexMeta(INDEX_NAME);
      indexMeta.addPrimaryKeyColumn(DEFINED_COL_NAME_1); //为索引表添加主键列。
      indexMeta.addDefinedColumn(DEFINED_COL_NAME_2); //为索引表添加属性列。
      indexMetas.add(indexMeta);
  
      CreateTableRequest request = new CreateTableRequest(tableMeta, tableOptions, indexMetas); //创建数据表的同时创建索引表。
  
      client.createTable(request);
  }

• 创建数据表（带索引且索引类型为本地二级索引）

  private static void createTable(SyncClient client) {
      TableMeta tableMeta = new TableMeta(TABLE_NAME);
      tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema(PRIMARY_KEY_NAME_1, PrimaryKeyType.STRING)); //为数据表添加主键列。
      tableMeta.addPrimaryKeyColumn(new PrimaryKeySchema(PRIMARY_KEY_NAME_2, PrimaryKeyType.INTEGER)); //为数据表添加主键列。
      tableMeta.addDefinedColumn(new DefinedColumnSchema(DEFINED_COL_NAME_1, DefinedColumnType.STRING)); //为数据表添加预定义列。
      tableMeta.addDefinedColumn(new DefinedColumnSchema(DEFINED_COL_NAME_2, DefinedColumnType.INTEGER)); //为数据表添加预定义列。
  
      int timeToLive = -1; //数据的过期时间，单位为秒，-1表示永不过期。带索引表的数据表数据生命周期必须设置为-1。
      int maxVersions = 1; //保存的最大版本数，1表示每列上最多保存一个版本即保存最新的版本。带索引表的数据表最大版本数必须设置为1。
  
      TableOptions tableOptions = new TableOptions(timeToLive, maxVersions);
  
      ArrayList<IndexMeta> indexMetas = new ArrayList<IndexMeta>();
      IndexMeta indexMeta = new IndexMeta(INDEX_NAME);
      indexMeta.setIndexType(IT_LOCAL_INDEX);     //设置索引类型为本地二级索引（IT_LOCAL_INDEX）。
      indexMeta.setIndexUpdateMode(IUM_SYNC_INDEX);  //设置索引更新模式为同步更新（IUM_SYNC_INDEX）。当索引类型为本地二级索引时，索引更新模式必须为同步更新。
  
      indexMeta.addPrimaryKeyColumn(PRIMARY_KEY_NAME_1); //为索引表添加主键列。索引表的第一列主键必须与数据表的第一列主键相同。
      indexMeta.addPrimaryKeyColumn(DEFINED_COL_NAME_1); //为索引表添加主键列。
      indexMeta.addDefinedColumn(DEFINED_COL_NAME_2); //为索引表添加属性列。
      indexMetas.add(indexMeta);
  
      CreateTableRequest request = new CreateTableRequest(tableMeta, tableOptions, indexMetas); //创建数据表的同时创建索引表。
  
      client.createTable(request);
  }

列出表名称（ListTable）

使用ListTable接口获取当前实例下已创建的所有表的表名。

使用SDK

示例

获取实例下所有表的表名。

private static void listTable(SyncClient client) {
    ListTableResponse response = client.listTable();
    System.out.println("表的列表如下：");
    for (String tableName : response.getTableNames()) {
        System.out.println(tableName);
    }
}

更新表信息（UpdateTable）

使用UpdateTable接口修改配置信息（TableOptions）、预留读吞吐量或者预留写吞吐量（ReservedThroughput）。

使用SDK

参数

• TableOptions

  TableOptions 包含表的 TTL、MaxVersions 和 MaxTimeDeviation 。

  参数	定义	说明
  TTL	TimeToLive，数据存活时间	单位：秒。 如果期望数据永不过期，TTL 可设置为 -1。 数据是否过期是根据数据的时间戳、当前时间、表的 TTL三者进行判断的。当前时间 - 数据的时间戳 > 表的 TTL时，数据会过期并被清理。 在使用 TTL 功能时需要注意写入时是否指定了时间戳，以及指定的时间戳是否合理。如需指定时间戳，建议设置MaxTimeDeviation。
  MaxTimeDeviation	写入数据的时间戳与系统当前时间的偏差允许最大值	默认情况下系统会为新写入的数据生成一个时间戳，数据自动过期功能需要根据这个时间戳判断数据是否过期。用户也可以指定写入数据的时间戳。如果用户写入的时间戳非常小，与当前时间偏差已经超过了表上设置的 TTL 时间，写入的数据会立即过期。设置 MaxTimeDeviation 可以避免这种情况。 单位：秒。
  MaxVersions	每个属性列保留的最大版本数	如果写入的版本数超过 MaxVersions，服务端只会保留 MaxVersions 中指定的最大的版本。

• ReservedThroughtput

  表的预留读/写吞吐量配置。

  • ReservedThroughput 的调整有时间间隔限制，目前调整间隔为 1 分钟。
  • 设置 ReservedThroughtput 后，表格存储按照您预留读/写吞吐量进行计费。
  • 当 ReservedThroughtput 大于 0 时，表格存储会按照预留量和持续时间进行计费，超出预留的部分进行按量计费。更多信息参见计费，以免产生未期望的费用。
  • 默认值为 0，即完全按量计费。
  • 容量型实例的预留读/写吞吐量只能设置为 0，不允许预留。

示例

更新表的TTL和最大版本数。

private static void updateTable(SyncClient client) {
    int timeToLive = -1;
    int maxVersions = 5; // 将最大版本数更新为5。
    TableOptions tableOptions = new TableOptions(timeToLive, maxVersions);
    UpdateTableRequest request = new UpdateTableRequest(TABLE_NAME);
    request.setTableOptionsForUpdate(tableOptions);
    client.updateTable(request);
}

查询表描述信息（DescribeTable）

使用DescribeTable接口可以查询指定表的结构、预留读/写吞吐量详情等信息。

使用SDK

参数

示例

private static void describeTable(SyncClient client) {
    DescribeTableRequest request = new DescribeTableRequest(TABLE_NAME);
    DescribeTableResponse response = client.describeTable(request);
    TableMeta tableMeta = response.getTableMeta();
    System.out.println("表的名称：" + tableMeta.getTableName());
    System.out.println("表的主键：");
    for (PrimaryKeySchema primaryKeySchema : tableMeta.getPrimaryKeyList()) {
        System.out.println(primaryKeySchema);
    }
    TableOptions tableOptions = response.getTableOptions();
    System.out.println("表的TTL:" + tableOptions.getTimeToLive());
    System.out.println("表的MaxVersions:" + tableOptions.getMaxVersions());
    ReservedThroughputDetails reservedThroughputDetails = response.getReservedThroughputDetails();
    System.out.println("表的预留读吞吐量："
            + reservedThroughputDetails.getCapacityUnit().getReadCapacityUnit());
    System.out.println("表的预留写吞吐量："
            + reservedThroughputDetails.getCapacityUnit().getWriteCapacityUnit());
}

删除数据表（DeleteTable）

使用DeleteTable接口删除当前实例下指定数据表。

使用SDK

参数

示例

private static void deleteTable(SyncClient client) {
    DeleteTableRequest request = new DeleteTableRequest(TABLE_NAME);
    client.deleteTable(request);
}

其他操作方式

您还可以使用控制台或者命令行工具进行表操作。

• 使用控制台
• 使用命令行工具