使用pgAdmin进行数据库迁移的详细步骤

一、迁移前准备工作

在动手之前，有几项准备工作必须做到位。这就像搬家前要打包好物品、确认新家地址一样，能避免后续很多麻烦。

1. 确认环境兼容性：首先得确保源服务器和目标服务器的PostgreSQL版本是兼容的。通常来说，如果没有特殊需求，直接保持版本一致是最稳妥的选择。同时，你使用的pgAdmin版本也需要支持这两端的PostgreSQL版本。
2. 安装并配置pgAdmin：
   • 如果目标服务器上还没有安装pgAdmin，可以通过以下方式搞定：
     • CentOS系统：使用yum命令安装（sudo yum install pgadmin4-web）。安装后，需要修改配置文件/usr/lib/python2.7/site-packages/pgadmin4-web/config_distro.py，将SERVER_MODE设置为False。完成后，直接在浏览器里访问https://<你的服务器IP>:80就能登录了。
     • Debian/Ubuntu系统：可以通过apt包管理器安装，或者更简单点，直接拉取Docker镜像（docker pull dpage/pgadmin4）来运行容器。
   • 配置防火墙：别忘了开放pgAdmin的默认端口（通常是80或5050），允许远程访问，否则你连不上。
3. 备份源数据库：这是迁移前的“金科玉律”，务必执行。可以使用pg_dump命令行工具，或者在pgAdmin的图形界面里使用“备份”功能，为源数据库创建一个完整的备份文件。例如，命令行可以这样写：pg_dump -U username -h hostname -p port database_name > backup_file.sql。这一步是防止数据丢失的最后一道保险。

二、通过pgAdmin GUI执行迁移（逻辑备份法）

图形化界面操作相对直观，适合大多数场景。整个过程可以概括为“导出-传输-导入”三步曲。

1. 从源服务器导出数据库

1. 连接源服务器：打开pgAdmin，在左侧的“Servers”面板右键点击，选择“Add Server”。然后，在弹出的窗口中填写源服务器的信息：起个容易辨认的名字、主机名或IP地址、端口（默认是5432）、以及用户名和密码。点击“Sa ve”保存并建立连接。
2. 选择目标数据库：连接成功后，展开左侧的服务器树形结构，找到你需要迁移的那个数据库，右键点击它，选择“Backup”。
3. 配置导出选项：
   • 在“Filename”栏里，指定备份文件要保存的路径和文件名，比如/home/user/source_db_backup.sql。
   • “Format”格式选择“Plain”（即纯SQL格式），这是兼容性最好的选择。
   • 切换到“Options”标签页，这里可以根据需求灵活调整。比如，如果只想迁移表结构，就勾选“Only schema”；如果需要连数据一起迁移，就取消勾选。
4. 开始导出：点击“Backup”按钮，耐心等待进度条走完。最终会生成一个包含所有CREATE TABLE、INSERT等SQL语句的文件。

2. 将备份文件传输到目标服务器

文件导出后，需要把它“搬”到目标服务器上。最常用的工具就是scp（安全复制命令）。

举个例子，在命令行执行：

scp /home/user/source_db_backup.sql user@target_server_ip:/home/user/

根据提示输入目标服务器用户的密码，文件传输就开始了。

3. 向目标服务器导入数据库

1. 连接目标服务器：重复第一步的操作，不过这次是添加并连接你的目标服务器。
2. 创建目标数据库：连接成功后，在左侧树形结构中，右键点击目标服务器下的“Databases”节点，选择“Create” > “Database”。在“General”标签页里，为新数据库取个名字（例如target_db），然后点击“Sa ve”。
3. 恢复备份文件：找到刚刚创建好的目标数据库，右键点击它，选择“Restore”。在弹出窗口的“Filename”栏里，浏览并选择你刚才传输过来的备份文件（source_db_backup.sql）。格式同样选择“Plain”。在“Options”标签页，建议把“Pre-data”、“Data”、“Post-data”都勾选上，这样可以确保表结构、实际数据以及后续的索引、函数等对象都能完整恢复。最后，点击“Restore”按钮开始导入。

4. 验证数据完整性

导入完成不代表万事大吉，必须验证数据是否准确无误地“搬家”了。

1. 检查表数量：分别在源数据库和目标数据库中执行下面这条SQL，对比一下返回的表数量是否一致：

   SELECT COUNT(*) FROM information_schema.tables WHERE table_schema NOT IN ('pg_catalog', 'information_schema');

2. 抽样数据检查：数量对上了，内容也得对。挑几个关键的表（比如users用户表、orders订单表），在两边都执行一下SELECT * FROM table_name LIMIT 10;，看看前10条数据的内容是否完全一致。

三、注意事项

掌握了基本步骤，再了解几个关键注意事项，能让迁移过程更加顺畅。

• 权限问题：确保你用来连接源服务器和目标服务器的pgAdmin用户账号，拥有足够的操作权限，比如执行BACKUP（备份）、RESTORE（恢复）以及创建数据库的权限。
• 大文件处理：如果数据库很大，备份文件超过1GB，使用纯SQL格式可能会比较慢。这时，更推荐使用pg_dump命令的--format=custom选项，生成压缩的.dump格式文件，然后用pg_restore命令来恢复，速度会快很多。
• 版本差异：如果源和目标PostgreSQL版本相差较大（例如从12版迁移到15版），在导出时最好加上--column-inserts选项。这个选项会生成带有列名的INSERT语句，能更好地应对不同版本间可能的兼容性问题。
• 网络稳定性：在传输大型备份文件时，scp如果中途断连会比较麻烦。可以考虑使用rsync工具，它支持断点续传，能有效降低因网络波动导致传输失败的风险。