SHOW VOLUMES

语法结构

SHOW VOLUMES [IN schema_name] [LIKE 'pattern' | WHERE expr] [LIMIT num]

```
LIKE pattern
```
LIKE pattern
：可选参数，用于按 volume 名称进行模式匹配过滤。支持不区分大小写的匹配，可使用 SQL 通配符
```
%
```
%
（匹配任意数量字符）和
```
_
```
_
（匹配单个字符）。示例：
```
LIKE '%testing%'
```
LIKE '%testing%'
。注意：不支持与
```
WHERE
```
WHERE
条件同时使用。
```
IN schema_name
```
IN schema_name
：可选参数，用于指定特定的 schema 名称，列举该 schema 下的所有 volume。
```
WHERE expr
```
WHERE expr
：可选参数，用于根据
```
SHOW VOLUMES
```
SHOW VOLUMES
命令显示的字段进行筛选，支持使用表达式对结果进行精确过滤。

SHOW VOLUMES;

SHOW VOLUMES WHERE volume_name = 'zettapark_csv';

SHOW VOLUMES WHERE external = true;

SHOW VOLUMES WHERE workspace_name = 'xxx';

SHOW VOLUMES WHERE recursive_file_lookup = false;

查询哪些 Volume 使用 xxx.storage_connection：

SHOW VOLUMES WHERE connection = 'xxx.storage_connection';

该命令用于列出当前 schema 下的所有 Volume 信息，并支持通过 WHERE 子句根据指定条件进行过滤显示。

查看外部 Volume 或 Named Volume 下的文件列表。

SHOW VOLUME DIRECTORY <volume_name> [SUBDIRECTORY '<path>']

-- 查看 Volume 根目录下的所有文件 SHOW VOLUME DIRECTORY my_oss_vol; -- 查看指定子目录 SHOW VOLUME DIRECTORY my_oss_vol SUBDIRECTORY 'data/2024/';

列名	说明
`relative_path` relative_path	文件相对路径
`url` url	文件完整 URL
`size` size	文件大小（字节）
`last_modified_time` last_modified_time	最后修改时间

⚠️ 外部 Volume 文件列表可能有缓存延迟。如文件已上传但未显示，执行

ALTER VOLUME <name> REFRESH

ALTER VOLUME <name> REFRESH

刷新目录元数据后再查询。

查看当前用户的 User Volume（个人内部存储）中的文件列表。

SHOW USER VOLUME DIRECTORY [SUBDIRECTORY '<path>']

-- 查看 User Volume 根目录 SHOW USER VOLUME DIRECTORY; -- 查看子目录 SHOW USER VOLUME DIRECTORY SUBDIRECTORY 'uploads/';

返回列与

SHOW VOLUME DIRECTORY

SHOW VOLUME DIRECTORY

相同。