如何通过pgAdmin连接并迁移本地PostgreSQL至Azure托管实例

本地设备通过公网连接Azure托管PostgreSQL实例时，必须配置对应防火墙规则，没有配置的情况下连接请求会被Azure的网络层直接拦截，不存在“连不上再配”的滞后容错

• 配置路径：在Azure门户进入你的PostgreSQL实例资源页，左侧菜单找到「连接安全」板块
• 快速配置技巧：板块内有「添加当前客户端IP」按钮，点击后Azure会自动识别你当前本地网络的公网出网IP，自动生成允许该IP访问的防火墙规则，不需要手动查询IP地址填写
• 常见误区：板块内的「允许访问Azure服务」开关仅放行Azure内网资源的访问请求，不会对你的本地公网IP开放权限，不要把这个开关的作用等同于开放本地访问

pgAdmin端具体连接步骤 #

• 先从Azure的PostgreSQL实例概览页抄好两个必填信息：完整的服务器域名（格式为自定义名称.postgres.database.azure.com）、带域名后缀的管理员账号（格式为管理员名@你的服务器名，很多新手漏掉@后面的服务器后缀导致连接失败）
• 打开本地pgAdmin，首次使用需要设置pgAdmin自身的本地加密主密码（该密码仅用于pgAdmin本地存储连接凭据，和Azure PostgreSQL的实例密码无关）
• 在左侧服务器导航栏右键选择「创建」->「服务器」，按要求填配置：
  • 常规标签页：自定义一个好识别的服务器名称，不影响实际连接逻辑
  • 连接标签页：主机栏填之前抄的完整Azure服务器域名，端口留默认5432（如果部署时改过端口就填对应值），维护数据库选默认的postgres，用户名填带后缀的完整管理员账号，密码填实例创建时设置的管理员密码，可勾选保存密码减少重复输入
  • SSL标签页：将SSL要求设置为「require」——Azure PostgreSQL默认强制开启SSL加密连接，不配SSL会直接握手失败
• 保存配置后pgAdmin会自动触发连接检测，连接成功即可在导航栏看到对应服务器的库列表

Azure官方提供了零复杂命令的迁移服务，不需要手动编写pg_dump、pg_restore类的长命令脚本，对新手友好

最简化迁移路径：使用Azure Database Migration Service(DMS) #

• 该服务是Azure官方推出的数据库迁移专用工具，针对小型数据库（10GB以内规模）可直接使用免费层SKU完成迁移，不需要额外付费
• 操作流程：
  • 在Azure门户全局搜索「Azure Database Migration Service」，按照提示创建迁移服务实例，建议和你的PostgreSQL实例选择同一个Azure区域，减少网络传输延迟
  • 当你的本地PostgreSQL库没有公网暴露入口时，可按照向导提示安装DMS配套的本地集成运行时，工具会自动打通本地库到DMS的安全加密通道，不需要你手动开放本地网络的公网端口，安全性有保障
  • 按照迁移任务向导配置：源端选本地PostgreSQL连接信息，目标端选已部署好的Azure PostgreSQL实例，勾选需要迁移的schema、表、视图、存储过程等全部对象，即可一键启动迁移。DMS会自动处理schema语法适配、数据一致性校验、约束重建等操作，不需要手动干预

超小型库的轻量迁移方案（无需创建DMS实例） #

如果你的本地数据库规模在1GB以内，可直接用pgAdmin完成全GUI迁移，连额外服务都不用开：

• 在pgAdmin中连接本地PostgreSQL，选中需要迁移的目标数据库，右键选择「备份」，备份格式选「自定义」，选择本地存储路径后导出生成.dump格式的备份文件
• 切回pgAdmin中已连通的Azure PostgreSQL实例，先在实例下创建一个和本地库同名的空数据库，选中该空库右键选择「恢复」，选择之前导出的.dump文件即可启动导入
• 两个避坑提示：
  • 迁移前提前在Azure PostgreSQL的「服务器参数」页，开启你本地库用到的扩展（比如uuid-ossp、postgis等），否则导入时会报扩展不存在的错误
  • 恢复时可勾选「预先删除不存在的对象」选项，避免空库的默认残留对象和导入对象产生冲突

内容的提问来源于stack exchange，提问作者JohnB