本文介绍通过pg_dumpall、pg_dump和pg_restore命令将自建PostgreSQL数据库迁移至PolarDB PostgreSQL版中。
迁移的源库为RDS for PostgreSQL实例时，请参考从RDS PostgreSQL迁移至PolarDB PostgreSQL版。
前提条件
PolarDB PostgreSQL版实例的存储空间应大于自建PostgreSQL数据库的存储空间。
注意事项
该操作为全量数据迁移。为避免迁移前后数据不一致，迁移操作开始前请停止自建数据库的相关业务，并停止数据写入。
准备工作
创建一个Linux操作系统的ECS实例，本案例使用的ECS为Ubuntu 16.04 64位操作系统。详情请参考创建ECS实例。
说明要求ECS实例和迁移的目标PolarDB PostgreSQL版实例处于同一个专有网络。
可创建一个按量付费的ECS实例，迁移完成后释放实例。
在ECS实例中安装PostgreSQL，以便执行数据恢复的命令。详情请参考PostgreSQL官方文档。
说明请确保安装的PostgreSQL数据库版本与自建PostgreSQL数据库版本一致。
操作步骤一 备份自建数据库
该操作为全量数据迁移。为避免迁移前后数据不一致，迁移操作开始前请停止自建数据库的相关业务，并停止数据写入。
在自建PostgreSQL数据库服务器上执行以下命令，备份数据库中的所有角色信息。
pg_dumpall -U <username> -h <hostname> -p <port> -r -f <filename>参数说明：
<username>：登录自建PostgreSQL数据库的账号。
<hostname>：自建PostgreSQL数据库的连接地址，本机可使用localhost。
<port>：数据库服务的端口号。
<filename>：生成的备份文件名称。
示例：
pg_dumpall -U postgres -h localhost -p 5432 -r -f roleinfo.sql命令行提示
Password:时，输入数据库账号对应的密码，开始备份数据库中的所有角色信息。使用
vim命令将角色信息备份文件中的SUPERUSER替换为polar_superuser。说明如果角色信息备份文件中没有
SUPERUSER信息，可跳过本步骤。
在自建PostgreSQL数据库服务器上执行以下命令，备份数据库中的数据。
pg_dump -U <username> -h <hostname> -p <port> <dbname> -Fd -j <njobs> -f <dumpdir>参数说明：
<username>：登录自建PostgreSQL数据库的账号。
<hostname>：自建PostgreSQL数据库的连接地址，本机可使用localhost。
<port>：数据库服务的端口号。
<dbname>：要备份的数据库名。
<njobs>：同时执行备份作业的并发数。
说明参数<njobs>可减少转储的时间，但也会增加数据库服务器的负载。
如果您的自建PostgreSQL数据库是9.2以前的版本，您还需要指定
--no-synchronized-snapshots参数。
<dumpdir>：生成的备份文件所属目录。
示例：
pg_dump -U postgres -h localhost -p 5432 mytestdata -Fd -j 5 -f postgresdump命令行提示
Password:时，输入数据库账号对应的密码，数据库开始备份。等待备份完成，PostgreSQL数据库数据将备份至指定的目录中，本案例为postgresdump。
操作步骤二 数据迁移至PolarDB PostgreSQL版
将备份文件所属的目录上传至ECS实例中。
说明包含角色信息备份文件和数据库备份文件。
在ECS上执行以下命令，将角色信息备份文件中的角色信息迁移至PolarDB PostgreSQL版实例中。
psql -U <username> -h <hostname> -p <port> -d <dbname> -f <filename>参数说明：
<username>：登录PolarDB PostgreSQL版数据库的账号。
<hostname>：PolarDB PostgreSQL版实例的主地址（私网）。
<port>：数据库服务的端口号，请参考查看连接地址和端口。
<dbname>：连接的数据库的名称。
<filename>：角色信息备份文件名。
psql -U gctest -h pc-xxxxxxxx.pg.polardb.cn-qd-pldb1.rds.aliyuncs.com -d testdb -p 1921 -f roleinfo.sql命令行提示
Password:时，输入数据库账号对应的密码，角色信息开始导入。在ECS上执行以下命令，将数据库数据恢复至PolarDB PostgreSQL版实例中。
pg_restore -U <username> -h <hostname> -p <port> -d <dbname> -j <njobs> <dumpdir>参数说明：
<username>：登录PolarDB PostgreSQL版数据库的账号。
<hostname>：PolarDB PostgreSQL版实例的主地址（私网），详情请参考查看或申请连接地址。
<port>：数据库服务的端口号，请参考查看连接地址和端口。
<dbname>：连接并直接恢复到的目标数据库名。
说明目标数据库需已存在，如不存在请在目标实例中创建该数据库。
<njobs>：同时执行数据恢复作业的并发数。
说明此选项可减少数据恢复的时间，但也会增加数据库服务器的负载。
<dumpdir>：备份文件所在目录。
示例：
pg_restore -U gctest -h pc-mxxxxxxxx.pg.polardb.cn-qd-pldb1.rds.aliyuncs.com -p 1921 -d mytestdata -j 6 postgresdump命令行提示
Password:时，输入数据库账号对应的密码，数据开始迁移。说明如果忘记密码，请参考修改密码。
等待数据迁移完成即可。