docs: refine documentation site

This commit is contained in:
t8y2 committed 2026-05-09 19:02:20 +08:00
1 parent b1de40b1e5
commit 0d8206b237
28 files changed
+2113 -1430

No files matched your search

+65 -24
View File
@@ -1,47 +1,88 @@
---
title: 数据传输
description: 跨引擎数据迁移,MySQL → PostgreSQL、SQLite → SQL Server,自动处理类型映射。
description: 在不同连接或不同数据库引擎之间迁移表数据。
---
<Callout type="info">
跨数据库引擎数据迁移,自动处理类型映射和语法差异。MySQL 到 PostgreSQL,SQLite 到 SQL Server,开箱即用。
数据传输用于把表数据从一个连接复制到另一个连接。它适合开发、测试、迁移和数据整合场景,但不应该替代正式的数据同步链路。
## 适合的场景
- 把生产库的一部分数据复制到开发环境
- 在 MySQL、PostgreSQL、SQLite、SQL Server 等引擎之间迁移数据
- 将多个数据源整理到同一个分析库
- 为测试环境准备一份可复现的数据集
<Callout type="warn">
跨引擎传输会涉及类型映射、默认值、约束和自增字段差异。传输完成后请抽样检查数据,重要迁移建议先在测试环境演练。
</Callout>
## 典型场景
- **跨引擎迁移** — MySQL → PostgreSQL、SQLite → SQL Server
- **环境数据同步** — 从生产库拉取数据到开发环境
- **数据整合** — 将多个数据源的数据汇集到一个数据库
## 使用流程
<Steps>
<Step>
### 选择源和目标
选择**源连接**和**目标连接**,可以是不同类型的数据库引擎。
### 选择源连接
源连接是数据读取的位置。确认账号有读取目标表的权限。
</Step>
<Step>
### 选择要传输的表
选择传输全部表,或手动勾选需要传输的特定表。
### 选择目标连接
目标连接是数据写入的位置。确认账号有写入权限,并确认目标库环境无误。
</Step>
<Step>
### 选择表
可以传输全部表,也可以只选择需要的表。大表建议分批处理。
</Step>
<Step>
### 开始传输
点击"开始传输",DBX 自动处理类型映射和语法差异。
DBX 会按表读取数据,并根据所选模式写入目标数据库。可选择是否创建目标表。
</Step>
<Step>
### 检查结果
传输完成后检查行数、错误列表和关键字段。
</Step>
</Steps>
## 进度追踪
## 传输过程
传输过程中,DBX 实时显示:
DBX 会在传输过程中展示:
- 当前正在传输的表名
- 已传输的行数
- 整体传输进度
- 当前正在处理的表
- 已传输行数
- 总体进度
- 错误信息和对应表名
## 错误处理
如果某张表失败,当前传输会停止并展示错误信息。修正表结构、权限或约束问题后,可以重新发起传输。
如果传输过程中遇到错误(如类型不兼容、约束冲突等),DBX 会:
## 传输选项
- 记录错误信息和对应的表名
- 继续传输其他表,不会因单个表的错误中断整个任务
- 传输完成后汇总展示所有错误,便于排查和处理
| 选项 | 说明 |
|---|---|
| 创建目标表 | 目标库没有对应表时,尝试根据源表结构创建 |
| 追加 | 将数据插入目标表现有数据之后 |
| 清空后导入 | 先清空目标表,再写入源数据 |
| 批大小 | 控制每批写入的行数 |
## 传输前检查
| 检查项 | 原因 |
|---|---|
| 目标环境 | 避免误写生产库或错误环境 |
| 表结构 | 字段名、类型、主键和唯一约束会影响写入 |
| 数据量 | 大表可能需要更长时间,也可能触发超时 |
| 约束 | 外键、唯一约束、非空字段可能导致写入失败 |
| 敏感数据 | 从生产复制到低环境前,确认是否需要脱敏 |
## 相关功能
<Cards>
<Card title="表数据导入" href="/cn/docs/table-import">
从 CSV、TSV、JSON 或 Excel 导入到单张表。
</Card>
<Card title="数据库导出" href="/cn/docs/database-export">
将数据库导出为 SQL 文件,便于备份或离线迁移。
</Card>
</Cards>