概述
支持的文件类型
文件类型 | 扩展名 | 说明 |
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 文件」 | 拆分文件或仅保留必要的子集 |
文件类型不支持 | 无法选择文件 | 检查文件类型是否在支持列表中或者先转换下类型 |
权限不足 | 「无权限执行上传服务」 | 检查模块权限或服务资源权限是否变更，详见 成员与权限管理 |
兜底错误 | 「上传失败 — {错误详细信息}」 | 根据具体错误描述排查 |
