内部 Volume
内部 Volume 是 Lakehouse 自动提供的文件存储空间 ，无需创建，开箱即用。适合没有云对象存储账号、或需要临时存放文件的场景。
两种内部 Volume
User Volume
每个用户自动拥有一个专属存储空间，用于上传本地文件并导入到表中。User Volume 是用户私有的，其他用户无法访问。
-- 上传本地文件
PUT '/local/data.csv' TO USER VOLUME;
-- 查看已上传的文件
SHOW USER VOLUME DIRECTORY;
-- 直接查询文件内容（无需先导入到表）
SELECT * FROM USER VOLUME
USING CSV OPTIONS('header' = 'true')
FILES('data.csv');
-- 从 User Volume 导入数据到表
COPY INTO my_table
FROM USER VOLUME
USING CSV OPTIONS('header' = 'true')
FILES('data.csv');
-- 下载文件到本地
GET USER VOLUME FILE 'data.csv' TO '/local/output/';
-- 删除文件
REMOVE USER VOLUME FILE 'data.csv';
Table Volume
每张表自动关联一个专属存储空间，随表创建而存在。Table Volume 不存放表的实时数据 （表数据由系统内部管理），而是作为与该表绑定的文件存储区域，供用户手动导出或导入文件使用。
操作 Table Volume 需要对应表的权限。
-- 查看 Table Volume 中的文件
SHOW TABLE VOLUME DIRECTORY my_table;
-- 结果示例（新建表为空）：
-- +---------------+-----+------+--------------------+
-- | relative_path | url | size | last_modified_time |
-- +---------------+-----+------+--------------------+
-- （空）
-- 导出表数据到 Table Volume（备份场景）
COPY INTO TABLE VOLUME my_table
SUBDIRECTORY 'backup/'
FROM my_table
FILE_FORMAT = (TYPE = PARQUET);
-- 导出后查看文件
SHOW TABLE VOLUME DIRECTORY my_table;
-- 结果示例：
-- +---------------------------+-----+------+----------------------------+
-- | relative_path | url | size | last_modified_time |
-- +---------------------------+-----+------+----------------------------+
-- | backup/part00001.parquet | | 1296 | 2026-05-22T13:24:11.000Z |
-- +---------------------------+-----+------+----------------------------+
-- 查询 Table Volume 中的文件内容
SELECT * FROM TABLE VOLUME my_table
USING PARQUET SUBDIRECTORY 'backup/';
-- 从 Table Volume 导入数据到表
COPY INTO my_table
FROM TABLE VOLUME my_table
USING PARQUET SUBDIRECTORY 'backup/';
⚠️ 注意 ：
SHOW VOLUME DIRECTORY my_tableSHOW VOLUME DIRECTORY my_table
会报错（系统会尝试查找同名的 Named Volume）。查看 Table Volume 必须使用
SHOW TABLE VOLUME DIRECTORY my_tableSHOW TABLE VOLUME DIRECTORY my_table
。
与其他 Volume 类型的选择
场景 推荐 没有云存储账号，需要上传文件 User Volume 与特定表绑定的备份/导出文件 Table Volume 团队共享的内部存储空间 Named Volume （CREATE VOLUMECREATE VOLUME
）已有 OSS/COS/S3，需要直接访问 外部 Volume
相关文档
