GET 命令

GET 命令用于将 Lakehouse Volume 对象中的文件下载到客户端本地路径，支持外部 Volume、TABLE VOLUME 和 USER VOLUME 三种来源类型。

执行方式

GET 是客户端侧命令，由 Lakehouse 客户端工具负责接收数据并写入本地文件系统。支持以下执行方式：

⚠️ 注意：Studio SQL 编辑器不支持 GET。Studio 运行在服务端，无法向你的本地机器写入文件；而 GET 需要把文件下载到本地，因此只能在上述客户端工具中执行。

语法

GET { VOLUME volume_name | TABLE VOLUME table_name | USER VOLUME } [ FILE 'file' ] TO 'local_path' [ option_key = option_value ] ...

参数说明

参数	是否必填	说明
`VOLUME volume_name` VOLUME volume_name	三选一	从指定的外部 Volume 下载文件。
`TABLE VOLUME table_name` TABLE VOLUME table_name	三选一	从指定表的 TABLE VOLUME 暂存空间下载文件。
`USER VOLUME` USER VOLUME	三选一	从当前用户的 USER VOLUME 下载文件。
`FILE 'file'` FILE 'file'	否	指定要下载的文件路径（相对于 Volume 根目录）。不指定时下载 Volume 根目录下所有文件。
`local_path` local_path	是	本地目标路径。Linux/macOS 以 `/` / 开头；Windows 使用正斜杠分隔。

示例

示例 1：从 USER VOLUME 下载指定文件

GET USER VOLUME FILE 'university_info.csv' TO '/Users/Downloads/';

示例 2：从 USER VOLUME 下载子目录中的文件

GET USER VOLUME FILE 'test_export/part00001.csv' TO '/Users/Downloads/output/';

示例 3：从外部 Volume 下载文件

GET VOLUME hz_image_volume FILE 'catsdogs.zip' TO '/Users/Downloads/';

示例 4：导出表数据后下载到本地

先将表数据导出到 USER VOLUME，再下载到本地：

-- 将表数据导出到 USER VOLUME 子目录 COPY INTO USER VOLUME SUBDIRECTORY 'tmp/' FROM TABLE mytable FILE_FORMAT = (TYPE = CSV); -- 查看导出的文件 SHOW USER VOLUME DIRECTORY;

+---------------------------+------+---------------------+ | relative_path | size | last_modified_time | +---------------------------+------+---------------------+ | tmp/part00001.csv | 61 | 2026-05-09 06:34:53 | +---------------------------+------+---------------------+

-- 下载文件到本地 GET USER VOLUME FILE 'tmp/part00001.csv' TO '/Users/Downloads/'; -- 下载完成后删除 Volume 中的临时文件 REMOVE USER VOLUME FILE 'tmp/part00001.csv';

注意事项

从外部 Volume 下载文件会产生对应云账号的对象存储下载费用。
执行 GET 命令需要对来源 Volume 具有读取权限。
```
local_path
```
local_path
指定的目录必须在客户端本地已存在，命令不会自动创建目录。
下载大文件时，网络带宽和本地磁盘空间是主要限制因素，请提前确认可用空间。

联系我们