查看表组信息

表组创建后，可以查看表组的信息，包括表组的 SHARDING 属性、表组内的表、表组创建时间以及表组内表的 Location 信息。

查看表组的 SHARDING 属性

通过视图查看表组属性及表的分区信息

系统租户和 MySQL 用户租户可以分别通过视图 CDB_OB_TABLEGROUPS 和 视图 DBA_OB_TABLEGROUPS 来查看表组的 SHARDING 属性及表组内表的分区信息，语句如下。

• 系统租户

  SELECT * FROM oceanbase.CDB_OB_TABLEGROUPS WHERE tablegroup_name = 'tblgroup1';
  

  查询结果如下：

  +-----------+-----------------+-------------------+----------------------+-----------------+------------------------+------------------------+---------------------------+----------+
  | TENANT_ID | TABLEGROUP_NAME | PARTITIONING_TYPE | SUBPARTITIONING_TYPE | PARTITION_COUNT | DEF_SUBPARTITION_COUNT | PARTITIONING_KEY_COUNT | SUBPARTITIONING_KEY_COUNT | SHARDING |
  +-----------+-----------------+-------------------+----------------------+-----------------+------------------------+------------------------+---------------------------+----------+
  |      1002 | tblgroup1       | NONE              | NONE                 |            NULL |                   NULL |                   NULL |                      NULL | ADAPTIVE |
  |      1004 | TBLGROUP1       | NONE              | NONE                 |            NULL |                   NULL |                   NULL |                      NULL | NONE     |
  +-----------+-----------------+-------------------+----------------------+-----------------+------------------------+------------------------+---------------------------+----------+
  2 rows in set
  

• MySQL 用户租户

  SELECT * FROM oceanbase.DBA_OB_TABLEGROUPS WHERE tablegroup_name = 'tblgroup1';
  

  查询结果如下：

  +-----------------+-------------------+----------------------+-----------------+------------------------+------------------------+---------------------------+----------+
  | TABLEGROUP_NAME | PARTITIONING_TYPE | SUBPARTITIONING_TYPE | PARTITION_COUNT | DEF_SUBPARTITION_COUNT | PARTITIONING_KEY_COUNT | SUBPARTITIONING_KEY_COUNT | SHARDING |
  +-----------------+-------------------+----------------------+-----------------+------------------------+------------------------+---------------------------+----------+
  | tblgroup1       | NONE              | NONE                 |            NULL |                   NULL |                   NULL |                      NULL | ADAPTIVE |
  +-----------------+-------------------+----------------------+-----------------+------------------------+------------------------+---------------------------+----------+
  1 row in set 
  

查询结果中的各字段说明如下：

• TENANT_ID：表组所属的租户名。

• TABLEGROUP_NAME：表组名。

• PARTITIONING_TYPE、SUBPARTITIONING_TYPE、PARTITION_COUNT、DEF_SUBPARTITION_COUNT、PARTITIONING_KEY_COUNT、SUBPARTITIONING_KEY_COUNT：V3.x 版本中具有分区定义的表组的属性，当前版本显示为 NONE 或 NULL。

• SHARDING：表组的 SHARDING 属性。

  • 对于 SHARDING 属性为 NONE 的表组，表组内的所有表的所有分区均聚集在同一台机器上，并且对加入表组的表没有任何限制。

  • 对于 SHARDING 属性为 PARTITION 的表组，表组内每一张表的数据按一级分区打散；如果是二级分区表，则一级分区下的所有二级分区聚集在一起。

    加入要求：要求加入表组的表其对应的一级分区必须与表组中所有表的一级分区的分区定义一致，包括分区类型、分区个数、分区值。

  • 对于 SHARDING 属性为 ADAPTIVE的表组，表组内每一张表的数据根据自适应方式打散。即，如果表组内的表是一级分区表，则按一级分区打散；如果表组内的表是二级分区表，则按每个一级分区下的二级分区打散。

    加入要求：要求加入表组的表其对应的一级分区和二级分区必须与表组中所有表的一级分区和二级分区的分区定义一致，包括分区类型、分区个数、分区值。

通过 SHOW TABLEGROUPS 语句查看表组属性及表所属数据库

系统租户和 MySQL 用户租户还可以通过 SHOW TABLEGROUPS 语句查看表组内表的所属数据库及表组的 SHARDING 属性。

SHOW TABLEGROUPS WHERE tablegroup_name = 'tblgroup1';

查询结果如下：

+-----------------+------------+---------------+----------+
| Tablegroup_name | Table_name | Database_name | Sharding |
+-----------------+------------+---------------+----------+
| tblgroup1       | tbl3       | test          | ADAPTIVE |
+-----------------+------------+---------------+----------+
1 row in set

查询结果中的各字段说明如下：

• Tablegroup_name：表组名。

• Table_name：表组内的表名。

• Database_name：表组内的表所属的数据库。

• Sharding：表组的 SHARDING 属性。

  • 对于 SHARDING 属性为 NONE 的表组，表组内的所有表的所有分区均聚集在同一台机器上，并且对加入表组的表没有任何限制。

  • 对于 SHARDING 属性为 PARTITION 的表组，表组内每一张表的数据按一级分区打散；如果是二级分区表，则一级分区下的所有二级分区聚集在一起。

    加入要求：要求加入表组的表其对应的一级分区必须与表组中所有表的一级分区的分区定义一致，包括分区类型、分区个数、分区值。

  • 对于 SHARDING 属性为 ADAPTIVE的表组，表组内每一张表的数据根据自适应方式打散。即，如果表组内的表是一级分区表，则按一级分区打散；如果表组内的表是二级分区表，则按每个一级分区下的二级分区打散。

    加入要求：要求加入表组的表其对应的一级分区和二级分区必须与表组中所有表的一级分区和二级分区的分区定义一致，包括分区类型、分区个数、分区值。

查看表组中的表

系统租户和 MySQL 用户租户可以分别通过视图 CDB_OB_TABLEGROUP_TABLES 和视图 DBA_OB_TABLEGROUP_TABLES 来查看表组中存在哪些表以及表所属的数据库，语句如下。

• 系统租户

  SELECT * FROM oceanbase.CDB_OB_TABLEGROUP_TABLES WHERE tablegroup_name = 'tblgroup1';
  

  查询结果如下：

  +-----------+-----------------+-------+------------+----------+
  | TENANT_ID | TABLEGROUP_NAME | OWNER | TABLE_NAME | SHARDING |
  +-----------+-----------------+-------+------------+----------+
  |      1002 | tblgroup1       | test  | tbl3       | ADAPTIVE |
  |      1004 | TBLGROUP1       | SYS   | TBL3       | NONE     |
  +-----------+-----------------+-------+------------+----------+
  2 rows in set
  

• MySQL 用户租户

  SELECT * FROM oceanbase.DBA_OB_TABLEGROUP_TABLES WHERE tablegroup_name = 'tblgroup1';
  

  查询结果如下：

  +-----------------+-----------+------------+----------+
  | TABLEGROUP_NAME | OWNER     | TABLE_NAME | SHARDING |
  +-----------------+-----------+------------+----------+
  | tblgroup1       | test      | tbl3       | ADAPTIVE |
  +-----------------+-----------+------------+----------+
  1 row in set
  

查询结果中的各字段说明如下：

• TENANT_ID：表组所属的租户名。

• TABLEGROUP_NAME：表组名。

• OWNER：表组内的表所属的数据库。

• TABLE_NAME：表组内表的名称。

• SHARDING：表组的 SHARDING 属性。

  • 对于 SHARDING 属性为 NONE 的表组，表组内的所有表的所有分区均聚集在同一台机器上，并且对加入表组的表没有任何限制。

  • 对于 SHARDING 属性为 PARTITION 的表组，表组内每一张表的数据按一级分区打散；如果是二级分区表，则一级分区下的所有二级分区聚集在一起。

    加入要求：要求加入表组的表其对应的一级分区必须与表组中所有表的一级分区的分区定义一致，包括分区类型、分区个数、分区值。

  • 对于 SHARDING 属性为 ADAPTIVE的表组，表组内每一张表的数据根据自适应方式打散。即，如果表组内的表是一级分区表，则按一级分区打散；如果表组内的表是二级分区表，则按每个一级分区下的二级分区打散。

    加入要求：要求加入表组的表其对应的一级分区和二级分区必须与表组中所有表的一级分区和二级分区的分区定义一致，包括分区类型、分区个数、分区值。

查看表组的创建时间

系统租户和 MySQL 用户租户可以分别通过视图 CDB_OBJECTS 和视图 DBA_OBJECTS 来查看表组的创建时间、最近一次 DDL 操作等信息。

• 系统租户

  SELECT OBJECT_NAME,CREATED, LAST_DDL_TIME FROM oceanbase.CDB_OBJECTS WHERE object_name = 'tblgroup1';
  

  查询示例如下：

  +-------------+---------------------+---------------------+
  | OBJECT_NAME | CREATED             | LAST_DDL_TIME       |
  +-------------+---------------------+---------------------+
  | tblgroup1   | 2023-06-27 14:58:53 | 2023-06-27 15:15:54 |
  | TBLGROUP1   | 2023-06-27 15:25:30 | 2023-06-27 15:25:30 |
  +-------------+---------------------+---------------------+
  2 rows in set
  

• MySQL 用户租户

  SELECT OBJECT_NAME,CREATED, LAST_DDL_TIME FROM oceanbase.DBA_OBJECTS WHERE object_name = 'tblgroup1'; 
  

  查询示例如下：

  +-------------+---------------------+---------------------+
  | OBJECT_NAME | CREATED             | LAST_DDL_TIME       |
  +-------------+---------------------+---------------------+
  | tblgroup1   | 2023-06-27 14:58:53 | 2023-06-27 15:15:54 |
  +-------------+---------------------+---------------------+
  1 row in set
  

查询结果中的部分字段说明如下：

• OBJECT_NAME：对象名，即当前所查询的表组名。
• CREATED：表组的创建时间。
• LAST_DDL_TIME：最近一次进行 DDL 操作的时间。

查看表组中表的 Location 信息

系统租户和 MySQL 用户租户都可以通过视图 DBA_OB_TABLE_LOCATIONS 查看表组中表的 Location 信息，包括表中各分区（PARTITION_NAME）对应的分片（TABLET_ID）、分片（TABLET_ID）与日志流（LS_ID）的映射关系以及日志流副本的位置信息等。

SELECT * FROM oceanbase.DBA_OB_TABLE_LOCATIONS WHERE tablegroup_name = 'tblgroup1';

查询结果如下：

+---------------+------------+----------+------------+----------------+-------------------+------------+---------------+-----------+-------+-------+----------------+----------+----------+--------------+-----------------+-----------+-----------------+---------------+----------+
| DATABASE_NAME | TABLE_NAME | TABLE_ID | TABLE_TYPE | PARTITION_NAME | SUBPARTITION_NAME | INDEX_NAME | DATA_TABLE_ID | TABLET_ID | LS_ID | ZONE  | SVR_IP         | SVR_PORT | ROLE     | REPLICA_TYPE | DUPLICATE_SCOPE | OBJECT_ID | TABLEGROUP_NAME | TABLEGROUP_ID | SHARDING |
+---------------+------------+----------+------------+----------------+-------------------+------------+---------------+-----------+-------+-------+----------------+----------+----------+--------------+-----------------+-----------+-----------------+---------------+----------+
| test          | tbl3       |   500089 | USER TABLE | p0             | mp0               | NULL       |          NULL |    200055 |  1001 | zone1 | xx.xx.xx.197   |     2882 | LEADER   | FULL         | NONE            |    500092 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p0             | mp0               | NULL       |          NULL |    200055 |  1001 | zone2 | xx.xx.xx.194   |     2882 | FOLLOWER | FULL         | NONE            |    500092 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p0             | mp1               | NULL       |          NULL |    200056 |  1001 | zone1 | xx.xx.xx.197   |     2882 | LEADER   | FULL         | NONE            |    500093 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p0             | mp1               | NULL       |          NULL |    200056 |  1001 | zone2 | xx.xx.xx.194   |     2882 | FOLLOWER | FULL         | NONE            |    500093 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p0             | mp2               | NULL       |          NULL |    200057 |  1001 | zone1 | xx.xx.xx.197   |     2882 | LEADER   | FULL         | NONE            |    500094 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p0             | mp2               | NULL       |          NULL |    200057 |  1001 | zone2 | xx.xx.xx.194   |     2882 | FOLLOWER | FULL         | NONE            |    500094 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p1             | mp3               | NULL       |          NULL |    200058 |  1001 | zone1 | xx.xx.xx.197   |     2882 | LEADER   | FULL         | NONE            |    500095 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p1             | mp3               | NULL       |          NULL |    200058 |  1001 | zone2 | xx.xx.xx.194   |     2882 | FOLLOWER | FULL         | NONE            |    500095 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p1             | mp4               | NULL       |          NULL |    200059 |  1001 | zone1 | xx.xx.xx.197   |     2882 | LEADER   | FULL         | NONE            |    500096 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p1             | mp4               | NULL       |          NULL |    200059 |  1001 | zone2 | xx.xx.xx.194   |     2882 | FOLLOWER | FULL         | NONE            |    500096 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p1             | mp5               | NULL       |          NULL |    200060 |  1001 | zone1 | xx.xx.xx.197   |     2882 | LEADER   | FULL         | NONE            |    500097 | tblgroup1       |        500083 | ADAPTIVE |
| test          | tbl3       |   500089 | USER TABLE | p1             | mp5               | NULL       |          NULL |    200060 |  1001 | zone2 | xx.xx.xx.194   |     2882 | FOLLOWER | FULL         | NONE            |    500097 | tblgroup1       |        500083 | ADAPTIVE |
+---------------+------------+----------+------------+----------------+-------------------+------------+---------------+-----------+-------+-------+----------------+----------+----------+--------------+-----------------+-----------+-----------------+---------------+----------+
12 rows in set

查询结果中的各字段说明如下：

• DATABASE_NAME：表组内表所属的数据库名。

• TABLE_NAME：表组内的表名。

• TABLE_ID：表组内表的 ID。

• TABLE_TYPE：表组内表的类型。

  • USER TABLE：用户表
  • SYSTEM TABLE：系统表，系统自建的表
  • INDEX：索引表
  • LOB AUX TABLE：LOB 辅助表，系统自建的表，用于辅助实现 LOB 列

• PARTITION_NAME：一级分区名，非分区表默认为 NULL。

• SUBPARTITION_NAME：二级分区名，NULL 表示不存在二级分区。

• INDEX_NAME：如果是索引表，展示索引表名，否则展示为 NULL。

• DATA_TABLE_ID：如果是索引表或者 LOB 辅助表，则表示其所属的主表的 ID，否则展示为 NULL。

• TABLET_ID：分区对应的分片 ID。

• LS_ID：表组内表所在的日志流。

• ZONE：副本所在的 Zone。

• SVR_IP：副本所在的 OBServer 节点的 IP 信息。

• SVR_PORT：副本所在的 OBServer 节点的端口号。

• ROLE：日志流副本的角色。

• REPLICA_TYPE：日志流副本类型。

  • FULL：全功能型副本
  • READONLY：只读型副本
  • COLUMNSTORE：列存副本

• OBJECT_ID：如果表组内的表是非分区表，则表示非分区表的 ID；如果表组内的表是分区表，则表示每个分区的 ID。

• TABLEGROUP_NAME：所查询的表组的表组名。

• TABLEGROUP_ID：所查询的表组的表组 ID。

• SHARDING：表组的 SHARDING 属性。

  • 对于 SHARDING 属性为 NONE 的表组，表组内的所有表的所有分区均聚集在同一台机器上，并且对加入表组的表没有任何限制。

  • 对于 SHARDING 属性为 PARTITION 的表组，表组内每一张表的数据按一级分区打散；如果是二级分区表，则一级分区下的所有二级分区聚集在一起。

    加入要求：要求加入表组的表其对应的一级分区必须与表组中所有表的一级分区的分区定义一致，包括分区类型、分区个数、分区值。

  • 对于 SHARDING 属性为 ADAPTIVE的表组，表组内每一张表的数据根据自适应方式打散。即，如果表组内的表是一级分区表，则按一级分区打散；如果表组内的表是二级分区表，则按每个一级分区下的二级分区打散。

    加入要求：要求加入表组的表其对应的一级分区和二级分区必须与表组中所有表的一级分区和二级分区的分区定义一致，包括分区类型、分区个数、分区值。

相关文档

• 关于表组

• 创建表组

• 将表添加到表组

• 修改表组的 SHARDING 属性

• 管理表组内的表

• 删除表组