同步数据库
同步数据库可将数据库或部分表从一个连接复制到另一个连接。此外,它还可将数据库保存为文件夹中的转储文件,或从转储文件中恢复数据库。它已替代 备份与恢复,后者仍作为“备份数据库(旧版)”和“恢复数据库(旧版)”提供。
TablePlus 自带自己的导出和恢复工具,因此你无需单独安装它们。通过 SSH 时,如果 SSH 主机拥有 pg_dump 和 pg_restore(或 mysqldump 和 mysql、mariadb-dump 和 mariadb),TablePlus 将运行服务器自带的工具。否则,它将通过隧道使用其内置工具。
打开同步数据库
请执行以下操作之一:
- 在欢迎窗口中,点击左下角的 Sync database,然后选择 Sync database。
- 前往 Tools > Sync database...
- 在工作空间中,打开 搜索并打开任意项目 (
⌘ + P),然后选择 Sync Database。
同步数据库
- 在 From 下,点击 Choose a Connection or Folder, Files...,然后选择源连接。
- 勾选需要复制的内容:
- 勾选数据库会复制其中的所有表、视图、函数、类型和模式。
- 如果只想复制部分表,可以展开数据库并勾选所需的表。分区和子表会随父表一起复制。
- 在 To 中,选择目标连接并选择要复制的数据库。每个数据库均标记为 Exists 或 Create。若要复制到新数据库,请在列表底部点击 New database。
- 点击 Sync Now。

当你勾选一个源数据库并选择一个目标数据库时,每个表都会显示其处理方式:Replace、Create 或 Kept。同步不会合并行:目标数据库中已存在的表将被源表替换。
当勾选多个数据库时,它们将按相同名称同步到目标数据库。若其中部分数据库已存在,TablePlus 会提示你选择跳过重复项、覆盖它们或保留两者(复制的数据库名称,例如,shop_2)。
对于 MySQL 或 MariaDB 目标,首先备份目标(默认开启)会在同步前保存目标数据库的备份。如果恢复失败,TablePlus 会提供恢复该备份的选项。
审查计划
在写入任何内容之前,TablePlus 会读取两端数据并展示同步方案,例如“将 acme_production 同步到 acme_staging?”。方案会列出各步骤的执行位置、警告信息、目标端丢失的数据以及需要先行检查的内容。点击 Sync 开始同步,或点击 Cancel 取消操作。
如果同步被阻塞(例如其他已勾选表格所依赖的表格),界面会显示同步无法运行的原因。当同步可以执行时,它会提供 Add Dependents 选项,用于勾选缺失的表格。
如果连接启用了 安全模式,TablePlus 会先要求你确认或输入密码。
查看进度
日志显示各阶段(准备、导出、传输、还原或保存、完成)及传输进度。点击 Cancel 可停止同步。出现首个错误时同步也会终止。若在同步运行期间关闭同步窗口,TablePlus 会询问是否要 停止同步 或 继续。
如果切换到其他应用,TablePlus 会在同步完成后发送通知。
导出选项
点击Options... 旁边的已勾选源数据库,以更改其导出方式:
- PostgreSQL:压缩,用于保存为文件的备份(默认开启)。
- MySQL 和 MariaDB:锁定(默认情况下使用无锁的一致性快照,或锁定表),例程和触发器(默认开启),事件,以及二进制列以十六进制格式存储。
要添加转储工具的参数,请从 Choose... 菜单中选择。常用参数列在前面,其余参数在 其他参数 下。查看所有参数 会打开 pg_dump、mysqldump 或 mariadb-dump 的文档。你选择的参数会显示在菜单中:点击 ✕ 可移除其中一个。
要输入菜单中未列出的标志,请选择 Add flag manually... 并输入,例如 --exclude-table=logs 用于 PostgreSQL 或 --ignore-table=shop.logs 用于 MySQL。输入每个标志后,请按 Return。标志后可跟其值,中间用空格分隔。TablePlus 会拒绝其自身设置的标志,例如主机、端口、用户、输出文件及格式。仅适用于转储文件的标志会在两个服务器之间的同步中被排除,并在计划中显示警告。

在 Apply to 下,选择 All databases 或 This database。TablePlus 会记住你在此 Mac 上的选项。
与文件夹同步,或从文件夹同步
在 From 或 To 列表中,请选择 Choose Folder, Files...,而不是选择连接。
- 到文件夹:TablePlus 会将每个选中的数据库导出为转储文件:
<database>.dump(PostgreSQL 自定义格式)或<database>.sql(MySQL 和 MariaDB)。点击文件旁边的Rename以更改文件名,或点击Pattern...以根据日期等部分生成文件名。TablePlus 永远不会覆盖文件:如果文件名已被占用,它会添加_2。 - 从文件夹:勾选要恢复的转储文件。同步读取 PostgreSQL 自定义和 tar 归档,以及 MySQL
.sql和.sql.gz文件。若要运行纯 PostgreSQL.sql文件,请使用 File > Import > From SQL Dump...。请参阅 导入和导出。
你无法在两端同时选择文件夹。
支持的数据库
同步数据库支持 PostgreSQL、MySQL 和 MariaDB 连接:
- 双方必须使用相同的数据库:例如,不能将 MySQL 复制到 MariaDB。
- 无法复制到旧版服务器。
- 对于 PostgreSQL,源版本必须为 9.2 或更高,目标版本必须为 9.6 或更高。
要自动运行同步,请在“同步”窗口中点击 Schedule...。有关详细信息,请参阅 计划任务。