SHOW EXTERNAL TABLES

列出您具有访问权限的外部表。该命令可用于列出当前/指定数据库或架构的外部表，或整个账户的外部表。

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

另请参阅：

CREATE EXTERNAL TABLE、DROP EXTERNAL TABLE、ALTER EXTERNAL TABLE、DESCRIBE EXTERNAL TABLE

语法

SHOW [ TERSE ] EXTERNAL TABLES [ LIKE '<pattern>' ]
                               [ IN
                                        {
                                          ACCOUNT                  |

                                          DATABASE                 |
                                          DATABASE <database_name> |

                                          SCHEMA                   |
                                          SCHEMA <schema_name>     |
                                          <schema_name>
                                        }
                               ]
                               [ STARTS WITH '<name_string>' ]
                               [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

参数

TERSE

仅返回输出列的子集：

  • created_on

  • name

  • kind

  • database_name

  • schema_name

LIKE 'pattern'

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

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

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

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

[ IN ... ]

（可选）指定命令的作用域。指定以下任一项：

ACCOUNT

返回整个账户的记录。

DATABASE、. DATABASE db_name

返回当前正在使用的数据库或指定数据库 (db_name) 的记录。

如果指定 DATABASE 而不指定 db_name，并且没有使用任何数据库，则关键字对输出没有影响。

SCHEMA、. SCHEMA schema_name、. schema_name

返回当前正在使用的架构或指定架构 (schema_name) 的记录。

如果数据库正在使用中，或者指定了完全限定 schema_name`（例如 ``db.schema`），则 SCHEMA 是可选选项。

如果未使用任何数据库，则指定 SCHEMA 对输出没有影响。

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

  • 数据库：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 函数，该函数会将输出视为可查询的表。

输出

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

列

描述

created_on

创建外部表的日期和时间。

name

外部表的名称。

database_name

外部表的架构的数据库。

schema_name

外部表的架构。

invalid

如果删除了外部表描述中引用的暂存区或文件格式，则为 TRUE。

invalid_reason

当 INVALID 列显示 TRUE 值时，外部表无效的原因。

owner

拥有外部表的角色。

comment

对外部表进行注释。

stage

外部表定义中引用的暂存区的完全限定名称。

location

外部表定义中的外部暂存区和文件夹路径。对于数据使用者账户中导入的共享的外部表，为 NULL。

file_format_name

外部表定义中的命名文件格式。不显示暂存区定义中指定的文件格式。

file_format_type

在外部表定义中指定的文件格式类型。不显示暂存区定义中指定的文件格式类型。

cloud

暂存数据文件所在的云。

region

暂存数据文件所在的区域。

notification_channel

外部表的 Amazon SQS 队列的 Amazon Resource Name。

last_refreshed_on

时间戳，指示外部表的元数据上次手动或自动与外部暂存区和路径中的最新关联文件集同步的时间。

table_format

外部表引用的暂存文件的表格式。可能的值：DELTA、UNSPECIFIED。

last_refresh_details

支持未来的功能；目前仅为 NULL。

owner_role_type

拥有对象的角色类型是 ROLE 或 DATABASE_ROLE。. 如果 Snowflake Native App 拥有该对象，则其值为 APPLICATION。. 如果您删除该对象，则 Snowflake 会返回 NULL，原因是删除的对象不具有所有者角色。

有关可为外部表指定的属性的更多信息，请参阅 CREATE EXTERNAL TABLE。

示例

显示所有名称以您有权在 tpch.public 架构中查看的 line 开头的外部表：

SHOW EXTERNAL TABLES LIKE 'line%' IN tpch.public;
Copy
语言: 中文