SHOW HYBRID TABLES¶

列出您具有访问权限的混合表。

该命令可用于列出当前/指定数据库或架构的混合表，或整个账户的混合表。

此命令返回与 SHOW TABLES 不同的输出列。

输出返回混合表元数据和属性，按数据库、架构和混合表名称按字典顺序排序（有关输出列的说明，请参阅本主题中的输出）。如果您希望使用提供的筛选器筛选结果，请务必注意这一点。

请注意，本主题将混合表简称为“表”，除非指定 混合表 以避免混淆。

另请参阅：: CREATE INDEX、DROP INDEX、SHOW INDEXES、CREATE HYBRID TABLE、DROP TABLE、DESCRIBE TABLE

语法¶

SHOW [ TERSE ] [ HYBRID ] TABLES [ LIKE '<pattern>' ]
                                 [ IN { ACCOUNT | DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]
                                 [ STARTS WITH '<name_string>' ]
                                 [ LIMIT <rows> [ FROM '<name_string>' ] ]

Copy

参数¶

TERSE

（可选）仅返回输出列的子集：

created_on
name
kind

kind 列值始终为 HYBRID TABLE。
database_name
schema_name

默认：无值（所有列都包含在输出中）

HYBRID

仅返回混合表。

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用不区分大小写的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回相同的结果：

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

IN ACCOUNT | DATABASE [ db_name ] | SCHEMA [ schema_name ]

（可选）指定命令范围，该范围决定该命令是仅列出当前/指定数据库或架构的记录，还是列出整个账户的记录。

如果您指定关键字 ACCOUNT，则该命令将检索当前账户的所有数据库中所有架构的记录。

如果您指定关键字 DATABASE，那么：

如果指定 db_name，则该命令将检索指定数据库的所有架构的记录。
如果您未指定 db_name，那么：
- 如果存在当前数据库，则该命令将检索当前数据库中所有架构的记录。
- 如果当前没有数据库，则该命令将检索账户中所有数据库和架构的记录。

如果您指定关键字 SCHEMA，那么：

如果指定限定架构名称（例如，my_database.my_schema），则该命令将检索指定数据库和架构的记录。
如果您指定了未限定的 schema_name，那么：
- 如果存在当前数据库，则该命令将检索当前数据库中指定架构的记录。
- 如果当前没有数据库，则该命令会显示错误 SQL compilation error: Object does not exist, or operation cannot be performed。
如果您未指定 schema_name，那么：
- 如果当前有数据库，那么：
  - 如果当前存在架构，则该命令将检索当前数据库中当前架构的记录。
  - 如果不存在当前架构，则该命令将检索当前数据库中所有架构的记录。
- 如果当前没有数据库，则该命令将检索账户中所有数据库和所有架构的记录。

默认：取决于会话当前是否正在使用数据库：

数据库：DATABASE 是默认值。该命令返回您有权在当前数据库中查看的对象。
无数据库：ACCOUNT 为默认值。该命令返回您有权在账户中查看的对象。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且区分大小写。

例如，以下字符串会返回不同的结果：

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows [ FROM 'name_string' ]

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

可选的 FROM 'name_string' 分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数：

该字符串必须放在单引号内并且区分大小写。
该字符串不必包含完整的对象名称；支持部分名称。

默认：无值（不对输出应用限制）

备注

对于支持 FROM 'name_string' 和 STARTS WITH 'name_string' 的 SHOW 子句，您可以将这两个子句组合在同一语句中。但是，两个条件都必须满足，否则它们相互抵消，不返回任何结果。

此外，对象按名称的字典顺序返回，因此 FROM 'name_string' 仅返回字典值高于 STARTS WITH 'name_string' 所返回行的行。

例如：

... STARTS WITH 'A' LIMIT ... FROM 'B' 不会返回任何结果。
... STARTS WITH 'B' LIMIT ... FROM 'A' 不会返回任何结果。
... STARTS WITH 'A' LIMIT ... FROM 'AB' 将返回结果（如果有任何行与输入字符串匹配）。

使用说明¶

如果一个账户（或数据库或架构）有大量混合表，则搜索整个账户（或数据库或架构）可能会消耗大量的计算资源。

该命令不需要正在运行的仓库即可执行。
LIMIT rows 的值不能超过 10000。如果省略 LIMIT rows，若结果集大于 1 万行，则该命令将导致错误。

要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中包含 LIMIT rows 或查询相应的视图。

若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

输出¶

备注

以下输出架构适用于 SHOW HYBRID TABLES 命令。有关 SHOW TABLES 的输出的信息，请参阅使用 SHOW TABLES 识别混合表（本主题内容）。

命令输出在以下列中提供表属性和元数据：

列	描述
`created_on`	创建表的日期和时间。
`name`	表的名称。
`database_name`	存储表的数据库。
`schema_name`	存储表的架构。
`owner`	拥有表的角色。
`rows`	表中的行数。
`bytes`	在查询中扫描整个表时将要扫描的字节数。请注意，此数字可能与表的实际物理字节数（即存储在磁盘上的字节数）不同。
`comment`	为表添加注释。
`owner_role_type`	拥有对象的角色类型是 `ROLE` 或 `DATABASE_ROLE`。. 如果 Snowflake Native App 拥有该对象，则该值为 `APPLICATION`。. 如果您删除该对象，则 Snowflake 会返回 NULL，原因是删除的对象不具有所有者角色。

备注

如果数据不断变化，则 rows 和 bytes 列中的数字可能不准确。例如，如果不断向混合表中插入新数据，则可能会发生此类变更。

示例¶

显示名称以 product_ 开头并且您有权在 mydb.myschema 架构中查看的所有混合表：

SHOW HYBRID TABLES LIKE 'product_%' IN mydb.myschema;

Copy

使用 SHOW TABLES 识别混合表¶

SHOW TABLES 命令输出具有一列，可用于识别表是否为混合表。

除了常规 SHOW TABLES 输出列之外，还会显示此列。

该列具有以下名称和可能的值：

列名称	值
is_hybrid	如果该表是混合表，则为 `Y`；否则为 `N`。