GET 命令
GET 命令用于将 Lakehouse Volume 对象中的文件下载到客户端本地路径，支持外部 Volume、TABLE VOLUME 和 USER VOLUME 三种来源类型。
执行方式
GET 是客户端侧命令，由 Lakehouse 客户端工具负责接收数据并写入本地文件系统。支持以下执行方式：
语法
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
指定的目录必须在客户端本地已存在，命令不会自动创建目录。- 下载大文件时，网络带宽和本地磁盘空间是主要限制因素，请提前确认可用空间。
