数据传输
数据传输把一个数据源中的表或集合复制到另一个连接、数据库或 Schema。它适合环境迁移、测试数据准备和一次性数据整合,不是持续复制、CDC 或双向同步方案。
入口
数据传输向导
向导适合一次传输多张表。你可以分别选择源和目标连接、Catalog、数据库和 Schema,再配置建表、写入模式、目标表名大小写和批大小。
侧边栏复制与粘贴
在对象树中复制一张或多张表后,可以粘贴到目标位置:
- 同一上下文中可选择“结构和数据”“仅结构”或“仅数据”,并逐表修改目标名称
- 粘贴到另一个连接、数据库或 Schema 时,DBX 会自动打开数据传输向导并带入源表和目标位置
- 表数据复制会跳过生成列或计算列,并对 PostgreSQL identity、SQL Server identity 等路径应用相应写入处理
查询结果导出到数据库
在查询结果网格的“导出”菜单或右键菜单中选择“导出到数据库”,填写目标连接、数据库、Schema(如适用)和表名。
填写目标后,可点击“执行预览”查看数据来源、目标位置、当前已加载行列数、源字段和预计操作。预览不会写入数据库;显示的行数是当前已加载行数,执行时仍会读取完整可导出结果并检查限制。点击“开始传输”后必须再次点击“确认传输”;覆盖已有表时会明确提示删除目标表全部原有数据。返回修改会保留当前填写内容。
- 创建目标表:同引擎的单表
SELECT * FROM 表会读取源表 DDL,保留字段类型、长度、精度、默认值、注释、主键、索引及表选项,再替换目标表名。Schema 内必须唯一的索引或约束名会调整,避免与源对象冲突。无法安全复制结构时会停止,不会自动降级为全部文本字段。 - 投影、关联、表达式查询和跨引擎查询使用结果字段生成新表;这些结果没有唯一对应的整表 DDL。元数据不足或目标时间精度不足时使用可保留值的文本类型,不推断原表约束。写入已有表时,无法保留的时间精度会在写入前报错。
- 创建表时目标名称必须尚不存在。写入已有表请取消勾选“创建目标表”;追加保留原数据,覆盖以事务执行
DELETE + INSERT,保留目标结构、外键和触发器。MySQL 已有表需要 InnoDB。 - 导出读取完整查询结果,并检查导出行数限制、分页完整性和大字段预览。存储过程或会修改数据的语句不会为了传输而再次执行;只有已完整加载的结果可直接使用。
- 使用活动游标或手动事务的结果需要先在网格中加载全部行。普通分页在源查询会话中读取,保留会话设置,避免从其他连接读到不同数据。
- 手动事务中暂不支持复制源表结构;提交或回滚后重新查询,再选择“创建目标表”。MySQL、H2 临时表也会停止结构复制,避免生成生命周期不同的目标表。
- 准备阶段可以取消;开始写入后等待事务结束。对于会隐式提交建表的驱动,写入失败后会尝试删除本次成功创建的表,清理失败会显示表名。
此入口只列出已实现事务写入的目标驱动。它不迁移独立触发器、权限或跨表依赖;复杂 DDL、目标不兼容的类型和不支持的标识列处理会明确失败。需要整库或多对象迁移时使用数据传输向导。
向导流程
选择源位置
选择源连接、Catalog(如适用)、数据库和 Schema。DBX 只列出可传输的基础表;MongoDB 路径列出集合。
选择目标位置
选择另一个连接、数据库或 Schema。源和目标不能是完全相同的位置。
选择表
可以全选、搜索或只选择部分表。一次请求中的表必须来自同一个源位置。
配置传输选项
确认是否创建目标表、写入模式、目标表名大小写和批大小。
后台执行并检查结果
对话框关闭后任务继续运行。进度中心显示当前表、表序号、行数、耗时、失败表和取消状态。
传输选项
| 选项 | 说明 |
|---|---|
| 创建目标表 | 目标表不存在时,根据源元数据和目标数据库能力生成表结构 |
| 重建结构和数据 | 将现有目标表重命名为备份表(__dbx_bak_ 前缀),从源结构重建,插入数据后删除备份。任一步骤失败则保留备份表以供手工恢复。生产数据库需二次确认。支持 MySQL、PostgreSQL、SQL Server、KingBase、GaussDB、OpenGauss、KWDB、GoldenDB、SQLite、DuckDB 和 Cloudflare D1。 |
| 追加 | 保留目标表已有数据并插入源数据 |
| 覆盖 | 在传输该表前清空目标表,再写入源数据 |
| Upsert | 目标路径支持且能确定键时,按键更新或插入 |
| 表名大小写 | 保持原样、转小写或转大写;转换后的目标名必须互不冲突 |
| 批大小 | 控制分页读取和分批写入,默认 1000,可在界面中调整 |
| 操作超时 | 默认分别继承源连接和目标连接的查询超时;也可为当前传输设置 0–3600 秒,0 表示不限制 |
如果关闭“创建目标表”,目标表必须已经存在且字段可兼容。即使开启建表,跨引擎 DDL 也可能因目标数据库不支持某些类型、默认值、约束或对象而需要人工调整。
操作超时不限制整个传输任务的总时长。支持增量结果流的驱动会把它作为“无进展等待时间”,每次收到数据都会重新计时;只能一次性返回结果的驱动则按单次数据库操作的总耗时计算。自定义值只作用于当前传输及其保存任务,不会修改连接或查询编辑器的超时设置。
结构 SQL 预览
“仅结构”传输不会静默修改目标库:DBX 会先生成即将执行的结构语句,在只读确认对话框中展示(语法高亮、可复制、可换行),此时取消则不会执行任何语句。
SQL Preview 上方会显示 结构传输计划,包含操作计数和对象级列表,例如计划创建的表、明确跳过的已有目标、重建,以及结构化元数据支持的索引、外键、序列或注释。操作来自与 SQL 相同的规划决策;DBX 不会解析 SQL 来猜测操作。
该摘要描述的是传输计划,不是完整的源/目标 Schema Diff。它不会比较列类型、默认值或可空性,不会检测仅目标端对象,也不表示已有目标与源结构完全相同。例如,SKIP table users — target already exists 表示该表不会规划结构 DDL,并不代表源表与目标表一致。
预览覆盖传输即将执行的表级结构操作:
CREATE TABLE(必要时还包括需要内联创建的 PostgreSQL 兼容 schema)COMMENT注释语句- MySQL 系列延后执行的
ALTER TABLE ... ADD CONSTRAINT ... FOREIGN KEY - PostgreSQL 兼容的索引与外键
- 源结构对应的 PostgreSQL 序列语句
- 启用重建时,还包括改名为备份表与最终清理备份的语句
这是预览,不是冻结脚本。开始执行时 DBX 会重新读取源/目标元数据并重新执行现有安全检查,因此期间目标结构发生变化时,实际执行可能与预览不同——DBX 是重新校验,而不是照搬预览的语句。
所选的非表对象(视图、例程、触发器、独立序列等)仍会在执行阶段传输,但其生成的 DDL 不会在预览中展开,对话框中会明确说明这一点。
本阶段“结构和数据”模式的确认流程保持不变。
PostgreSQL 结构和所有者
PostgreSQL 到 PostgreSQL 且启用创建表时,DBX 会在能力允许时处理序列、索引、外键以及部分 Schema 级对象和依赖。若源对象所有者在目标实例中不存在,开始前会提示选择:
- 跳过相关所有者信息
- 把缺失所有者重新分配为目标当前用户
- 取消并先在目标实例创建所需角色
这不等价于完整的 pg_dump / pg_restore。扩展、权限、策略、触发器或依赖复杂时,仍应使用 PostgreSQL 原生迁移工具验证。
失败处理
多表任务不会因为第一张表失败就立即丢弃整个队列。DBX 会记录该表的错误并继续尝试后续表,最后以成功或带失败的终态结束。
- 进度中保存每张失败表及错误摘要
- 失败数量较多时,界面只展示有限条目并报告被省略的数量
- 同一目标表已有传输任务运行时,新任务会被阻止,避免并发覆盖
- 取消会停止后续读取和写入,但已提交的数据不会自动撤销
因此“任务完成”不代表所有表都成功;应检查最终状态、失败列表、目标行数和关键字段。
Oracle/OceanBase Oracle 独立过程和函数传输后还会读回精确对象、完整定义和编译结果。DDL 返回成功但对象为 INVALID,或读回失败、定义不符时,均不计为传输成功;错误中保留编译位置或核对失败原因。已有目标仍跳过,新建不使用 OR REPLACE 覆盖同名对象。
数据库覆盖范围
DBX 按驱动能力清单过滤源和目标连接。当前实现同时包含 SQL 到 SQL、MongoDB 到 MongoDB,以及部分 MongoDB 与 SQL 之间的转换路径;并非所有已支持连接都提供数据传输。
不同组合的能力也不完全相同,例如:
- 某些引擎只能传输表数据,不能复用源 DDL
- Upsert 依赖目标数据库和可识别的键
- Catalog、Schema、identity、数组、JSON 和二进制值的处理因引擎而异
- 专用搜索、向量、消息队列和配置中心连接不使用此通用表传输入口
如果连接未出现在下拉列表中,表示当前驱动没有声明数据传输能力,而不是仅仅缺少 UI 入口。
传输前检查
- 目标连接是否开启只读保护;只读目标会被直接阻止
- 源和目标账号是否分别具有读取、建表和写入权限
- 目标表名大小写转换后是否冲突
- 主键、唯一约束、外键、触发器和非空字段是否会拒绝数据
- 从生产环境复制到低环境前是否需要脱敏
- 大表是否更适合数据库原生导出、导入或在线迁移工具