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%' ...

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

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

USAGE

外部卷

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

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

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

输出

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

列

描述

name

外部卷的名称。

allow_writes

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

comment

注释外部卷。

使用说明

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

  • 该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。

  • MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。

  • To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

    此命令的输出列名称以小写形式生成。如果您通过管道运算符或 RESULT_SCAN 函数使用此命令的结果集，请在查询中对列名使用 加双引号的标识符，以确保它们与已扫描输出中的列名相匹配。例如，如果输出列的名称为 type，则为标识符指定 "type"。

示例

显示所有外部卷：

SHOW EXTERNAL VOLUMES;
Copy

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

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