表操作

更新时间：2019-11-05

创建表CreateTable

描述

在指定instance下创建一张表，表名限制字符个数1-255，满足正则：[a-zA-Z_][a-za-z0-9_]{0,254}，以字母或下划线开头。表名不符合规范时会抛出BceClientException。

请求参数

参数	参数类型	说明
tableName	String	期望创建的表的名称，创建表时必须指定。
tableOption	TableOption	配置信息，创建表时必须指定。
+tableVersion	long	表版本号，创建表时必须为0，非0时会抛出BceClientException。
+compressType	CompressType（enum）	压缩方式，可取以下值： NONE：不压缩 SNAPPY_ALL：使用snappy压缩 DEFAULT：使用操作的默认值，不同操作中含义不同创建表时默认为NONE。
+ttl	int	数据过期时间，单位为秒，设为0表示永不过期，默认值为0。
+storageType	String	表存储类型，可取以下值： HighPerformance：使用SSD存储 CommonPerformance：使用SATA存储创建表时若不指定则默认使用Instance的表存储类型。
+maxVersions	int	最多保留版本数，取值范围[1, 50000]

返回参数

无

示例

其中，BceClientException相关信息参见异常处理

Plain Text

1private static void myCreateTable(TableStorageClient tableStorageClient) {
2    // 设置表参数
3    TableOption createTableOption = new TableOption();
4    createTableOption.setTableVersion(0);
5    createTableOption.setTtl(24 * 3600);
6    createTableOption.setCompressType(CompressType.NONE);
7    createTableOption.setStorageType(TableStorageConstants.STORAGE_TYPE_COMMON_PERFORMANCE);
8    createTableOption.setMaxVersions(10);
9    // 指定表名，其中TABLE_NAME为期望创建表的表名
10    CreateTableRequest createTableRequest = new CreateTableRequest(TABLE_NAME, createTableOption);
11    try{
12        // 创建一张表
13        tableStorageClient.createTable(createTableRequest);
14    } catch(BceClientException e) {
15        return;
16    }
17}

更新表UpdateTable

描述

更新一张表的指定信息。

请求参数

参数	参数类型	说明
tableName	String	期望更新的表的名称，更新表时必须指定，且更新表不允许修改表的名称
tableOption	TableOption	配置信息，更新表时必须指定
+tableVersion	long	表版本号，更新表时其值为表当前的版本号，可以通过ShowTable操作获取。此外，更新表时必须不为0，为0时会抛出BceClientException
+compressType	CompressType（enum）	压缩方式，可取以下值： NONE：不压缩 SNAPPY_ALL：使用snappy压缩 DEFAULT：使用操作的默认值，不同操作中含义不同默认为不更新压缩方式。
+ttl	int	数据过期时间，单位为秒，设为0表示永不过期
+maxVersions	int	最多保留版本数，取值范围[1, 50000]

返回参数

无

示例

其中，BceClientException相关信息参见异常处理

Plain Text

1private static void myUpdateTable(TableStorageClient tableStorageClient) {
2    // 设置表参数
3    TableOption updateTableOption = new TableOption();
4    updateTableOption.setTableVersion(TABLE_VERSION);
5    updateTableOption.setTimeToLive(0);
6    updateTableOption.setCompressType(CompressType.SNAPPY_ALL);
7    updateTableOption.setMaxVersions(15);
8    // 指定表，其中TABLE_NAME为期望创建表的表名
9    UpdateTableRequest updateTableRequest = new UpdateTableRequest(TABLE_NAME, updateTableOption);
10    try {
11        // 修改表结构
12        tableStorageClient.updateTable(updateTableRequest);
13    } catch(BceClientException e) {
14        return;
15    }
16}

删除表DropTable

描述

删除一张表。

请求参数

参数	参数类型	说明
tableName	String	期望删除的表的名称

返回参数 无

示例其中，BceClientException相关信息参见异常处理

Plain Text

1private static void myDropTable(TableStorageClient tableStorageClient) {
2    // 指定表，其中TABLE_NAME为期望删除表的表名
3    DropTableRequest dropTableRequest = new DropTableRequest(TABLE_NAME);
4    try {
5        // 删除指定表
6        tableStorageClient.dropTable(dropTableRequest);
7    } catch (BceClientException e) {
8        return;
9    }
10}

显示表信息ShowTable

描述

查询一张表的信息。

请求参数

参数	参数类型	说明
tableName	String	期望查询的表的名称

返回参数

ShowTable操作获取到表的信息如下：

参数名称	参数类型	说明
instance	String	表所在实例的名称
tableName	String	表的名称
tableState	String	表的状态信息，目前有以下四种状态： Normal：表状态正常，可正常读写 Creating：表正在创建中 Updating：表正在更新中 Dropping：表正在被删除
tableVersion	long	当前table版本号，值是最后一次更新的微秒级时间戳
createTime	String	表创建的UTC时间
compressType	String	数据压缩方式，默认为不压缩，可取以下值： NONE ：不压缩 SNAPPY_ALL ：使用snappy压缩
ttl	int	数据过期时间，为0时永不过期，默认永不过期，单位秒
storageType	String	表存储类型，可取以下值： HighPerformance：SSD存储 CommonPerformance：SATA存储
maxVersions	int	最多保留版本数，取值范围[1, 50000]

示例其中，BceClientException相关信息参见异常处理

Plain Text

1private static void myShowTable(TableStorageClient tableStorageClient) {
2    // 指定表，其中TABLE_NAME为期望展示表的表名
3    ShowTableRequest showTableRequest = new ShowTableRequest(TABLE_NAME);
4    try {
5        // 获取指定表结构信息
6        ShowTableResponse response = tableStorageClient.showTable(showTableRequest);
7        // 打印表结构信息
8        System.out.println("==================================");
9        System.out.println("ShowTableResponse result:");
10        System.out.println("  tableName=" + response.getTableName());
11        System.out.println("  tableState=" + response.getTableState());
12        System.out.println("  tableVersion=" + response.getTableVersion());
13        System.out.println("  createTime=" + response.getCreateTime());
14        System.out.println("  compressType=" + response.getCompressType());
15        System.out.println("  ttl=" + response.getTtl());
16        System.out.println("  storageType=" + response.getStorageType());
17        System.out.println("  maxVersions=" + response.getMaxVersions());
18        System.out.println("==================================");
19    } catch (BceClientException e) {
20        return;
21    }
22}

列举所有表ListTable

描述

列举实例下所有表名称。

请求参数 无

返回参数

ListTable操作获取到表的信息如下：

参数名称	参数类型	说明
tables	List	table列表
+tableName	String	表名称
+tableState	String	表状态信息，有如下取值：<br/normal：表状态正常，可正常读写 Creating：表正在创建中 Dropping：表正在被删除
+tableVersion	long	当前table版本号，值是最后一次更新的时间戳
+createTime	String	表创建的UTC时间
+storageType	String	表存储类型,可以取以下值： HighPerformance：SSD存储 CommonPerformance：SATA存储
maxVersions	int	最多保留版本数，取值范围[1, 50000]

示例

其中，BceClientException相关信息参见异常处理

Plain Text

1private static void myListTables(TableStorageClient tableStorageClient) {
2    ListTablesRequest listTablesRequest = new ListTablesRequest();
3    try {
4        // 列举当前实例下的所有表
5        ListTablesResponse response = tableStorageClient.listTables(listTablesRequest);
6        // 打印列举表信息
7        System.out.println("==================================");
8        System.out.println("ListTableResponse result:");
9        for (ListTablesResponse.TableInfo info : response.getTables()) {
10            System.out.println("TableInfo result:");
11            System.out.println("    tableName=" + info.getTableName() + ",");
12            System.out.println("    tableState=" + info.getTableState() + ",");
13            System.out.println("    tableVersion=" + info.getTableVersion() + ",");
14            System.out.println("    tableStorageType=" + info.getStorageType());
15            System.out.println("    maxVersions=" + info.getMaxVersions());
16        }
17        System.out.println("==================================");
18    } catch (BceClientException e) {
19        return;
20    }
21}

初始化

行操作

云数据库 TableStorage

云数据库 TableStorage

表操作

创建表CreateTable

更新表UpdateTable

删除表DropTable

显示表信息ShowTable

列举所有表ListTable