SHOW

SHOW

更新时间：2026-03-20 12:38:45

描述

该语句用于展示数据库对象的信息。

语法

SHOW {
  | TABLE STATUS
  | [FULL] PROCESSLIST
  | RECYCLEBIN
  | VARIABLES [LIKE 'pattern']
  | PARAMETERS
  | CHARSET | CHARACTER SET
  | COLLATION
  | CREATE TABLEGROUP tablegroup_name
  | CREATE TABLE table_name
  | CREATE VIEW view_name
  | GRANTS
  | PRIVILEGES
  | ERRORS
  | TRACE [FORMAT='JSON']
  | FILES IN LOCATION @location_name['/path'] [PATTERN = 'regex_pattern']
};

参数解释

参数	描述
TABLE STATUS	展示当前用户中所有表的详细信息。
VARIABLES [like 'variable_name']	显示变量信息。如果不指定 `like 'variable_name'`，则显示所有系统变量信息。`variable_name` 为变量名称。
CHARSET \| CHARACTER SET	展示支持的字符集。
COLLATION	展示支持的字符序。
PARAMETERS	展示所有系统配置项。
TABLEGROUPS	展示表组信息。
CREATE TABLEGROUP tablegroup_name	查看创建表组的语句。`tablegroup_name` 为表组名称。
CREATE TABLE table_name	查看创建表的语句。`table_name` 为表名。
CREATE VIEW view_name	查看创建视图的语句。`view_name` 为视图名称。
ERRORS	查看错误信息。
GRANTS	查看当前用户的权限。
PRIVILEGES	查看各项权限的描述。
RECYCLEBIN	查看回收站。
[FULL] PROCESSLIST	查看当前租户进程列表。具体如下： `SHOW PROCESSLIST` 显示简要的进程列表，具体如下： `ID`：进程的 ID，即当前会话的 Client Session ID，该 ID 是会话在客户端中的唯一标识。 `USER`：连接的用户名。 `HOST`：客户端 IP 和端口（通过 ODP 连接则为 ODP 的 IP 和端口）。 `DB`：访问的 Database 名称。 `COMMAND`：当前执行的命令类型，取值 `Query`、`Sleep` 等。 `TIME`：当前命令执行时间，单位是秒。如果命令发生重试，会清零后重新计算。 `STATE`：当前会话状态，取值 `SLEEP`、`ACTIVE` 等。 `INFO`：展示当前正在执行的命令，长度限制为 100 个字符，超出部分截断。 `SHOW FULL PROCESSLIST`：显示完整的进程列表，包括每个进程的详细信息，具体如下： `ID`：进程的 ID，即当前会话的 Client Session ID，该 ID 是会话在客户端中的唯一标识。 `USER`：连接的用户名。 `TENANT`：连接的租户。 `HOST`：客户端 IP 和端口（通过 ODP 连接则为 ODP 的 IP 和端口）。 `DB`：访问的 Database 名称。 `COMMAND`：当前执行的命令类型，取值 `Query`、`Sleep` 等。 `TIME`：当前命令执行时间，单位是秒。如果命令发生重试，会清零后重新计算。 `STATE`：当前会话状态，取值 `SLEEP`、`ACTIVE` 等。 `INFO`：展示当前正在执行的命令。 `IP`：服务器 IP 地址。 `PORT`：SQL 端口号。说明通过 `SHOW PROCESSLIST` 语句查询当前数据库中会话的数量和会话的 ID 的详细信息，请参见查看租户会话。
TRACE [FORMAT='JSON']	展示 SQL 语句的执行情况。可以选择以 JSON 的格式输出。
FILES IN LOCATION @location_name['/path'] [PATTERN = 'regex_pattern']	用于查看 Location 下存在的文件。 `['/path']` 为可选项，表示子目录。 `PATTERN = 'regex_pattern'` 为可选项，用于指定一个正则表达式，用于筛选要 Location 目录下的文件。说明执行 `SHOW FILES IN LOCATION` 语句，需要当前用户拥有 Location 对象的 `READ 权限。` `对于 OceanBase 数据库 V4.4.x 版本，从 V4.4.1 版本开始支持该语法。`

示例

查看表 tbl1 的创建信息。

  obclient> CREATE TABLE employees (
    emp_id INT PRIMARY KEY,
    emp_name VARCHAR(50) NOT NULL,
    hire_date DATE,
    salary NUMBER(10,2),
    department VARCHAR(30)
  );
  obclient> SHOW CREATE TABLE employees;

查看回收站是否开启。

obclient> SHOW VARIABLES LIKE 'recyclebin';

查看回收站中的内容。
```
obclient> SHOW RECYCLEBIN;
```

使用 SHOW TRACE 查看某一 SQL 的执行信息，并以 JSON 的格式输出。

obclient> SET ob_enable_show_trace = 1;

obclient> CREATE TABLE space_travelers (
    astronaut_id INT PRIMARY KEY,
    mission_code VARCHAR(50) NOT NULL,
    launch_date DATE,
    flight_hours NUMBER(10,2),
    space_station VARCHAR(30)
);

obclient> INSERT INTO space_travelers VALUES(1, 'APOLLO-11', TO_DATE('1969-07-16', 'YYYY-MM-DD'), 195.5, 'MOON');

obclient> INSERT INTO space_travelers VALUES(2, 'ISS-EXP-1', TO_DATE('2000-11-02', 'YYYY-MM-DD'), 4320.8, 'ISS');

obclient> SELECT/*+PARALLEL(2)*/ COUNT(*) FROM space_travelers;

obclient> SHOW TRACE FORMAT='JSON'\G

描述

语法

参数解释

说明

说明

示例