使用转储和还原升级 PostgreSQL 数据库

适用于： Azure Database for PostgreSQL - 单一服务器

通过使用以下方法将数据库迁移到更高的主版本服务器，可以升级部署在 Azure Database for PostgreSQL 中的 PostgreSQL 服务器。

• 使用 PostgreSQL pg_dump 和 pg_restore 的脱机方法，这种方法会导致迁移数据时停机。 本文档介绍这种升级/迁移方法。
• 使用数据库迁移服务 (DMS) 的联机方法。 这种方法减少了迁移时的停机时间，使目标数据库与源保持同步，并且你可以选择何时进行直接转换。 但是，使用 DMS 需要满足一些先决条件和限制。 有关详细信息，请参阅 DMS 文档。
• 使用 Azure Database for PostgreSQL - 灵活服务器的就地主版本升级方法。就地主版本升级功能只需单击一下即可执行服务器的主版本升级。 这简化了升级过程，最大限度地减少了访问服务器的用户和应用程序遇到中断的次数。 就地升级是更简单的实例主版本升级方法，因为它会在升级后保留服务器名称和当前服务器的其他设置，并且不需要数据迁移或更改应用程序连接字符串。 与数据迁移相比，就地升级速度更快，故障时间更短。

下表根据数据库大小和方案提供了一些建议。

本指南提供了一些脱机迁移方法和示例，说明如何从源服务器迁移到运行更高版本 PostgreSQL 的目标服务器。

将转储和还原与 Azure Database for PostgreSQL 配合使用的先决条件

若要逐步执行本操作指南，你需要：

• 一个运行要升级的较低版本引擎的源 PostgreSQL 数据库服务器。
• 一个具有所需主版本 Azure Database for PostgreSQL 服务器单一服务器或 Azure Database for PostgreSQL 灵活服务器的目标 PostgreSQL 数据库服务器。
• PostgreSQL 客户端系统，用于运行转储和还原命令。 建议使用较高的数据库版本。 例如，如果从 PostgreSQL 版本 9.6 升级到 11，请使用 PostgreSQL 版本 11 客户端。
  • 它可以是安装了 PostgreSQL 以及 pg_dump 和 pg_restore 命令行实用工具的 Linux 或 Windows 客户端。
• PostgreSQL 客户端最好在与源服务器和目标服务器相同的区域中运行。

其他详细信息和注意事项

• 可以通过从门户中选择“连接字符串”来查找源数据库和目标数据库的连接字符串。
• 你可能正在服务器中运行多个数据库。 可以通过连接到源服务器并运行 \l 来查找数据库列表。
• 在目标数据库服务器中创建相应的数据库，或者在用于创建数据库的 pg_dump 命令中添加 -C 选项。
• 不得升级 azure_maintenance 或模板数据库。 如果对模板数据库做了任何更改，可以选择迁移这些更改，或者在目标数据库中做出这些更改。
• 请参阅上面的表，确定数据库是否适合这种迁移模式。
• 如果要使用 Azure CLI，请注意会话会在 20 分钟后超时。 如果数据库大小 < 10 GB，则也许可以在会话不超时的情况下完成升级。否则，可能必须通过其他方法（例如每隔 10-15 分钟按任意键）使会话保持打开状态。

本指南中使用的示例数据库

本指南使用以下源服务器和目标服务器以及数据库名称进行举例说明。

使用脱机迁移方法升级数据库

可以选择使用此部分中所述的方法之一进行升级。 执行任务时，可以使用以下提示。

• 如果对源数据库和目标数据库使用相同的密码，则可以设置 PGPASSWORD=yourPassword 环境变量。 这样就不必在每次运行命令（如 psql、pg_dump 和 pg_restore）时都提供密码。 同样，也可以设置 PGUSER、PGSSLMODE 等其他变量。请参阅 PostgreSQL 环境变量。

• 如果 PostgreSQL 服务器需要 TLS/SSL 连接（默认情况下在 Azure Database for PostgreSQL 服务器中启用），请设置环境变量 PGSSLMODE=require，以便 pg_restore 工具使用 TLS 进行连接。 如果不使用 TLS，错误可能会显示为 FATAL: SSL connection is required. Please specify SSL options and retry.

• 在 Windows 命令行中，在运行 pg_restore 命令之前运行命令 SET PGSSLMODE=require。 在 Linux 或 Bash 中，在运行 pg_restore 命令之前运行命令 export PGSSLMODE=require。

迁移角色

角色（用户）是全局对象，需要在还原数据库之前单独迁移到新群集。 可以结合 -r (--roles-only) 选项使用 pg_dumpall 二进制文件来转储角色。 在使用密码的情况下，从源单一服务器转储所有角色：

pg_dumpall -r --host=mySourceServer --port=5432 --username=myUser@mySourceServer --database=mySourceDB > roles.sql

在不使用密码的情况下，从源灵活服务器转储所有角色名称：

pg_dumpall -r --no-role-passwords --host=mySourceServer --port=5432 --username=myUser --database=mySourceDB > roles.sql

在目标服务器中使用 psql 还原内容之前，编辑 roles.sql 并删除 NOSUPERUSER 和 NOBYPASSRLS 的引用：

psql -f roles.sql --host=myTargetServer --port=5432 --username=myUser --dbname=postgres

请不要料想转储脚本可以从头到尾正常运行而不出错。 特别是，由于脚本将为源群集中现有的每个角色颁发“CREATE ROLE”，因此像 azure_pg_admin 或 azure_superuser 这样的启动超级用户肯定会收到“角色已存在”错误。 此错误是无害的，可将其忽略。 使用 --clean 选项有可能会生成有关对象不存在的其他无害错误消息，不过，可以通过添加 --if-exists 来最大程度地减少此类错误消息。

方法 1：使用 pg_dump 和 psql

此方法涉及两个步骤。 第一个步骤是使用 pg_dump 从源服务器转储某个 SQL 文件。 第二个步骤是使用 psql 将该文件导入到目标服务器。 有关详细信息，请参阅使用导出和导入进行迁移文档。

方法 2：使用 pg_dump 和 pg_restore

此升级方法首先使用 pg_dump 从源服务器创建转储。 然后使用 pg_restore 将该转储文件还原到目标服务器。 有关详细信息，请参阅使用转储和还原进行迁移文档。

方法 3：将转储数据流式传输到目标数据库

数据库转储直接流式传输到目标数据库服务器，不将转储存储在客户端中。 因此，这种方法可用于存储空间有限的客户端。

1. 使用 \l 命令确保目标服务器中存在数据库。 如果数据库不存在，请创建数据库。

    psql "host=myTargetServer port=5432 dbname=postgres user=myUser password=###### sslmode=mySSLmode"
   

   postgres> \l   
   postgres> create database myTargetDB;
   

2. 使用管道将转储和还原作为单个命令行运行。

   pg_dump -Fc --host=mySourceServer --port=5432 --username=myUser --dbname=mySourceDB | pg_restore  --no-owner --host=myTargetServer --port=5432 --username=myUser --dbname=myTargetDB
   

   例如，应用于对象的

   pg_dump -Fc --host=pg-95.postgres.database.chinacloudapi.cn --port=5432 --username=pg@pg-95 --dbname=bench5gb | pg_restore --no-owner --host=pg-11.postgres.database.chinacloudapi.cn --port=5432 --username=pg@pg-11 --dbname=bench5gb
   

3. 升级（迁移）过程完成后，即可使用目标服务器测试应用程序。

4. 对服务器内的所有数据库重复此过程。

例如，下表说明了使用流式传输转储方法进行迁移所需的时间。 系统使用 pgbench 填充示例数据。 与 pgbench 生成的表和索引相比，你的数据库可能具有不同数量的对象且大小各异，因此强烈建议测试数据库的转储和还原，以了解升级数据库所需的实际时间。

方法 4：使用并行转储和还原

如果数据库中有几个较大的表，你想对该数据库并行执行转储和还原过程，则可以考虑使用此方法。 客户端系统还需要有足够的存储空间来容纳备份转储。 此并行转储和还原过程减少了完成整个迁移所需的时间。 例如，使用方法 1 和 2 完成 50 GB pgbench 数据库的迁移需要 1-1.5 个小时，而使用此方法所需的时间不到 30 分钟。

1. 对于源服务器中的每个数据库，在目标服务器上创建一个对应的数据库。

   psql "host=myTargetServer port=5432 dbname=postgres user=myuser password=###### sslmode=mySSLmode"
   

   postgres> create database myDB;
   

   例如，应用于对象的

   psql "host=pg-11.postgres.database.chinacloudapi.cn port=5432 dbname=postgres user=pg@pg-11 password=###### sslmode=require"
   psql (12.3 (Ubuntu 12.3-1.pgdg18.04+1), server 13.3)
   SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
   Type "help" for help.
   
   postgres> create database bench5gb;
   postgres> \q
   

2. 以目录格式运行 pg_dump 命令，其中作业数 = 4（数据库中的表数）。 对于更大的计算层和更多的表，可以将其增加到更大的数目。 该 pg_dump 将创建一个目录，用于存储每个作业的压缩文件。

   pg_dump -Fd -v --host=sourceServer --port=5432 --username=myUser --dbname=mySourceDB -j 4 -f myDumpDirectory
   

   例如，应用于对象的

   pg_dump -Fd -v --host=pg-95.postgres.database.chinacloudapi.cn --port=5432 --username=pg@pg-95 --dbname=bench5gb -j 4 -f dump.dir
   

3. 然后在目标服务器上还原备份。

   $ pg_restore -v --no-owner --host=myTargetServer --port=5432 --username=myUser --dbname=myTargetDB -j 4 myDumpDir
   

   例如，应用于对象的

   $ pg_restore -v --no-owner --host=pg-11.postgres.database.chinacloudapi.cn --port=5432 --username=pg@pg-11 --dbname=bench5gb -j 4 dump.dir
   

升级/迁移后

主版本升级完成后，建议在每个数据库中运行 ANALYZE 命令以刷新 pg_statistic 表。 否则，可能会遇到性能问题。

postgres=> analyze;
ANALYZE

后续步骤

• 对目标数据库功能满意后，可以删除旧的数据库服务器。
• 仅限 Azure Database for PostgreSQL 单一服务器。 如果要使用与源服务器相同的数据库终结点，则在删除旧的源数据库服务器后，可以使用旧的数据库服务器名称创建只读副本。 建立稳定复制状态后，可以停止副本，这会将副本服务器提升为独立服务器。 有关更多详细信息，请参阅复制。