SHOW EXTERNAL VOLUMES

列出您账户中您拥有访问权限的 外部卷。

输出返回外部卷元数据和属性。

另请参阅：

CREATE EXTERNAL VOLUME、DROP EXTERNAL VOLUME、ALTER EXTERNAL VOLUME、DESCRIBE EXTERNAL VOLUME

语法

SHOW EXTERNAL VOLUMES [ LIKE '<pattern>' ]
Copy

参数

LIKE 'pattern'

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

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

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

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

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

USAGE

外部卷

若要在 SHOW EXTERNAL VOLUMES 的输出中查看特定的外部卷，角色必须对该外部卷具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 该命令不需要正在运行的仓库即可执行。

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

输出

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

列

描述

name

外部卷的名称。

allow_writes

表示 Snowflake 是否可以将文件写入存储位置。

comment

注释外部卷。

示例

显示所有外部卷：

SHOW EXTERNAL VOLUMES;
Copy

显示您有权查看且其名称以 aws 开头的所有外部卷：

SHOW EXTERNAL VOLUMES LIKE 'aws%';
Copy
语言: 中文