9.3 9.4 9.5 9.6 10 11 12 13 14 15
阿里云PostgreSQL 问题报告 纠错本页面

19.6. 升级一个PostgreSQL集簇

19.6.1. 通过pg_dumpall升级数据
19.6.2. 通过pg_upgrade升级数据
19.6.3. 通过复制升级数据

本节讨论如何把你的数据库数据从一个PostgreSQL发行升级到一个更新的发行。

当前PostgreSQL版本号由主要版本号和次要版本号组成。 例如,在版本号10.1中,10是主要版本号,1是次要版本号,这意味着这将是主版本10的第一个次要版本。 对于PostgreSQL版本10.0之前的版本,版本号由三个数字组成,例如9.5.3。 在这些情况下,主要版本由版本号的前两个数字组(例如9.5)组成,次要版本是第三个数字, 例如3,这意味着这将是主要版本9.5的第三次要版本。

次要发行从来不改变内部存储格式并且总是向前并向后兼容同一主版本号中的次要发行。 例如版本10.1与版本10.0和版本10.6兼容。类似的,例如9.5.3与9.5.0、9.5.1和9.5.6兼容。 要在兼容的版本间升级,你只需要简单地在服务器关闭时替换可执行文件并重启服务器。 数据目录则保持不变 — 次要升级就这么简单。

对于主要版本的PostgreSQL,内部数据存储格式可能会发生变化,从而使升级变得复杂。 将数据移动到新的主要版本的传统方法是转储和恢复数据库,尽管这可能很慢。 更快的方法是pg_upgrade。还可以使用复制方法,如下所述。 (如果您使用的是PostgreSQL的预打包版本,它可能提供脚本来帮助进行主要版本升级。 请查阅包级文档以获取详细信息。)

新的主版本也通常会引入一些用户可见的不兼容性,因此可能需要应用程序编程上的改变。 所有用户可见的更改都被列在发行注记(附录 E)中,请特别注意标有 "Migration" 的小节。 尽管你可能从一个主版本升级到另一个,而不用升级中间版本,你应该阅读全部中间版本的主要发行说明。

小心的用户在完全切换过去之前将希望在新版本上测试他们的客户端应用。因此,建立一个新旧版本的并存安装通常是一个好主意。在测试一个PostgreSQL主要升级时,考虑下列可能的改变类别:

管理

用于管理员监控和控制服务器的功能在每一个主发行中经常会改变和增加。

SQL

通常这包括新的 SQL 命令功能并且在行为上没有更改,除非在发行注记中有特别提到。

库 API

通常libpq等库值增加新功能,除非在发行注记中有特别提到。

系统目录

系统目录改变通常只影响数据库管理工具。

服务器 C-语言 API

这涉及到后端函数 API 中的改变,它使用 C 编程语言编写。这些改变影响引用服务器内部后端函数的代码。

19.6.1. 通过pg_dumpall升级数据

一种升级方法是从一个主要版本的PostgreSQL中导出数据, 然后在另一个版本中恢复 — 要做到这一点,您必须使用逻辑备份工具, 如pg_dumpall; 文件系统级备份方法将不起作用。 (有检查措施阻止您在不兼容版本的PostgreSQL上使用数据目录, 因此尝试在数据目录上启动错误的服务器版本不会造成太大损害。)

建议您使用pg_dumppg_dumpall程序来自更新版本的PostgreSQL,以利用这些程序可能进行的增强。当前版本的转储程序可以读取从9.2版本开始的任何服务器版本的数据。

这些指令假定你现有的安装位于/usr/local/pgsql目录,并且数据区域在/usr/local/pgsql/data。请用你的路径进行适当的替换。

  1. 如果在创建一个备份,确认你的数据库没有在被更新。这不会影响备份的完整性,但是那些更改当然不会被包括在备份中。如果必要,编辑/usr/local/pgsql/data/pg_hba.conf文件中的权限(或等效的方法)来不允许除你之外的任何人使用数据库。关于访问控制的额外信息请见第 21 章

    要备份你的数据库安装,键入:

    pg_dumpall > outputfile
    

    要制作备份,你可以使用你正在运行版本的pg_dumpall命令,详见第 26.1.2 节。但是,要得到最好的结果,试试使用PostgreSQL 15.7 的pg_dumpall命令,因为这个版本包含了对旧版本的缺陷修复和改进。虽然这个建议可能看起来很奇怪,因为你还没有安装新版本,但如果你计划平行地安装新版本,遵循这个建议是很明智的。在这种情况下,你可以正常完成安装并且稍后再来传输数据。这也将减少停机时间。

  2. 关闭旧服务器:

    pg_ctl stop
    

    在那些自动启动PostgreSQL的系统上,可能有一个启动文件将完成同样的事情。例如,在一个Red Hat Linux系统中,我们会发现这也能用:

    /etc/rc.d/init.d/postgresql stop
    

    关于启动和停止服务器的细节请见第 19 章

  3. 如果从备份恢复,重命名或删除旧的安装目录(如果它不是针对特定版本的)。重命名该目录是一个好主意,而不是删除它,因为如果你碰到问题并需要返回到它,它还存在。记住该目录可能消耗可观的磁盘空间。要重命名该目录,使用类似的命令:

    mv /usr/local/pgsql /usr/local/pgsql.old
    

    (注意将该目录作为一个单一单元移动,这样相对路径可以保持不变)。

  4. 安装新版本的PostgreSQL第 17.4 节

  5. 如果需要,创建一个新的数据库集簇。记住你必须在登录到一个特殊的数据库用户账户(如果你在升级,你就已经有了这个账户)时执行这些命令。

    /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data
    

  6. 恢复你之前的pg_hba.conf以及任何postgresql.conf修改。

  7. 启动数据库服务器,也要使用特殊的数据库用户账户:

    /usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data
    

  8. 最后,使用新的 psql从备份恢复你的数据:

    /usr/local/pgsql/bin/psql -d postgres -f outputfile
    

    使用 new psql.

通过在一个不同的目录中安装新的服务器并且并行地在不同的端口运行新旧两个服务器可以达到最低的停机时间。那么你可以这样用:

pg_dumpall -p 5432 | psql -d postgres -p 5433

来转移你的数据。

19.6.2. 通过pg_upgrade升级数据

pg_upgrade模块允许一个安装从一个 PostgreSQL主版本“就地”升级成另一个主版本。 升级可以在数分钟内被执行,特别是使用--link模式时。它 要求和上面的pg_dumpall相似的步骤,例如启动/停止 服务器、运行initdbpg_upgrade 文档概述了所需的步骤。

19.6.3. 通过复制升级数据

也可以用PostgreSQL的已更新版本逻辑复制来创建一个后备服务器,逻辑复制支持在不同主版本的PostgreSQL之间的复制。 后备服务器可以在同一台计算机或者不同的计算机上。 一旦它和主服务器(运行旧版本的PostgreSQL)同步好,你可以切换主机并且将后备服务器作为主机,然后关闭旧的数据库实例。 这样一种切换使得一次升级的停机时间只有数秒。

这种升级方法可以用内置的逻辑复制工具和外部的逻辑复制系统如pglogicalSlonyLondiste,和Bucardo