SHOW SERVICE VOLUMES IN SERVICE¶

列出服务的所有实例的存储卷。对于每个已挂载的卷，输出包含该卷被每个容器挂载时对应的一行。输出仅显示挂载到服务中至少一个容器的卷；已指定但未被任何容器使用的卷不包含在内。

另请参阅：: Snowpark Container Services 概述、CREATE SERVICE、SHOW SERVICES、SHOW SERVICE INSTANCES IN SERVICE、SHOW SERVICE CONTAINERS IN SERVICE、SHOW <objects>

语法¶

SHOW SERVICE VOLUMES IN SERVICE <name>

Copy

参数¶

name

指定要显示已挂载卷列表的服务名称。

不支持带引号的特殊字符名称或区分大小写的名称。

输出¶

该命令输出以以下列形式提供服务卷的属性：

列	描述
`volume_name`	卷的名称
`instance_id`	服务实例的 ID，这是从 0 开始的服务实例索引。
`container_name`	挂载卷所在的容器名称。
`volume_type`	卷的类型。这可以是以下类型之一： `block` `stage` `local` `memory` 有关卷类型的详细说明，请参阅服务规范。
`size`	卷的大小，格式为 `numberGi`。
`iops`	仅适用于块卷。显示每个块卷配置的每秒输入/输出操作数。
`throughput`	仅适用于块卷。显示每个块卷配置的吞吐量。
`encryption`	仅适用于暂存区和块卷。对于块卷，它显示已配置的卷加密类型。有关块卷加密类型的详细描述，请参阅块存储卷的加密支持。对于暂存区卷，它显示基础暂存区的加密类型。调用方需要具有暂存区 USAGE 或 OWNERSHIP 权限才能获取暂存区加密信息。
`snapshot_used`	仅适用于块卷。显示用于创建卷的快照。仅当您使用的角色已被授予快照的 USAGE 或 OWNERSHIP 权限时，此列才会列出快照。
`stage_source`	仅适用于暂存区卷。显示用于暂存区卷的暂存区的完全限定名称。
`volume_mounts`	以逗号分隔的路径列表，其中卷挂载在指定容器中。

如果字段适用于特定卷类型，对于所有其他卷类型而言，该字段将填充为 NULL。

访问控制要求¶

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

权限	对象	备注
OWNERSHIP 或 MONITOR	服务	无
OWNERSHIP 或 USAGE	快照	在无法访问块存储快照的情况下，Snowflake 会在 `snapshot_used` 字段中填充授权错误，但命令不会失败。
以下任何一项权限：OWNERSHIP 或 USAGE	暂存区	如果无法访问暂存区，我们将使用暂存区卷的授权错误填充加密字段，但该命令不会失败。

对架构中的对象进行操作至少需要父数据库的一项权限和父架构的一项权限。

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

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

使用说明¶

该命令不需要正在运行的仓库即可执行。
该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。
MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。

要对该命令的输出进行后处理，可以使用管道运算符 (->>) 或 RESULT_SCAN 函数。这两种构造都将输出视为可以查询的结果集。

例如，您可使用管道操作符或 RESULT_SCAN 函数，从 SHOW 命令输出中选择特定列或筛选行数据。

引用输出列时，为列名使用双引号标识符。例如，选择输出列 type，指定 SELECT "type"。

必须使用双引号标识符，因为 SHOW 命令的输出列名均为小写格式。双引号确保 SELECT 列表或 WHERE 子句中的列名，与已扫描的 SHOW 命令输出中的列名完全匹配。

该命令最多返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定。即使应用了筛选器，也不会返回任何超出 1 万条限制后的记录。

要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。

示例¶

以下示例列出了 echo_service 服务的卷：

SHOW SERVICE VOLUMES IN SERVICE echo_service;

Copy

示例输出：

+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| volume_name    | instance_id | container_name | volume_type |  size  |  iops  | throughput |   encryption   | snapshot_used | stage_source |       volume_mounts       |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| block-volume-1 | 0           | main           | block       | 1Gi    | 3000   | 125        | SNOWFLAKE_SSE  | [NULL]        | [NULL]       | /tmp/block1               |
| block-volume-1 | 0           | secondary      | block       | 1Gi    | 3000   | 125        | SNOWFLAKE_SSE  | [NULL]        | [NULL]       | /data/shared              |
| block-volume-2 | 0           | main           | block       | 50Gi   | 3500   | 150        | SNOWFLAKE_FULL | [NULL]        | [NULL]       | /tmp/block2               |
| local-volume   | 0           | main           | local       | [NULL] | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /tmp/local                |
| memory-volume  | 0           | main           | memory      | 512Mi  | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /tmp/memory, /tmp/memory2 |
| memory-volume  | 0           | secondary      | memory      | 512Mi  | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /cache/memory             |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+