一、概述
与 本地上传到表 不同，本流程不解析文件、不生成结构化表 ：
| 维度 | 本地上传到表 | 本地上传到卷 |
| 文件处理方式 | 按文件类型解析为结构化字段 | 原始字节存储 |
| 文件类型 | 仅部分类型文件 | 任意格式 |
| 是否需要计算资源 | 是（用于解析） | 否 |
| 单次文件数量上限 | 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 怎么办？
A：分批多次上传；如有大量原始数据沉淀在对象存储或文件系统中，建议改用 文件到 Volume 同步 通过周期性离线同步任务接入。
九、Q：上传到卷的文件能否反向解析为结构化表？
A：可以。上传后你可以创建 SQL 任务或 Python 任务读取 Volume 文件，并写入到结构化表；也可使用 文件到表同步 把 Volume 中的文件批量入表。
十、Q：上传过程中关闭浏览器会怎样？
A：未完成的上传会被中断。再次进入页面时，已成功上传到 Volume 的文件不受影响；中断的文件需要重新上传。
十一、Q：上传时网络中断后能续传吗？
A：当前不支持断点续传。出现「网络连接断开」提示时，请等待网络恢复后重新上传该文件。
十二、Q：为什么目标路径无法选中？
A：目标 Volume 路径，必须至少要到 volume 节点（完整路径为 catalog 》 schema 》 volume 》 文件目录），可以点击文件树的左侧小三角形，来展开文件树，直到 volume 节点或文件目录节点。
十三、相关文档
·文件上传
·本地上传到表
·COS 文件上传到表
·文件到 Volume 同步（周期性接入场景）
·非结构化数据 Catalog
·数据目录概述