查看表 - OceanBase 数据库 V4.3.5

查看表

更新时间：2026-04-07 20:57:20

表创建成功后，您可以通过 SQL 语句和视图查看数据库中的所有表，以及指定表的定义和表结构等。

查看数据库中的表

表创建成功后，可以使用 SHOW TABLES 语句查看数据库的所有表。语句如下：

SHOW [EXTENDED] [FULL] TABLES [{FROM | IN} database_name];

语句中：

EXTENDED：展示隐藏的表。由于 OceanBase 数据库当前版本不会产生隐藏表，该参数无实际作用。
FULL：展示表类型。
database_name：待查询的数据库。

查看数据库 test 中所有表的示例如下：

SHOW TABLES FROM test;

查询结果如下：

+----------------+
| Tables_in_test |
+----------------+
| t1             |
+----------------+
1 row in set

更多 SHOW TABLES 语句的介绍，请参见 SHOW。

查看表的定义

表创建成功后，您可以使用 SHOW CREATE TABLE 语句查看表的定义。

示例如下：

查看表 tbl1 的定义。

SHOW CREATE TABLE tbl1;

查询结果如下：

+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table | Create Table                                                                                                                                                                                                                                                                                                                                                             |
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tbl1  | CREATE TABLE `tbl1` (
  `col1` int(11) NOT NULL,
  `col2` int(11) NOT NULL,
  `col3` int(11) DEFAULT NULL,
  PRIMARY KEY (`col1`)
) ORGANIZATION INDEX DEFAULT CHARSET = utf8mb4 ROW_FORMAT = DYNAMIC COMPRESSION = 'zstd_1.3.8' REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE ENABLE_MACRO_BLOCK_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 0 |
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set

部分字段说明如下：

ORGANIZATION INDEX：表示表组织模式为 INDEX。
DEFAULT CHARSET = utf8mb4：指定默认字符集为 utf8mb4。
ROW_FORMAT = DYNAMIC：表示打开数据编码。
COMPRESSION：表的压缩方式。
PCTFREE：表示留给更新该块数据的使用空间。

查看表结构

表创建成功后，您可以使用 SHOW COLUMNS/FIELDS 语句查看表结构。语句如下：

SHOW [EXTENDED] [FULL] {COLUMNS | FIELDS}
    {FROM | IN} table_name
    [{FROM | IN} database_name];

语句中：

EXTENDED：展示隐藏的列。
FULL：展示列的字符序、权限与注释。
table_name：待查询的表。
database_name：待查询的表所属的数据库。

示例如下：

查看表 test 的表结构。

obclient [test]> SHOW COLUMNS FROM test;

查询结果如下：

+-------+----------+------+-----+---------+-------+
| Field | Type     | Null | Key | Default | Extra |
+-------+----------+------+-----+---------+-------+
| id    | int(11)  | YES  |     | NULL    |       |
| name  | char(50) | YES  |     | NULL    |       |
+-------+----------+------+-----+---------+-------+
2 rows in set

查看表 test 中包括隐藏的列在内的所有列。

obclient [test]> SHOW EXTENDED COLUMNS FROM test;

查询结果如下：

+----------------+-----------------+------+-----+---------+-------+
| Field          | Type            | Null | Key | Default | Extra |
+----------------+-----------------+------+-----+---------+-------+
| id             | int(11)         | YES  |     | NULL    |       |
| name           | char(50)        | YES  |     | NULL    |       |
| __pk_increment | bigint unsigned | NO   | PRI | NULL    |       |
+----------------+-----------------+------+-----+---------+-------+
3 rows in set

更多 SHOW COLUMNS/FIELDS 语句的介绍，请参见 SHOW。

使用视图查看表信息

可以通过系统视图来查看表的相关信息：

视图名	功能描述
information_schema.TABLES	展示表的信息。
oceanbase.CDB_TABLES	展示所有租户下表的信息。

说明

对于 OceanBase 数据库 V4.3.5 版本，视图 information_schema.TABLES 和 oceanbase.CDB_TABLES 从 V4.3.5 BP1 版本开始支持查看表组织模式。

示例如下：

SELECT * FROM information_schema.tables WHERE table_name = 'ora_tbl1'\G

返回结果如下：

*************************** 1. row ***************************
         TABLE_CATALOG: def
          TABLE_SCHEMA: test
            TABLE_NAME: ora_tbl1
            TABLE_TYPE: BASE TABLE
                ENGINE: InnoDB
               VERSION: NULL
            ROW_FORMAT: DYNAMIC
            TABLE_ROWS: 0
        AVG_ROW_LENGTH: 0
           DATA_LENGTH: 0
       MAX_DATA_LENGTH: NULL
          INDEX_LENGTH: 0
             DATA_FREE: NULL
        AUTO_INCREMENT: NULL
           CREATE_TIME: 2025-02-24 15:17:13
           UPDATE_TIME: 2025-02-24 15:17:13
            CHECK_TIME: NULL
       TABLE_COLLATION: utf8mb4_general_ci
              CHECKSUM: NULL
        CREATE_OPTIONS: NULL
         TABLE_COMMENT:
            AUTO_SPLIT: FALSE
AUTO_SPLIT_TABLET_SIZE: 0
          ORGANIZATION: HEAP
1 row in set