今天遇到了server2016下需要将原先的PostgreSQL9.5版本升级到10.X版本的问题。PG官方文档和网上都有相关教程,但是在升级的过程中还是遇到了一些问题,好在最后东拼西凑解决掉了。可能对于老用户来说很多都是常识性的问题,但是对于我这种第一次接触pg的小白白来说,在这里把踩过的坑总结一下吧。
Windows下PGSQL的升级步骤
这里说的升级,指的是PG的跨版本升级,比如说9.4->9.5,9.5->10.x,10.x->12.x这种。因为PG在10.x之前是小版本号,比如9.4,9.5这种,到了10开始,改为了10、11、12这种大版本号的形式。所以才会存在9.4->9.5这种跨版本升级的需求?
对于同一版本的内部版本升级,貌似可以直接通过覆盖安装的形式进行即可。也就是说你当前安装的10.2需要更新到10.12的话,直接下载10.12的安装包运行安装,这时候pg会检测到你已经安装了并提示是不是升级安装。所以这里文章讨论的就是跨版本升级的情形。
升级前的准备步骤
- 首先下载需要升级到的版本的windows安装包啦
- 然后运行安装程序,将新版本的PG安装到某个目录下,注意:data目录不要指定为之前版本的data目录,直接默认或者选择一个新的目录即可(默认是在pg根目录的data下面)
- 安装过程中如果出现安装失败,多半是因为选择安装的时候有个区域选择(之前一直选择chinese simplified导致安装pgserver失败,后来选择default即可安装成功,至于原因我也没去深究)
- 配置端口,这里可以选择默认的5432,也可以修改一个(如果需要两个版本共存的话,因为pg_upgrade升级的过程中需要把old和new两个版本的服务都以另外的端重新启动,所以在这里配置相同的端口也是可以的,即使不配置相同,后续升级后也可以修改)
- 配置
%APPDATA%/postgresql/pgpass.conf
文件,这里的目的一个是为了可以本机实现免密登录pg,另外在升级的过程中无需提供密码 - 在
pgpass.conf
文件中加入你旧的数据库的登录账号信息,例如:localhost:5432:*:postgres:postgres
。格式大概就是host:port:database:user:password
,支持通配符*
- 到旧版本pg目录下的
data/pg_hba.conf
中,在最下方加入一条host all all all trust
(给与最大权限,当然这是有一定安全隐患的,也可以根据需要进行自定义配置,但是最后的md5验证模式改为trust模式,这样不需要验证),记得在升级过后删除或改回原来的模式哦!
开始升级
这里可以按照官方文档pg_upgrade相关介绍进行操作,这里就不再详细赘述了。只是说几个常见的问题和注意事项:
- 关于上图官方文档中说的通过postgres用户启动SHELL,因为windows下没有建立postgres用户,所以这段可以省略,不用去执行的。只需要以管理员身份启动SHELL,在运行pg_upgrade的时候通过
-U username
来指定运行用户名为postgres即可 - pg_upgrade命令后面加入-U postgres可以指定pg_upgrade通过哪个user连接数据库(当然要指定一个最大权限的用户,默认就是postgres),并且因为已经在
pgpass.conf
中配置了该用户的密码(默认也会是postgres或者你安装的时候设置的那个),所以运行过程中才不会报错没有提供密码啊或者没有administrator用户啊之类的错误:connection to database failed: 致命错误: 角色 "Administrator" 不存在 could not connect to source postmaster started with the command:xxxxx
- 如果在升级时报错:
*failure* Consult the last few lines of "pg_upgrade_server_start.log" or "pg_upgrade_server.log" for the probable cause of the failure.connection to database failed: 无法联接到服务器: Connection refused (0x0000274D/10061)
,多半是因为pg_hba
中没有配置造成的,可以将md5
改为trust
再试 - 如果运行中提示没有权限写入xxx.log,则多半是由于shell当前的目录权限问题,可以
CD ..
跳到上级目录或其他目录下,然后通过路径xxx/postgres/10/bin/pg_upgrade.exe
运行。或者跟随官方提示加入环境变量中。 - 升级结束后,SHEEL会提示升级后的操作(会生成两个bat脚本,请根据提示运行脚本),做迁移后的处理