確認すべき拡張機能および論理レプリケーションオブジェクト

アップグレードの前に、以下の項目を確認してください：

拡張機能

• pg_repack
• old_snapshot
• wal2json
• anon
• PostGIS

レプリケーションスロット

• Logical replication slots

アプリケーションの依存関係 アプリケーションが依存している拡張機能やレプリケーションオブジェクトを削除する場合は、アップグレードを進める前に、データフローとアプリケーションの動作を確認してください。 また、 PostgreSQL の特定の機能に依存しているアプリケーションロジックに、不具合が生じる可能性についても考慮してください。

pg_repack

アップグレードの前に pg_repack を削除し、アップグレード後に再作成してください。 pg_repack はバージョン固有の拡張子を使用しており、クライアントおよびサーバーコンポーネントは PostgreSQL のメジャーバージョンと一致している必要があります。

DROP EXTENSION pg_repack;

アップグレード後に、ワークロードで引き続きその拡張機能が必要な場合にのみ、拡張機能を再作成してください。

CREATE EXTENSION pg_repack;

old_snapshot

アップグレードの前に、 old_snapshot を削除してください。 PostgreSQL 18へのアップグレード後は、サポート対象外となるため、これを再作成しないでください。

DROP EXTENSION old_snapshot;

wal2json レプリケーションスロット

wal2json を論理デコードに使用している場合は、アップグレードの前に、関連するすべてのレプリケーションスロットを削除する必要があります。 pg_upgrade ユーティリティは、レプリケーションスロットが存在している間はメジャーバージョンのアップグレードを厳格に禁止しており、重大なエラーを発生させてアップグレードを中止します。

アップグレードの前：

1. 保留中のWALデータがすべて処理済みであることを確認してください。
2. レプリケーションスロットを使用しているアプリケーションを停止してください。
3. レプリケーションスロットを削除します：

SELECT pg_drop_replication_slot('your_slot_name');

アップグレード後、必要に応じてレプリケーションスロットを再作成できます。 なお、 wal2json は CREATE EXTENSION 経由でインストールされるものではなく、データベースパラメータ（wal_level、 max_replication_slots、 max_wal_senders ）およびテーブルの権限を通じて設定されるため、アップグレードの妨げにはなりません。

anon

アップグレードの前に「 anon 」拡張機能を無効にし、アップグレード後も引き続き必要であれば、再度有効にしてください。 anon を削除する前に、追加の手順が必要です。

「 anon 」拡張機能がインストールされている場合は、アップグレードを実行する前に、以下の手順に従い、管理者ユーザーとしてコマンドを実行してください。

1. （有効になっている場合は）すべてのマスキングルールを削除します。

   SELECT anon.remove_masks_for_all_columns();
   

2. ロールの非表示設定を無効にしてください（ロールに「非表示」のマークが付いていると、アップグレードに失敗する可能性があります）。

   SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
   

3. 「 anon 」拡張子に「cascade」オプションを付けて指定します。

   DROP EXTENSION anon CASCADE;
   

4. anon 拡張機能がインスタンス内の複数のデータベースにインストールされている場合は、各データベースについて、以下に示す手順に従ってください。

5. アップグレードが完了したら、 anon 拡張機能を再度有効にし、必要に応じてマスキングルールを再適用してください。

アップグレードを実行する前に、拡張機能を削除する前と後の両方でデータを検証し、マスキングの一貫性を確認することを強く推奨します。

PostGIS

PostGIS, をご利用の場合は、 PostgreSQL をアップグレードする前に、まず PostGIS をアップグレードしてください。

SELECT postgis_extensions_upgrade();

PostGIS 拡張機能のアップグレードを確認するには、次のクエリを使用してください。

SELECT postgis_full_version();

Logical replication slots

アップグレードの前に、すべての論理レプリケーションスロットを削除し、アップグレード後にそれらを再作成してください。 論理スロットはソースサーバーの状態に紐づいているため、アップグレード後のインスタンス上でクリーンな状態で再作成する必要があります。

SELECT pg_drop_replication_slot('<slot_name>');

論理レプリケーションスロット

アップグレードの前に、すべての論理レプリケーションスロットを削除し、アップグレード後にそれらを再作成してください。 論理レプリケーションスロットはソースサーバーの状態に紐づいているため、アップグレード後のインスタンス上で再作成する必要があります。

SELECT pg_drop_replication_slot('<slot_name>');

開始前に

アップグレードを開始する前に、以下の点を確認してください：

• UI、API、CLI、またはTerraformを使用して、お使いのデプロイメントでバージョンアップグレードがサポートされていることを確認してください。

  例（CLI）：

  ibmcloud cdb capability-show versions postgresql
  

• 事前確認の要件を確認してください。 このアップグレードはソース環境でのデプロイ時に実行され、 リスクが検出された場合はブロックされます。 以下のことを確認します。

  • デプロイは正常です
  • 少なくとも10％の空きディスク容量があること
  • I/O使用率は90%未満です
  • スキーマのサイズおよびオブジェクト数は、サポートされている制限範囲内です
  • 必要な拡張および論理レプリケーションスロットのクリーンアップが完了しました

• アプリケーションに影響を与える可能性のある互換性の変更点については、「 https://www.postgresql.org/docs/release/ 」を確認してください。

• 以前のバージョンへのダウングレードはサポートされていません。

• インプレースアップグレードは、開始後はキャンセルできません。

• アップグレードを行う前に、最新のバックアップが利用可能であることを確認してください。

Gen2 PostgreSQL 18から始まる。 新しいバージョンへのアップグレード手順は、サポートが開始され次第追加されます。 以前のバージョン（14～17）については、/docs/databases-for-postgresql?topic=databases-for-postgresql-upgrading を参照してください。

アップグレードが完了すると、デプロイメントでは新しい PostgreSQL メジャーバージョンが実行されます。 アップグレード前のバックアップおよびPITRポイントは、以前のバージョンのタイムラインに属しており、アップグレード後のバージョンには復元できません。

新バージョンでも復元およびPITR機能を維持するには、アップグレード直後にバックアップを実行してください。 このバックアップは、今後の復旧作業の基準となります。

アップグレードに失敗した場合でも、アップグレード前のバックアップをPITRで利用することで、以前のバージョンを新しい環境に復元することができます。

トラブルシューティング

アップグレードが正常に完了した後で問題が発生し、以前のバージョンに戻す必要がある場合は、 IBM Cloud® のサポートまでご連絡の上、指示をお受けください。 指示なしにPITRや復元を実行することは避けてください。復旧作業が複雑化する恐れがあります。

アップグレードは、すべての事前チェックに合格した後にのみ実行されます。 アップグレードがブロックされている場合は、以下を確認してください：

• クラスターの健全性（パトロニ状態は安定）
• 十分な空きディスク容量
• 許容可能なディスクI/O使用率
• スキーマのサイズおよびオブジェクト数の制限

スキーマの規模が大きい場合やオブジェクト数が多い場合、アップグレードにかかる時間が長くなる可能性があります。

アップグレードの試みが引き続き失敗する場合は、 https://cloud.ibm.com/login?redirect=%2Funifiedsupport%2Fsupportcenter からサポートチケットを発行してください。

プロモーションとアップグレードのドライ・ラン

メジャーバージョンのアップグレードによる影響を評価するには、ドライランを実行してください。 ドライランでは、昇格およびアップグレードがシミュレートされ、その結果がデータベースのログに出力されます。 「 ログ分析」連携機能 を通じて、データベースのログにアクセスし、確認することができます。 これにより、現在実行中のバージョンとその拡張機能を、目的のバージョンへ正常にアップグレードできるようになります。

ドライ・ランを実行するには、skip_initial_backup が false に設定されており、version が定義されている必要があります。

コマンドは次のようになります：

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{
    "promotion": {
        "version": "14",
        "skip_initial_backup": false,
        "dry_run": true
    }
}' \