SHOW TABLES - Amazon Redshift
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

从 2025 年 11 月 1 日起,Amazon Redshift 将不再支持创建新的 Python UDF。如果您想要使用 Python UDF,请在该日期之前创建 UDF。现有的 Python UDF 将继续正常运行。有关更多信息,请参阅博客文章

SHOW TABLES

显示架构中表的列表以及一些表属性。

每个输出行由数据库名称、架构名称、表名、表类型、表 ACL、备注、表所有者、上次更改时间、上次修改时间、dist_style 和表子类型组成。有关这些属性的更多信息,请参阅 SVV_ALL_TABLES

修改时间戳和更改时间戳可能会比表更新滞后约 20 分钟。

如果由 SHOW TABLES 命令生成的表超过 10000 个,则会返回错误。

所需的权限

要查看 Amazon Redshift 架构中的表,当前用户必须满足以下条件之一:

  • 是超级用户。

  • 是该表的拥有者。

  • 获得对父架构的 USAGE 权限,并获得对表的 SELECT 权限或对该表中任何列的 SELECT 权限。

语法

SHOW TABLES FROM SCHEMA database_name.schema_name [LIKE 'filter_pattern'] [LIMIT row_limit ]

参数

database_name

包含要列出的表的数据库的名称。

要显示 Amazon Glue Data Catalog 中的表,请指定(awsdatacatalog)作为数据库名称,并确保系统配置 data_catalog_auto_mount 设置为 true。有关更多信息,请参阅 ALTER SYSTEM

schema_name

包含要列出的表的架构的名称。

要显示 Amazon Glue Data Catalog 表,请提供 Amazon Glue 数据库名称作为架构名称。

filter_pattern

一个有效的 UTF-8 字符表达式,具有与表名称匹配的模式。LIKE 选项执行区分大小写的匹配,支持以下模式匹配元字符:

元字符 说明
% 匹配任意序列的零个或多个字符。
_ 匹配任何单个字符。

如果 filter_pattern 不包含元字符,则模式仅表示字符串本身;在此情况下,LIKE 的行为与等于运算符相同。

row_limit

要返回的最大行数。row_limit 可以是 0–10000。

示例

SHOW TABLES FROM SCHEMA s1; database_name | schema_name | table_name | table_type | table_acl | remarks | owner | last_altered_time | last_modified_time | dist_style | table_subtype ---------------+-------------+-------------------+------------+-------------------------------------+---------+-------+----------------------------+----------------------------+------------+------------------- dev | s1 | late_binding_view | VIEW | alice=arwdRxtDPA/alice~bob=d/alice | | alice | | | | LATE BINDING VIEW dev | s1 | manual_mv | VIEW | alice=arwdRxtDPA/alice~bob=P/alice | | alice | | | | MATERIALIZED VIEW dev | s1 | regular_view | VIEW | alice=arwdRxtDPA/alice~bob=r/alice | | alice | | | | REGULAR VIEW dev | s1 | test_table | TABLE | alice=arwdRxtDPA/alice~bob=rw/alice | | alice | 2025-11-18 15:52:00.010452 | 2025-11-18 15:44:34.856073 | AUTO (ALL) | REGULAR TABLE
SHOW TABLES FROM SCHEMA dev.s1 LIKE '%view' LIMIT 1; database_name | schema_name | table_name | table_type | table_acl | remarks | owner | last_altered_time | last_modified_time | dist_style | table_subtype ---------------+-------------+-------------------+------------+--------------------------------------+---------+-------+-------------------+--------------------+------------+------------------- dev | s1 | late_binding_view | VIEW | {alice=arwdRxtDPA/alice,bob=d/alice} | | alice | | | | LATE BINDING VIEW