SHOW TABLES

引入或更新版本：v1.2.290

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

语法

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

参数	描述
FULL	列出结果时附加更多信息。更多详情见示例。
FROM / IN	指定数据库。如果省略，命令将返回当前数据库中的结果。
HISTORY	如果存在，结果将包括仍在其保留期内（默认为24小时）的已删除表。
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            │
└───────────────────┘