概述
本地文件上传到卷用于把本地的任意格式 文件（图片、音视频、PDF、模型权重、原始日志等）以原始字节 上传到 Catalog 下的 Volume，保留文件本来的结构。上传完成后，文件以 Volume 资源形式在 数据目录 中可见，可被 Notebook、Python 任务、Agent 等下游消费。
维度 | 本地上传到表 | 本地上传到卷 |
文件处理方式 | 按文件类型解析为结构化字段 | 原始字节存储 |
文件类型 | 仅部分类型文件 | 任意格式 |
是否需要计算资源 | 是（用于解析） | 否 |
单次文件数量上限 | 10 个 | 100 个 |
单文件容量上限 | （总大小限制 2 GB） | 5 GB（按单文件计算） |
目标位置 | Catalog → Schema → Table | Catalog → Schema → Volume |
适用场景
机器学习样本灌注 ：把带标签的图片、音频、文本语料以原文件上传到 Volume，供 Notebook 直接读取训练。
模型与配置文件 ：上传模型权重（
.pt / .pkl）、配置文件（.yaml）等模型物料。暂存原始日志 ：把待解析的原始日志先放到 Volume，后续在 Workflow 中通过 Python 任务解析入表。
图片、文档归档 ：批量上传 PDF、合同、扫描件等非结构化资产。
操作步骤
步骤 1：进入文件上传到卷
在控制台进入 数据集成 模块，确认在「接入方式」Tab，点击 文件上传到卷 卡片。系统弹出「文件上传到卷」对话框。
步骤 2：选择文件
支持两种方式：
拖拽 ：将文件直接拖到上传区。
点击选择 ：点击 选择文件 按钮，在系统文件浏览器中单选或多选文件。
约束项 | 限制 | 校验提示 |
文件数量 | 至少 1 个，最多 100 个 | 「最多可上传 100 个文件」 |
单文件容量 | ≤ 5 GB | 「单个文件不超过 5GB」 |
文件类型 | 任意格式 | 不做扩展名校验 |
完整错误清单：
场景 | 提示 |
超出文件数量 | 上传失败 — 最多可上传 100 个文件！ |
单文件超出容量 | 上传失败 — 单个文件不超过 5GB |
网络断开 | 上传失败 — 网络连接断开 |
权限变更 | 上传失败 — 无权限执行上传服务 |
兜底 | 上传失败 — {错误详情} |
文件添加到列表后，可以：
点击 X 移除单个文件。
再次点击 选择文件 追加新文件。
步骤 3：选择目标路径
参数 | 说明 | 是否必填 |
目标路径 | 选择目标 Volume。仅可选 Volume 类型目录；当前 Catalog / Schema 下没有 Volume 时，可在树形目录中即时创建 | 是 |
如需新建 Volume：
鼠标悬停在 Schema 上方，右侧出现 + ，点击弹出创建面板。
Volume 创建详见 非结构化数据 Catalog。
提示
Volume 创建动作脱离当前上传流程 。即使您在创建 Volume 后取消了本次上传，已创建的 Volume 仍会保留在 Catalog 中。
参数 | 说明 | 是否必填 |
同名处理 | 自动重命名 （默认）：生成新文件名 文件名_1；替换现有文件 ：用最新数据覆盖已存在的同名文件 | 是 |
仅展示当前账号有写入权限的 Catalog / Schema / Volume。可使用搜索框模糊匹配目录名。
步骤 4：上传
点击 上传 ：
系统跳转回数据集成首页，并在右下角弹出上传进度列表 。
列表中以背景条展示每个文件的进度百分比。
进度列表支持的操作：
操作 | 说明 |
跳转到资源 | 上传完成后点击文件后的「链接」图标，跳转到该文件所在 Volume 详情页；未完成时不可跳转 |
隐藏 / 展开列表 | 点击右上角关闭图标，列表隐藏为页面顶部的缩略进度标识；点击标识可重新展开列表 |
步骤 5：验证结果
上传完成后，您可以：
1. 在 数据目录 中导航到目标 Volume，确认文件已存在。
2. 在 Notebook 中通过文件路径读取该 Volume 文件。
3. 在 Workflow 中以 Python File 任务读取并处理 Volume 中的文件。
常见问题
Q：单次上传超过 100 个文件或超过 5 GB 怎么办？
Q：上传到卷的文件能否反向解析为结构化表？
Q：上传过程中关闭浏览器会怎样？
A：未完成的上传会被中断。再次进入页面时，已成功上传到 Volume 的文件不受影响；中断的文件需要重新上传。
Q：上传时网络中断后能续传吗？
A：当前不支持断点续传。出现「网络连接断开」提示时，请等待网络恢复后重新上传该文件。
Q：为什么目标路径无法选中？
A：目标 Volume 路径，必须至少要到 volume 节点（完整路径为 catalog 》 schema 》 volume 》 文件目录），可以点击文件树的左侧小三角形，来展开文件树，直到 volume 节点或文件目录节点。
相关文档
文件到 Volume 同步（周期性接入场景）
