跳转到主要内容
SHOW CREATE (TABLE|DATABASE|USER) 默认会隐藏敏感信息,除非启用以下设置:此外,用户还必须具有 displaySecretsInShowAndSelect 权限。

SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE

这些语句会返回一个 String 类型的单列, 其中包含用于创建指定对象的 CREATE 查询。

语法

Syntax
如果你使用此语句获取系统表的 CREATE 查询, 得到的将是一个查询,它只声明表结构, 但不能用于创建表。

SHOW DATABASES

该语句会显示所有数据库的列表。

语法

Syntax
它与以下查询完全一致:

示例

在此示例中,我们使用 SHOW 获取名称中包含 ‘de’ 字符序列的数据库名称:
Query
Response
我们也可以在不区分大小写的情况下这样做:
Query
Response
或者,获取名称中不包含 ‘de’ 的数据库名:
Query
Response
最后,我们可以只获取前两个数据库的名称:
Query
Response

另请参见

SHOW TABLES

SHOW TABLES 语句用于显示表的列表。

语法

Syntax
如果未指定 FROM 子句,查询将返回当前数据库中的表列表。 该语句与以下查询相同:

示例

在此示例中,我们使用 SHOW TABLES 语句查找名称中包含 ‘user’ 的所有表:
Query
Response
我们也可以用不区分大小写的方式来实现:
Query
Response
或者,查找名称中不包含字母 ‘s’ 的表:
Query
Response
最后,我们只获取前两个表的名称:
Query
Response

另请参阅

SHOW COLUMNS

SHOW COLUMNS 语句显示列列表。

语法

Syntax
数据库名和表名可以用缩写形式 <db>.<table> 指定, 也就是说,FROM tab FROM dbFROM db.tab 等价。 如果未指定数据库,则查询会返回当前数据库中的列列表。 另有两个可选关键字:EXTENDEDFULLEXTENDED 关键字当前不起作用, 其存在是为了兼容 MySQL。FULL 关键字会使输出包含 排序规则、comment 和 privilege 列。 SHOW COLUMNS 语句会生成一个具有以下结构的结果表:

示例

在本示例中,我们将使用 SHOW COLUMNS 语句来获取表 ‘orders’ 中所有以 ‘delivery_’ 开头的列的信息:
Query
Response

另请参阅

SHOW DICTIONARIES

SHOW DICTIONARIES 语句用于显示字典列表。

语法

Syntax
如果未指定 FROM 子句,该查询将返回当前数据库中的字典列表。 也可以通过以下方式获得与 SHOW DICTIONARIES 查询相同的结果:

示例

以下查询从 system 数据库的表列表中选取名称包含 reg 的前两行。
Query
Response

SHOW INDEX

显示表的主键和数据跳过索引列表。 此语句主要是为兼容 MySQL 而存在。系统表 system.tables (用于 主键) 和 system.data_skipping_indices (用于数据跳过索引) 提供了等效的信息,但采用了更符合 ClickHouse 原生风格的方式。

语法

Syntax
数据库名和表名可以使用缩写形式 <db>.<table> 指定,即 FROM tab FROM dbFROM db.tab 等价。如果未指定数据库,则查询默认使用当前数据库。 可选关键字 EXTENDED 当前没有任何作用,仅用于兼容 MySQL。 该语句会生成一个具有以下结构的结果表:

示例

在本示例中,我们使用 SHOW INDEX 语句获取表 ‘tbl’ 中所有索引的信息
Query
Response

另请参阅

SHOW PROCESSLIST

输出 system.processes 表的内容,其中包含当前正在处理的查询列表,但不包括 SHOW PROCESSLIST 查询。

语法

Syntax
SELECT * FROM system.processes 查询会返回当前所有查询的信息。
在终端中执行:

SHOW GRANTS

SHOW GRANTS 语句用于显示用户的权限。

语法

Syntax
如果未指定用户,则该查询会返回当前用户的权限。 WITH IMPLICIT 修饰符可显示隐式授权 (例如 GRANT SELECT ON system.one) FINAL 修饰符会合并该用户及其获授角色的所有授权 (包括继承的授权)

SHOW CREATE USER

SHOW CREATE USER 语句用于显示创建用户时所使用的参数。

语法

Syntax

SHOW CREATE ROLE

SHOW CREATE ROLE 语句用于显示创建角色时所使用的参数。

语法

Syntax

SHOW CREATE ROW POLICY

SHOW CREATE ROW POLICY 语句会显示创建 ROW POLICY时所使用的参数。

语法

Syntax

SHOW CREATE QUOTA

SHOW CREATE QUOTA 语句会显示在创建 QUOTA时使用的参数。

语法

Syntax

SHOW CREATE SETTINGS PROFILE

SHOW CREATE SETTINGS PROFILE 语句用于显示创建 settings profile时所使用的参数。

语法

Syntax

SHOW USERS

SHOW USERS 语句会返回用户账户名称列表。 要查看用户账户的参数,请参见系统表 system.users

语法

Syntax

SHOW ROLES

SHOW ROLES 语句返回角色列表。 如需查看其他信息, 请参见系统表 system.rolessystem.role_grants

语法

Syntax

SHOW PROFILES

SHOW PROFILES 语句返回 profile 列表。 要查看用户账户参数,请参见系统表 settings_profiles

语法

Syntax

SHOW POLICIES

SHOW POLICIES 语句返回指定表的行策略列表。 要查看用户账户参数,请参见系统表 system.row_policies

语法

Syntax

SHOW QUOTAS

SHOW QUOTAS 语句返回QUOTA列表。 要查看QUOTA参数,请参见系统表 system.quotas

语法

Syntax

SHOW QUOTA

SHOW QUOTA 语句返回所有用户或当前用户的 QUOTA 使用情况。 如需查看其他参数,请参见系统表 system.quotas_usagesystem.quota_usage

语法

Syntax

SHOW ACCESS

SHOW ACCESS 语句会显示所有用户角色profile等,以及它们拥有的所有授权

语法

Syntax

SHOW CLUSTER(S)

SHOW CLUSTER(S) 语句会返回集群列表。 所有可用集群都列在 system.clusters 表中。
SHOW CLUSTER name 查询会显示指定集群在 system.clusters 表中的 clustershard_numreplica_numhost_namehost_addressport

语法

Syntax

示例

Query
Response
Query
Response
Query
Response

SHOW SETTINGS

SHOW SETTINGS 语句返回系统设置及其值的列表。 它从 system.settings 表中读取数据。

语法

Syntax

子句

LIKE|ILIKE 允许为设置名称指定匹配模式。该模式可包含 %_ 等通配符。LIKE 子句区分大小写,ILIKE 子句不区分大小写。 使用 CHANGED 子句时,查询仅返回与默认值相比已更改的设置。

示例

使用 LIKE 子句的查询:
Query
Response
使用 ILIKE 子句查询:
Query
Response
使用 CHANGED 子句查询:
Query
Response

SHOW SETTING

SHOW SETTING 语句会输出指定设置名称对应的设置值。

语法

Syntax

另请参见

SHOW FILESYSTEM CACHES

示例

Query
Response

另请参见

SHOW ENGINES

SHOW ENGINES 语句会输出 system.table_engines 表的内容, 其中包含 server 支持的表引擎说明以及其功能支持信息。

语法

Syntax

另请参阅

SHOW FUNCTIONS

SHOW FUNCTIONS 语句会返回 system.functions 表的内容。

语法

Syntax
如果指定了 LIKEILIKE 子句,查询将返回名称与给定 <pattern> 匹配的系统函数列表。

另请参阅

SHOW MERGES

SHOW MERGES 语句返回合并列表。 所有合并都列在 system.merges 表中:

语法

Syntax

示例

Query
Response
Query
Response

SHOW CREATE MASKING POLICY

SHOW CREATE MASKING POLICY 语句用于显示在创建数据脱敏策略时所使用的参数。

语法

Syntax
最后修改于 2026年7月2日