一、概述
这篇列出 本地上传到表 支持的文件类型、单次上传约束以及常见错误提示，帮助你在上传前对文件做必要的预处理与拆分。
二、支持的文件类型
| 文件类型 | 扩展名 | 说明 |
| CSV | .csv | 逗号分隔的结构化文本，常见的导出格式 |
| JSON | .json | JSON 文档；支持单条对象、数组、多对象（每行一条）三种排列方式 |
| Avro | .avro | 自描述的二进制行存格式，无需额外指定字段 |
| Parquet | .parquet | 自描述的二进制列存格式，无需额外指定字段 |
| Text | .txt | 自定义分隔符的纯文这篇件 |
| XML | .xml | XML 文档，需指定行标签（系统会自动推断） |
各类型的解析行为与可调整参数详见 文件解析与推断。
注意：说明：
注意：单次上传支持多种类型混合 ，例如可以一次上传 1 个 CSV + 2 个 JSON。但建议同一批次上传结构相似 的文件，否则在合表模式下会产生大量空值字段。
三、单次上传约束
| 约束项 | 限制值 | 校验提示 |
| 文件数量 | 至少 1 个，最多 10 个 | 「最多可上传 10 个文件」 |
| 文件总容量 | 所有文件大小之和 ≤ 2 GB | 「最多可上传 2GB 文件」 |
四、字段命名规则
源文件字段可能存在中文、非法字符等不符合作为建表信息。因此 DataBuddy 在文件上传到表流程中会自动对字段名进行规范化 ，你也可在「数据预览」阶段手动调整：
| 原始字段 | 处理后字段 | 规则 |
| 空格 | 清空 | 字段名仅含空格时清空；如全部字段名为空，依次赋予 c_1、c_2 |
| 中文 | 拼音 | 例如「名称」→ mingcheng |
| 非合法字符 | _ | 例如 a&b → a_b |
合法字符的定义：字母、数字、下划线、/、=、-。
字段名输入框校验规则：
| 规则 | 说明 |
| 起始字符 | 必须是字母、数字或下划线 |
| 字符范围 | 仅允许字母、数字、下划线、/、=、- |
| 长度 | 不超过 64 个字符 |
表名也按相同规则处理：原始文件名解析后自动输入表名。
五、常见错误提示
| 场景 | 提示 | 处理建议 |
| 超出文件数量 | 「 最多可上传 10 个文件！」 | 删除部分文件后重试 |
| 总容量超出 | 「最多可上传 2GB 文件」 | 拆分文件或仅保留必要的子集 |
| 文件类型不支持 | 无法选择文件 | 检查文件类型是否在支持列表中或者先转换下类型 |
| 权限不足 | 「无权限执行上传服务」 | 检查模块权限或服务资源权限是否变更，详见 成员与权限管理 |
| 兜底错误 | 「上传失败 — {错误详细信息}」 | 根据具体错误描述排查 |
六、相关文档
·文件解析与推断
·预览与 Schema 编辑
·COS 文件上传到表
·文件到表同步