产品动态
产品简介
购买指南
快速入门
Buddy
- Buddy — 数据分析场景
- 数据工程 Agent
- Buddy 概述
- 数据治理 Agent
- Buddy 数据安全
- Buddy Agent 基础能力概述
平台管理
- 工作空间管理
- 计算资源管理
- 数据源管理概述
数据集成
- 支持的数据接入方案
- 支持的数据源与读取能力
- 数据源管理
- 数据源列表
- 离线数据同步
- 实时数据同步
- 文件上传
数据工程
- Studio
- Workflow
- CI/CD
数据科学
- 数据科学概述
- 模型实验
- 特征管理
- 模型管理
- 模型服务
数据分析
- 数据探索概述
数据治理
- 数据目录概述
- 数据发现概述
- 数据安全概述
- 数据质量概述
- 语义模型概述
- 治理标签概述
数据应用
- 智能体开发
- MCP
- 模型列表
API 文档
- History
- Introduction
- API Category
- Making API Requests
- Console APIs
- Workspace APIs
- Computational Resource APIs
- Development Studio APIs
- Workflow APIs
- Catalog APIs
- Data Types
- Error Codes
常见问题
相关协议
- 服务等级协议
- 服务条款
联系我们
词汇表

支持的文件类型及约束

下载

聚焦模式

字号

最后更新时间： 2026-10-09 16:22:03

概述
本文列出 本地上传到表 支持的文件类型、单次上传约束以及常见错误提示，帮助您在上传前对文件做必要的预处理与拆分。
支持的文件类型
文件类型
扩展名
说明
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 文件上传到表
文件到表同步

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

大数据智能体工作台 DataBuddy

支持的文件类型及约束

概述

支持的文件类型

单次上传约束

字段命名规则

常见错误提示

相关文档

帮助和支持

文件类型	扩展名	说明
CSV	`.csv`	逗号分隔的结构化文本，常见的导出格式
JSON	`.json`	JSON 文档；支持单条对象、数组、多对象（每行一条）三种排列方式
Avro	`.avro`	自描述的二进制行存格式，无需额外指定字段
Parquet	`.parquet`	自描述的二进制列存格式，无需额外指定字段
Text	`.txt`	自定义分隔符的纯文本文件
XML	`.xml`	XML 文档，需指定行标签（系统会自动推断）

约束项	限制值	校验提示
文件数量	至少 1 个，最多 10 个	「最多可上传 10 个文件」
文件总容量	所有文件大小之和 ≤ 2 GB	「最多可上传 2GB 文件」

原始字段	处理后字段	规则
空格	清空	字段名仅含空格时清空；如全部字段名为空，依次赋予 `c_1`、`c_2`
中文	拼音	例如「名称」→ `mingcheng`
非合法字符	`_`	例如 `a&b` → `a_b`

规则	说明
起始字符	必须是字母、数字或下划线
字符范围	仅允许字母、数字、下划线、`/`、`=`、`-`
长度	不超过 64 个字符

场景	提示	处理建议
超出文件数量	「最多可上传 10 个文件！」	删除部分文件后重试
总容量超出	「最多可上传 2GB 文件」	拆分文件或仅保留必要的子集
文件类型不支持	无法选择文件	检查文件类型是否在支持列表中或者先转换下类型
权限不足	「无权限执行上传服务」	检查模块权限或服务资源权限是否变更，详见成员与权限管理
兜底错误	「上传失败 — {错误详细信息}」	根据具体错误描述排查