数据导入与导出

适用场景

本页覆盖三类已上线工作流：将本地文件导入指定表、从工作台导出查询结果，以及通过数据工具发起后台大数据导出。不同路径适合不同的数据量与交付目的。

• CSV / JSON 导入：接收业务系统或第三方工具交付的数据文件，通过预览和字段映射写入已有目标表。
• SQL 文件导入：执行已审查的 INSERT 等脚本；适合保留数据库语义的交付，但必须先检查目标对象、事务边界和潜在破坏性语句。
• 查询结果导出：在 SQL 工作台执行带明确筛选条件的查询，将当前结果交付为 CSV、JSON、SQL、Excel 或 PDF。
• 表或大结果集导出：按整表或自定义 SQL 创建后台任务，由「导出任务」查看状态并在完成后下载 Excel 或 zip 产物。

不要把导出当作数据库备份：CSV、JSON、Excel 和 PDF 通常不包含完整 DDL、索引、约束、权限或存储过程。需要恢复能力时，应使用专门的备份与恢复流程。

入口路径

SQL 工作台 · 查询执行结果

前置条件

• 连接已配置且连接测试通过；当前账号拥有读取源数据、写入目标表或执行脚本所需的数据库权限。
• 确认目标数据库、Schema 和表，记录主键、唯一约束、非空列、默认值及字段类型；重要数据先备份，并验证备份可用于恢复。
• 导入前用可信编辑器检查文件编码和实际分隔符。CSV 要特别注意 UTF-8 / GBK、逗号 / 分号 / Tab、首行表头、引号转义和换行字段。
• JSON 应确认顶层结构和字段类型一致；SQL 文件必须人工审阅，排除错误库名、DROP / TRUNCATE、无条件 UPDATE / DELETE 等高风险语句。
• 导出前明确接收人、保存目录、保留期限与允许出现的字段，尤其检查密码摘要、令牌、证件号、手机号、邮箱和业务密钥等敏感数据。
• 为大数据导出预留足够磁盘空间和任务运行时间。实际耗时取决于数据库负载、网络、查询复杂度、结果大小和本机环境，不承诺固定数据量下的完成时间。

编号步骤

1. 确定方向与范围。明确是导入到哪个表，还是导出哪张表 / 哪条查询；写下目标库、Schema、表名、筛选条件、预估行数和文件接收方，避免在相似环境间选错连接。
2. 准备并检查源文件或查询。导入时确认 CSV、JSON 或 SQL 文件来源可信，检查编码、分隔符、表头、空值和日期格式；导出时先在工作台运行只读查询，核对列、行数与过滤条件。
3. 选择正确入口。普通文件导入进入「数据导入」；当前查询结果从工作台结果集导出；整表或较大查询进入「大数据导出」，不要为节省一步而导出未经筛选的生产全表。
4. 配置参数并预览。导入 CSV 时选择编码、分隔符和表头设置；逐列检查源字段到目标字段的映射以及类型兼容性。JSON 检查缺失字段与嵌套值，SQL 文件再次核对将要影响的对象和语句。
5. 先做小范围确认。用测试表、事务或少量样本执行，检查中文是否乱码、NULL 与空字符串是否符合预期、日期和小数是否被正确解析、主键是否重复。发现问题先停止并修正参数，不要在错误映射上继续追加数据。
6. 执行正式任务。确认备份与目标无误后启动导入或导出。大数据导出提交后转到「导出任务」观察进行中 / 完成 / 失败状态；界面关闭不等同于产物已经生成，应以任务页状态为准。
7. 验证结果与交付。导入后比较源记录数与目标新增 / 更新情况，并抽查关键字段；导出后打开产物检查表头、编码、首尾记录和文件数量。发送前再次扫描敏感字段，按最小必要范围交付并清理不再需要的副本。

SQL 执行历史 · 复核执行记录

参数说明

格式选择边界：CSV 结构简单但类型信息有限；JSON 更适合保留字段名和层级信息，但目标表导入通常要求可映射的稳定结构；SQL 文件便于重放数据库语句，却具有直接修改数据的风险；Excel / PDF 更偏人工查看，不应作为需要精确恢复数据库对象的备份格式。

预期结果

操作完成不应只以“按钮已点击”或“文件已生成”为判断标准。至少完成以下核验：

• 导入：任务成功结束，目标表记录数变化符合计划；主键和唯一约束无异常；中文、日期、小数、布尔值、NULL 与空字符串抽样结果正确。
• 查询结果导出：文件可以打开，表头与查询列一致，筛选后的首尾记录和抽样值与工作台结果相符，编码在接收工具中显示正常。
• 后台大数据导出：「导出任务」显示完成，下载得到 Excel 或 zip；若产物被分片，压缩包内各文件可读取且文件集合覆盖预期范围。
• 敏感数据：导出字段符合审批与最小必要原则；不需要的账号标识、凭据、令牌及个人信息已经排除或按组织规则处理。
• 可追溯性：保留查询条件、目标对象、文件校验信息或交付记录；SQL 历史可帮助定位执行语句，但仍需记录业务侧的验收结论。

常见问题

CSV 预览列错位或中文乱码怎么办？

先停止导入，不要带着错误预览继续执行。用文本编辑器确认文件真实编码、分隔符、引号和换行规则，再回到导入向导调整编码、分隔符与首行表头选项。用包含中文、逗号、引号和空值的几行样本验证，预览稳定后再导入。

字段映射正确，但导入仍因类型或约束失败怎么办？

检查目标列的类型、长度、精度、非空约束、主键与唯一约束；重点核对日期格式、超长文本、小数精度、重复键以及空字符串与 NULL。先把失败行缩减成最小样本定位具体字段，不要通过删除约束来绕过数据质量问题。

SQL 文件导入前需要检查什么？

确认脚本来源、目标库 / Schema、标识符方言、事务边界和影响范围；搜索 DROP、TRUNCATE、无条件 UPDATE / DELETE 等语句，并核对 INSERT 列表是否与目标表一致。重要环境先备份，在测试库执行并抽样验收后再决定是否用于正式库。

查询结果较大，直接导出和后台导出如何选择？

需要快速交付已筛选的当前结果时，可从工作台导出；预计运行时间较长、结果较大或需要分片时，使用「大数据导出」创建后台任务并在「导出任务」跟踪。不要依赖固定行数阈值，数据库负载、列宽、查询复杂度和网络都会影响耗时与资源占用。

后台任务失败或下载文件打不开怎么办？

先在「导出任务」确认状态，复查连接、权限、自定义 SQL、可用磁盘空间和结果规模。将 SQL 放回工作台用更小范围验证；若 zip 可下载但无法解压，重新下载并检查文件是否完整。仍失败时保留任务信息和相关日志，避免反复提交相同的大范围任务。

导出的文件可以直接发给外部人员吗？

不建议未经检查直接发送。先按接收目的删除不必要字段，检查令牌、密码摘要、证件号、联系方式和内部业务标识，并遵循组织的脱敏、加密、审批与保留要求。交付后清理临时目录和不再需要的副本。

相关文档

• 工具中心 · 数据工具：查看数据导入、大数据导出、导出任务与备份恢复的功能总览。
• SQL 工作台：了解查询执行、结果集视图、结果导出与 SQL 执行历史。
• 连接管理：先配置并测试用于导入或导出的数据源连接。
• 常见问题：排查连接、运行和使用过程中的常见问题。