PostgreSQLのメジャーバージョンアップグレード

PostgreSQLのアップグレード

PostgreSQL自体のアップグレードは、postgresqlを単に更新すればよい。

$ sudo pacman -Syu

アップグレードしたとき、データの更新が必要な場合はログにメッセージが出力される。

データのアップグレード

PostgreSQLのデータは/var/lib/postgres/data/PG_VERSIONにバージョン情報を持っている。 コマンドのバージョンが上がったとき、pg_upgradeでデータのバージョンも更新する必要がある。

このとき、pg_upgradeは古いバージョンのコマンドも要求するが、 Arch Linuxのpostgresqlパッケージは古いバージョンを持っていない。 そのためpostgresql-old-upgradeをインストールする。

$ sudo pacman -S postgresql-old-upgrade

次に、データ変換のための準備をする。 前バージョンの/var/lib/postgresql/dataをリネームして、新しいdataにコピーする形になる。 新しいバージョンと以前のバージョンを両方実行してレプリケーションをしているらしいが、 詳細までは追っていない。

$ cd /var/lib/postgres
$ sudo mv data olddata
$ sudo mkdir data tmp
$ sudo chown postgres:postgres data tmp

新しいバージョンのデータを初期化して、pg_upgradeを実行する。

$ sudo -u postgres -i
$ cd /var/lib/postgres/tmp
postgres$ initdb -D /var/lib/postgres/data [--locale=C]  [--encoding=UTF8] [-U lufia] [--data-checksums]
postgres$ pg_upgrade -b /opt/pgsql-14/bin -B /usr/bin -d /var/lib/postgres/olddata -D /var/lib/postgres/data [-U lufia]

このとき、古いバージョンのデータとオプションを揃えておく。 例えば--data-checksumsオプションが無効になっているデータから、 オプションを有効にしたデータへ移行しようとするとpg_upgradeで以下のようなエラーが発生する。

postgres$ pg_upgrade -b /opt/pgsql-14/bin -B /usr/bin -d /var/lib/postgres/olddata -D /var/lib/postgres/data
Performing Consistency Checks
-----------------------------
Checking cluster versions                                   ok

old cluster does not use data checksums but the new one does
Failure, exiting

または、データベースのスーパーユーザーが異なる場合は以下のようなエラーになる。

postgres$ pg_upgrade -b /opt/pgsql-14/bin -B /usr/bin -d /var/lib/postgres/olddata -D /var/lib/postgres/data
Performing Consistency Checks
-----------------------------
Checking cluster versions                                   ok

connection to server on socket "/var/lib/postgres/tmp/.s.PGSQL.50432" failed: FATAL:  role "postgres" does not exist

後始末

これで一通り移行が終わったのでサービスを起動する。ついでに掃除もしておく。

$ sudo systemctl start postgresql.service
$ sudo rm -rf /var/lib/postgresql/{olddata,tmp}
postgres$ vacuumdb --all --analyze-in-stages [-U lufia]

チェックサムを有効化したい場合

一般的にはinitdbのオプションでチェックサムを有効化するが、 チェックサムが無効な既存のデータベースで有効にしたい場合もある。 この場合、PostgreSQLがサービス停止中に限定されるがpg_checksumsコマンドで対応できる。

チェックサムが無効な状態で-c (--check)を実行するとエラーになる。

$ sudo -u postgres pg_checksums -D /var/lib/postgres/data -c
pg_checksums: error: data checksums are not enabled in cluster

有効にするときは-e (--enable)オプションを与える。

$ sudo -u postgres pg_checksums -D /var/lib/postgres/data -e -P
84/84 MB (100%) computed
Checksum operation completed
Files scanned:   4011
Blocks scanned:  10758
Files written:  0
Blocks written: 0
pg_checksums: syncing data directory
pg_checksums: updating control file
Checksums enabled in cluster

これで、再度-c (--check)するとチェックサムが有効になっている様子を確認できる。

$ sudo -u postgres pg_checksums -D /var/lib/postgres/data -c
Checksum operation completed
Files scanned:   4011
Blocks scanned:  10758
Bad checksums:  0
Data checksum version: 1