SHOW TABLES

引入或更新版本：v1.2.415

列出当前或指定数据库中的表。

备注

从版本 1.2.415 开始，SHOW TABLES 命令的结果不再包含视图。要显示视图，请使用 SHOW VIEWS。

另请参阅：system.tables

语法

SHOW [ FULL ] TABLES 
     [ {FROM | IN} <database_name> ] 
     [ HISTORY ] 
     [ LIKE '<pattern>' | WHERE <expr> ]

参数	描述
FULL	列出带有附加信息的结果。详见 示例。
FROM / IN	指定一个数据库。如果省略，则返回当前数据库的结果。
HISTORY	显示在保留期内（默认 24 小时）删除表的时间戳。如果表尚未被删除，drop_time 的值为 NULL。
LIKE	使用区分大小写的模式匹配过滤结果名称。
WHERE	使用 WHERE 子句中的表达式过滤结果。

示例

以下示例列出当前数据库（默认）中所有表的名称：

SHOW TABLES;

┌───────────────────┐
│ Tables_in_default │
├───────────────────┤
│ books             │
│ mytable           │
│ ontime            │
│ products          │
└───────────────────┘

以下示例列出所有表及其附加信息：

SHOW FULL TABLES;

┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│  tables  │ table_type │ database │ catalog │       owner      │ engine │ cluster_by │         create_time        │     num_rows     │     data_size    │ data_compressed_size │    index_size    │
├──────────┼────────────┼──────────┼─────────┼──────────────────┼────────┼────────────┼────────────────────────────┼──────────────────┼──────────────────┼──────────────────────┼──────────────────┤
│ books    │ BASE TABLE │ default  │ default │ account_admin    │ FUSE   │            │ 2024-01-16 03:53:15.354132 │                0 │                0 │                    0 │                0 │
│ mytable  │ BASE TABLE │ default  │ default │ account_admin    │ FUSE   │            │ 2024-01-16 03:53:27.968505 │                0 │                0 │                    0 │                0 │
│ ontime   │ BASE TABLE │ default  │ default │ account_admin    │ FUSE   │            │ 2024-01-16 03:53:42.052399 │                0 │                0 │                    0 │                0 │
│ products │ BASE TABLE │ default  │ default │ account_admin    │ FUSE   │            │ 2024-01-16 03:54:00.883985 │                0 │                0 │                    0 │                0 │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

以下示例展示了当存在可选参数 HISTORY 时，结果将包含已删除的表：

DROP TABLE products;

SHOW TABLES;

┌───────────────────┐
│ Tables_in_default │
├───────────────────┤
│ books             │
│ mytable           │
│ ontime            │
└───────────────────┘

SHOW TABLES HISTORY;

┌────────────────────────────────────────────────┐
│ Tables_in_default │          drop_time         │
├───────────────────┼────────────────────────────┤
│ books             │ NULL                       │
│ mytable           │ NULL                       │
│ ontime            │ NULL                       │
│ products          │ 2024-01-16 03:55:47.900362 │
└────────────────────────────────────────────────┘

以下示例列出名称末尾包含字符串 "time" 的表：

SHOW TABLES LIKE '%time';

┌───────────────────┐
│ Tables_in_default │
├───────────────────┤
│ ontime            │
└───────────────────┘

-- 区分大小写的模式匹配。
-- 如果按以下方式编写上述语句，将不会返回任何结果：
SHOW TABLES LIKE '%TIME';

以下示例列出数据大小大于 1,000 字节的表：

SHOW TABLES WHERE data_size > 1000 ;

┌───────────────────┐
│ Tables_in_default │
├───────────────────┤
│ ontime            │
└───────────────────┘