新しいメジャー・バージョンへのアップグレード
アップグレードの方法を選択してください:
- インプレース・メジャーバージョンアップグレード(IPMVU) : 既存のデプロイメントをアップグレードし、その接続文字列を維持します。
- 読み取り専用レプリカのアップグレード : データを別のデプロイメントにレプリケートし、その後、そのレプリカを昇格させてアップグレードします。
- バックアップからの復元 : 既存のバックアップから、サポート対象のターゲットバージョン上でデプロイメントを作成します。
最後の2つのパスについては、プロモーション後またはバックアップ後にソースに反映された変更は、新しいデプロイメントには反映されません。 まずは新バージョンをテストし、検証を行ってください。 最終的な切り替えを行う前に、ソースへの書き込みを停止してください。 その後、レプリカをプロモートするかバックアップを取得し、アプリケーションの接続情報を新しいデプロイメントに切り替えてください。
カタログ 内で、新規デプロイに使用可能なバージョンを、 ibmcloud cdb deployables-show、または /deployables API を通じて確認できます。
APIの例では、「 {region} 」をデプロイメントのリージョンに、「 {id} 」をデプロイメントの URL エンコードされたクラウドリソース名(CRN)に、「 <IAM_TOKEN> 」を Identity and Access Management (IAM)アクセストークンに置き換えてください。
アップグレードの要件
アプリケーションの対応性
本番環境への移行前に、代表的なステージング環境にて、選択したアップグレード手順をテストしてください。 IPMVUのリハーサルを行うには、直近のバックアップを PostgreSQL のソースバージョンに復元してください。 1つのデプロイメントには、プライマリと1つまたは2つの高可用性(HA)メンバーという、2つまたは3つのデータメンバーが含まれます。 復元後のデプロイメントは、本番環境と同じ数のメンバーにスケールしてください。HAメンバーの数が多いほど、 変換フェーズ に時間がかかるためです。 復元したデプロイメントに完全なバックアップが含まれていることを確認してから、目的のターゲットにアップグレードしてください。 アプリケーションのクエリ、バックグラウンドジョブ、ドライバ、拡張機能、および接続プールを確認してください。 パフォーマンスを記録し、アプリケーションで読み取り専用エラーや接続エラーが発生した期間も記録しておき、後で比較できるようにしてください。
ソースバージョン以降のすべてのメジャーバージョンについて、ターゲットバージョンまで(ターゲットバージョンを含む)の リリースノート を確認してください。 また、 ロールの権限の変更 についても確認してください。
このアップグレードでは、コミットのタイムスタンプは保持されません。 アップグレード後、 pg_xact_commit_timestamp() を実行すると、アップグレード前にコミットされたすべてのトランザクションについて、 NULL が返されます。 アプリケーションでコミットタイムスタンプを読み取っている場合は、アップグレードを行う前に、必要な値をテーブルの列にコピーしておいてください。
拡張機能およびその他のオブジェクト
アップグレードを行う前に、以下の各セクションに記載されている該当する準備作業を完了してください。 IPMVU については、アップグレード対象のデプロイメントを準備してください。 読み取り専用レプリカおよび復元パスについては、レプリカを作成したりバックアップを取得したりする前に、ソースのデプロイメントを準備してください。 読み取り専用レプリカを変更することはできません。また、復元を行うと、その操作と同時にデータがアップグレードされます。 削除するオブジェクトに対するアプリケーションの依存関係について、事前に計画を立てておいてください。
拡張機能
pg_repack
pg_repack アップグレードを妨げることはありません。 アップグレードの前後に、これを削除したり再作成したりする必要はありません。
old_snapshot
この old_snapshot このモジュールは、 PostgreSQL 17以降では利用できません。 PostgreSQL 16 以前のバージョンから PostgreSQL 17 以降のバージョンにアップグレードする場合、IPMVU は読み取り専用モードが開始される前に、各データベースから「
old_snapshot 」を削除します。 old_snapshot に依存するオブジェクトがある場合、アップグレードは失敗します。 後でアップグレードが失敗しても、削除は元に戻りません。
いずれかのデータベースに old_snapshot がインストールされている場合は、アップグレードを行う前に、サポートに連絡して依存オブジェクトを特定してください。 その他のアップグレードパスについては、サポートに連絡して削除の手配を行ってください。
anon
anon バージョン 2 がインストールされている場合は、それがインストールされている各データベースで、以下の手順を実行してください。 admin のように、マスクされたテーブルの所有者としてこれらのクエリを実行してください。 IPMVUの場合、 anon のバージョン2では、変換フェーズ中にデータベースが利用できない状態になるとアップグレードが失敗し、再試行しても毎回同様に失敗します。
anon のバージョン3では、これらの手順は必要ありません。 自己診断クエリ 10 では、 extversion にインストールされているバージョンが表示されます。
マスキングルールを削除する前に、マスキングされたロールに対するデータベースへのアクセスをブロックしてください。これらのロールには、マスキングされたデータのみを表示させる必要があります。 アップグレード後にマスキングルールとロールラベルを復元し、確認するまでは、それらのアクセスをブロックしたままにしておいてください。
-
アップグレード後に復元できるよう、マスキングルールとマスキング対象のロールを記録しておいてください。
SELECT objtype, objname, label FROM pg_catalog.pg_seclabels WHERE provider = 'anon'; -
すべてのマスキングルールを削除します。
SELECT anon.remove_masks_for_all_columns(); -
手順 1 に記載された各役割から、マスクされたラベルを取り除いてください。 PostgreSQL 16 以降では、この操作を行うには、ロールに「
ADMIN」オプションを設定する必要があります。 詳細については、「 バージョンアップ時のロール権限に関する問題 」を参照してください。SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL; -
カスケード・オプションで
anonのエクステンションを削除する。 カスケードオプションでは、anonに依存するオブジェクト(マスキングビューや関数など)も削除されます。 アップグレード後にそれらを再現できるよう、定義内容を記録しておいてください。DROP EXTENSION anon CASCADE; -
アップグレード後、
anonを再度有効にし、記録済みのマスキングルールとロールラベルを再適用してから、マスキングされたロールへのアクセスを復元する前に、マスキングが正しく機能していることを確認してください。
PostGIS
PostGIS, を使用している場合は、アップグレードを行う前に、それを使用している各データベースでアップグレードを行ってください。 PostgreSQL:
SELECT postgis_extensions_upgrade();
拡張機能のバージョンを確認してください:
SELECT postgis_full_version();
earthdistance
インデックスまたは保存済み生成列が、 earthdistance バージョン 1.1 の関数( ll_to_earth() など)を使用している場合、IPMVU は変換フェーズで失敗します。 これは、オブジェクトが独自のSQL関数を通じてこれを使用する場合にも当てはまります。 PostgreSQL 14および15では、 1.1 のバージョンのみが提供されています。 各データベースで セルフチェッククエリ 13 を確認し、リストされた各オブジェクトについて以下の処理を行ってください:
-
PostgreSQL 16 または 17 をお使いの場合は、アップグレードを行う前に拡張機能を更新してください:
ALTER EXTENSION earthdistance UPDATE; -
PostgreSQL 14 または 15 において、
used_functionが独自の関数の一つである場合は、その関数にsearch_path設定を追加してください:ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog; -
PostgreSQL 14 または 15 において、
used_functionがearthdistanceの関数である場合は、アップグレードを行う前に、リストされているインデックスを削除してください。 生成された列の値を保持するには、ALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;を使用して、その列を通常の列に変換してください。 アップグレード後、ALTER EXTENSION earthdistance UPDATE;を実行し、削除したものを再作成してください。 ターゲットが PostgreSQL 15の場合、この更新プログラムは効果を発揮せず、再作成されたオブジェクトによって、同様に次のアップグレードが妨げられます。 これを回避するには、 PostgreSQL 16以降にアップグレードしてください。
pgRouting
PostgreSQL 16 または 17 を実行している環境を PostgreSQL 18 にアップグレードする場合は、 pgRouting がインストールされている各データベースを確認してください。 PostgreSQL 18回のデプロイには、 pgRouting ( 3.5 )ライブラリは含まれていません。 PostgreSQL 18 向けの IPMVU は、読み取り専用モードが開始される前に、そのライブラリを使用する関数が実行されている間、互換性チェックに失敗します。
行は発生しないものと想定してください:
SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';
クエリで結果が返された場合は、アップグレードを行う前に、デプロイメントで提供されている最新バージョン pgRouting に更新してから、クエリを再度実行してください:
ALTER EXTENSION pgrouting UPDATE;
pgRouting 4.0 では、 pgr_createTopology``pgr_analyzeGraph、、などのいくつかの機能が削除され、その他の機能も変更されています pgr_nodeNetwork。 まず、ステージング環境でのデプロイにおいて pgRouting 、 4.0 を使用してアプリケーションをテストしてください。 削除された機能が必要な場合は、
PostgreSQL 18 へのアップグレードを行う前に、サポートにお問い合わせください。 PostgreSQL 16 からは、 3.5 ライブラリを含む PostgreSQL 17 へもアップグレードできます。
インデックス、パーティションキー、および生成列におけるSQL関数
変換フェーズでは、IPMVU はすべてのインデックス、パーティションキー、および生成済み列の定義を、検索パスを空にして再作成します。 これらのオブジェクトのいずれかが、 LANGUAGE sql 関数を使用し、その引数として、 pg_catalog の外部にあるオブジェクトを、スキーマを指定せずに(直接、またはドメインチェック制約を通じて)指定する文字列を指定した場合、このステップは失敗します。 拡張統計情報は、外部キーを持つテーブルに対しても同様の効果をもたらします。
インデックスでは、拡張機能がインストールされている ibm_extension スキーマを指定するCALLも失敗します。 このエラーは、データベースが利用できない状態で発生し、再試行するたびに同じように失敗します。
各データベースで、 自己診断クエリ12 を実行してください。 記載されている各関数について、その本体で使用されているすべてのスキーマを指定する「 search_path 」設定を追加してください。 あるいは、その文字列本体をSQL標準の本体に置き換えてください。 これらのステートメントを、関数の所有者として実行してください。 以下に例を示します。
ALTER FUNCTION f_unaccent(text) SET search_path = ibm_extension, pg_catalog;
CREATE OR REPLACE FUNCTION f_unaccent(text) RETURNS text
LANGUAGE sql IMMUTABLE PARALLEL SAFE STRICT
RETURN ibm_extension.unaccent('ibm_extension.unaccent', $1);
各関数の結果やその他の属性は変更しないでください。インデックスや生成列にはその結果が格納されており、パーティション化されたテーブルはそれらに基づいて行を振り分けるためです。 search_path が設定されている場合、 PostgreSQL は、その関数を呼び出すクエリ内で展開されなくなるため、それらのクエリの実行速度が低下する可能性があります。 SQL標準化団体は、自身が呼び出す文字列処理関数を保護していないため、それらの関数も修正してください。
行が返されなくなるまで、クエリを再度実行してください。 自分が所有していない関数がリストされている場合は、アップグレードする前にサポートにお問い合わせください。
PostgreSQL 16 以前のバージョンから PostgreSQL 17 以降のバージョンにアップグレードする場合は、 セルフチェッククエリ 17 も実行してください。 PostgreSQL 17以降では、検索パスを制限してメンテナンスコマンドを実行します。 インデックス、マテリアライズド・ビュー、または拡張統計情報が使用する、どの言語の関数であっても、その関数には独自の search_path 設定が必要です。 そうしないと、アップグレード後に、 ANALYZE、 REINDEX、 CLUSTER、 VACUUM FULL、および REFRESH MATERIALIZED VIEW が、影響を受けるオブジェクトに対して失敗します。 前の例のように、スキーマを指定せずにオブジェクトを指定する、リストにある各関数の検索パスを設定します。
詳細については、『 PostgreSQL 17』の移行に関する注意事項を参照してください。
削除されたシステム名を使用しているオブジェクト
メジャーバージョンアップのたびに、一部のシステムカタログの列、関数、および設定パラメータが削除されたり、名前が変更されたりします。 たとえば、 PostgreSQL 17 では、 pg_stat_bgwriter からチェックポイント列が削除され、 PostgreSQL 16 では、 force_parallel_mode パラメータの名称が debug_parallel_query に変更されました。
事前チェックでは、以下の名前を使用しているオブジェクトは検出されません:
- ビュー、マテリアライズド・ビュー、または集計が削除された名前を使用している場合、変換フェーズでIPMVUは失敗します。 SQL標準に準拠した本体を持つ関数と、削除されたパラメータを持つ関数、ロール、またはデータベース設定は、同じ効果をもたらします。
- 削除された名前を使用しているその他の関数やプロシージャ、
pg_cronのジョブ、およびアプリケーションのクエリは、新しいバージョンで初めて実行された際に失敗します。 これは、書き込みが再開される前に発生する可能性があります。
各データベースで、 セルフチェッククエリ14 を実行してください。 removed_in のバージョンが対象バージョン以下である、リストされている各オブジェクトを変更または削除します。 セルフチェッククエリ 7 を使用して、ロールとデータベースの設定を確認してください。 対象バージョンのステージング環境でのデプロイメント上で、アプリケーションおよび監視クエリをテストしてください。
論理レプリケーションスロット
IPMVUは、非アクティブなスロットや wal2json が使用しているスロットを含め、論理レプリケーションスロットが存在する限り、事前チェックに失敗します。 削除したスロットを復元することはできず、新しいスロットには、以前のスロットに保存されていた変更内容は反映されません。 アップグレードを行う前に:
-
各スロットの名前、プラグイン、およびデータベースを、 自己チェッククエリ 2 を使用して記録してください。
-
アップグレード後にコンシューマーを復元するか、下流のデータを再同期する予定になるまで、ソースへの書き込みを一時停止してください。
-
消費者に保留中の変更を処理させた後、それらを中止する。 タスクが「 完了 」と表示されるまで、自動再接続をオフにした状態で停止したままにしておいてください。
-
ibmcloud cdb postgresql replication-slot-deleteコマンド、または 論理レプリケーションスロットの削除 APIを使用して、各スロットを削除します。adminのユーザーは、SQLを使用してレプリケーションスロットを削除することはできません。ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME> -
アップグレード後は、「
wal2jsonの設定 」に記載されている手順に従って、スロットを再作成してください。
wal2json これは論理デコード出力プラグインであり、 CREATE EXTENSION で作成する拡張機能ではありません。
論理サブスクリプション
論理サブスクリプションは、パブリッシャーからの変更を受け取ります。 そのレプリケーションスロットはパブリッシャー上に存在するため、スロットクエリには表示されません。
PostgreSQL 16 以前のバージョンを実行している環境では、無効化されたサブスクリプションを含め、論理サブスクリプションが存在する限り、IPMVU の事前チェックに失敗します。 これらのバージョンからのアップグレードでは、サブスクリプションの同期状態は保持されません。 アップグレードを行う前に、パブリッシャーの所有者と、各サブスクリプションの削除および再作成の方法、ならびにデータの再同期の方法について合意しておいてください。 次に、 サブスクライバー関数 を使用して、サブスクリプションを削除します。 delete_subscription 関数は、パブリッシャー上のサブスクリプションのスロットも削除します。また、パブリッシャーに接続できない場合や、スロットがもはや存在しない場合は、この関数は失敗します。 その場合は、 disable_subscription を実行してから、 delete_subscription``
の前に subscription_slot_none を実行してください。 次に、パブリッシャーの所有者にそのスロットを削除するよう依頼してください。そのスロットがあると、パブリッシャーにトランザクションログが保持され続けるためです。
PostgreSQL 17以降が実行されている環境では、サブスクリプションはそのまま維持できますが、対象バージョンの 論理レプリケーションのアップグレード要件を満たしている必要があります。 このアップグレードでは、最大10件のサブスクリプションに対応しています。
値が大きすぎると、読み取り専用モードが開始される前に互換性チェックに失敗します。 アップグレードを行う前に、 disable_subscription を実行してサブスクリプションを無効にし、アップグレードが完了したら enable_subscription を実行してサブスクリプションを有効にしてください。
UNLOGGED テーブルとシーケンス
PostgreSQL UNLOGGED のテーブルおよびシーケンスに対する変更をトランザクション・ログに書き込みません。 これらは他のメンバーには複製されず、フェイルオーバーや復元後にはリセットされます。 どのアップグレード方法でも、その内容は保持されません:
- IPMVUは、新しいバージョンで PostgreSQL を再起動する際にこれらをリセットし、完了フェーズでプライマリの役割を切り替える際にも再度リセットします。 アップグレードの失敗によっても、これらがリセットされることがあります。
- 昇格された読み取り専用レプリカおよび復元されたバックアップは、
UNLOGGEDテーブルが空の状態から開始され、UNLOGGEDシーケンスがリセットされます。
アップグレード後、 UNLOGGED のテーブルは空になり、 UNLOGGED のシーケンスはリセットされます。 タスクが「 完了 」と表示されるまでは、これらのオブジェクトに加えた変更も失われる可能性があります。 アップグレードを行う前に、 セルフチェッククエリ 11 を使用して各データベース内のこれらのオブジェクトを特定し、それぞれについてどのように対処するかを計画してください。
- テーブルの内容を保持するには、
ALTER TABLE <table_name> SET LOGGED;を使用して変換します。SET LOGGEDは、テーブルのインデックスや、そのテーブルが所有するシーケンスも変換します。 外部キーを介して参照されているテーブルを変換する前に、参照元のテーブルを変換してください。 あるいは、内容をエクスポートし、タスクのステータスが「 完了 」になった後に再読み込みしてください。 - シーケンスがログ記録対象のテーブルの値を生成する場合は、
ALTER SEQUENCE <sequence_name> SET LOGGED;を使用して変換してください。 そうでない場合は、そのタスクが「 完了 」と表示されるまで、それを使用しているアプリケーションを停止してください。 次に、setval関数を使用して、現在使用されている最大値よりも大きい値に設定します。
SET LOGGED テーブルを書き換え、操作が完了するまで読み取りおよび書き込みをブロックします。 また、テーブルとそのインデックスが占める容量とほぼ同量のトランザクションログデータが生成されます。 アップグレードを実行する前に、大規模なテーブルを十分に余裕を持って変換し、自己チェッククエリ 5 を使用して、トランザクション・ログがアーカイブされたことを確認してください。 アップグレード後は、 ALTER TABLE <table_name> SET UNLOGGED; を実行することで、テーブルを元の状態に戻すことができます。
IPMVUの場合、 UNLOGGED テーブルは、たとえ空であっても、サービスがすべてのHAメンバーを再構築する原因となり、書き込みがブロックされる時間が長引きます。 詳細については、「 アップグレード中の利用状況 」を参照してください。 この再構築を回避するには、すべての UNLOGGED テーブルを変換するか、不要になったテーブルを削除してください。
TRUNCATE を使用しても、再構築は回避されません。 UNLOGGED シーケンスは再構築を引き起こしません。 PostgreSQL 16および17では、 SET LOGGED 自体がバルク操作であり、リビルドが発生する可能性があるため、その点を考慮して計画を立ててください。
その場でのメジャーバージョンアップ
準備を すべて完了したら、以下のUI、API、CLI、またはTerraformの手順に従ってください。
IPMVUでは、サービスはプライマリをその場でアップグレードし、各HAメンバーも既存のデータファイルからアップグレードします。 すべてのHAメンバーがデータファイルを再利用できる場合、書き込みのブロックはごく短時間にとどまります。 所要時間は、保存されているデータの量というよりは、主にデータベースオブジェクトの数やデータベースの稼働状況によって決まります。
状況によっては、このサービスがデータベース全体をHAメンバーにコピーすることになり、その結果、書き込みのブロック時間が大幅に長引くことがあります。 書き込みがブロックされた後、その他の条件によってアップグレードが失敗することがあります。 プリチェックではこれらの問題は検出されないため、アップグレードを送信する前に解決してください。 一覧については、 「事前チェックでは検出されない条件」を 参照してください。
IPMVUは、一度送信するとキャンセルすることはできません。また、展開済みのものをダウングレードすることもできません。 このサービスでは、アップグレード前にデータのバックアップは行われないため、まず オンデマンドバックアップ を作成し、その内容を確認してください。
アップグレード中の可用性
IPMVUは、以下のフェーズで実行されます。 読み取り専用フェーズが始まると書き込みは停止し、サービスが読み取り専用モードを解除すると再開されます。 変換フェーズ中は、読み取り操作も利用できません。
| フェーズ | どうなるのか | 読み取り数 | 書き込み数 |
|---|---|---|---|
| 検査 | このサービスは、保留中のデプロイ変更が完了するのを待ち、 事前チェック を実行します。 プライマリおよびHAメンバーのアップグレード互換性を確認し、自動フェイルオーバーを一時停止します。 | 使用可能 | 使用可能 |
| 読み取り専用 | このサービスは、すべてのデータベースにおいて新しいトランザクションを読み取り専用にし、すべてのクライアントセッションを終了させます。 その後、HAメンバーとトランザクション・ログのアーカイブ処理が追いつくのを待ちます。 | 使用可能 | ブロック |
| 変換 | このサービスは、すべてのメンバーの PostgreSQL を停止し、プライマリをアップグレードします。 可能な場合は、各HAメンバーを、そのメンバーの既存のデータファイルからアップグレードします。 | 使用不可 | 使用不可 |
| 再始動 | アップグレードされたプライマリは読み取り専用モードで起動し、HAメンバーも起動します。 このサービスは、アップグレードされたプライマリからデータファイルを再利用できないメンバーをすべて再構築します。 | 使用可能 | ブロック |
| 履歴書を作成する | このサービスは、読み取り専用モードを解除し、すべてのクライアントセッションを再度終了させます。 | 使用可能 | 使用可能 |
| 完了 | このサービスは、すべてのHAメンバーが同期を完了するのを待ちます。 その後、サービスはメンバーを1つずつ再起動し、新しいバージョンへのデプロイの移行を完了させます。 プライマリを再起動する前に、サービスはプライマリの役割を別のメンバーに切り替えます。これにより、クライアントのセッションが終了します。 その後、このサービスはアップグレードファイルを削除し、アップグレード後のバックアップをキューに入れ、タスクを「 完了 」としてマークします。 | 切り替え期間中を除き、ご利用いただけます | 切り替え期間中を除き、ご利用いただけます |
少なくとも1人のHAメンバーが追いつき、他のすべてのHAメンバーが追いついているか、再構築中である場合に、レジュームを書き込みます。 このサービスは、データファイルを再利用できないHAメンバーに対し、データベース全体をそのメンバーにコピーすることで、そのメンバーを再構築します。 すべてのHAメンバーを再構築する必要がある場合、最初の再構築が完了するまで書き込みはブロックされます。 大規模なデータベースの場合、これには数時間かかることがあります。 2つのデータメンバーからなるデプロイメント(これがデフォルトの設定です)には、HAメンバーが1つしかありません。 その結果、再構築を行うと書き込みがブロックされてしまいます。 HAのメンバーは、以下の状況では自身のデータファイルを再利用することはできません:
- どのデータベースにも、たとえ空であっても、「
UNLOGGED」テーブルが含まれています。 その後、このサービスはすべてのHAメンバーを再構築します。 セルフチェッククエリ 11 を確認し、UNLOGGEDのテーブルおよびシーケンスを 参照してください。 - この環境では PostgreSQL 16または17が稼働しており、一括処理や多数の同時挿入・更新によってテーブルが肥大化しました。 一括操作には、
COPY、pg_restore、CREATE TABLE AS、CREATE MATERIALIZED VIEW、REFRESH MATERIALIZED VIEW、およびALTER TABLEといったコマンドが含まれます。これらは、SET LOGGEDのようなテーブルを書き換えるものです。 これを事前に確認することはできないため、再構築を見込んで計画を立てておく必要があります。
また、このサービスは、事前に確認できないその他の理由により、HAメンバーを再構築することもあります。 バックアップから復元したステージング環境でのリハーサルでは、このような再構築が行われない場合があります。
再構築中のHAメンバーは、タスクが完了するまで以前のデータファイルを保持します。 その結果、そのデータが占める容量と同等以上の空きディスク容量が必要となります。 アップグレードを送信する前に、各データメンバーが利用可能なディスク容量の半分を大幅に下回るように使用していることを確認してください。 「 使用済みディスク容量 」というメトリクスを使用して、この値を確認してください。 ディスク容量の事前チェックではディスク使用率が最大90%まで許容されますが、HAメンバーの再構築には、それよりもはるかに多くの空き容量が必要となります。 そうしないと、再構築中にディスク容量が不足し、繰り返し失敗する可能性があります。 その結果、書き込みが数時間にわたってブロックされたままになり、最終的にタスクが失敗することがあります。 自動および手動によるディスクのスケーリングは、アップグレードが完了するまで待機するため、アップグレードを実行する前にディスクのスケーリングを行ってください。 再構築に時間がかかると、書き込みが再開された後にタスクが失敗することもあります。 どちらの場合も、サポートチームによるアップグレードが完了するまで、デプロイメントでは対象バージョンが実行されます。 メンテナンス期間内に再構築の時間を確保してください。
タスクが完了する前に履歴書を書き出します。 書き込みが再開されたかどうかを確認するには、新しいセッションで SHOW default_transaction_read_only; を実行してください。 書き込みが再開されると、 off が返されます。 クライアントセッションは、読み取り専用モードが開始されたとき、 PostgreSQL が変換のために停止したとき、書き込みが再開されたとき、完了フェーズでの切り替え中、および障害発生後にサービスが書き込みアクセスを復旧したときに終了します。
タスクのステータスが「 完了」 となるまでは、大量のデータ読み込みやバッチジョブなど、継続的な一括書き込みは避けてください。 完了フェーズでは、すべてのHAメンバーがすべての変更を再適用し終わるまで待機します。 継続的な高負荷の書き込みが行われている状況下では、この待機がタイムアウトとなり、書き込みが再開された後にタスクが失敗することがあります。 HAメンバーの再構築が行われている間は、リスクが高くなります。 その後、デプロイではアップグレード後のバックアップを行わずにターゲットバージョンを実行するため、サポート部門がアップグレードを完了させる必要があります。
書き込み負荷がHAメンバーの追従を妨げていないかどうかを確認するには、アップグレードを予定している時間に以下のクエリを実行してください。 数分間、1秒ごとにこれを繰り返します。例えば、 psql コマンド( \watch 1 )を使用します。 このサービスでは、すべてのHAメンバーが、 replay_lag_bytes で 0 を同時に表示する必要があります。 このような現象が一度も発生しない場合は、アップグレードを実行する前に書き込み負荷を軽減してください。
SELECT application_name, state,
pg_catalog.pg_wal_lsn_diff(pg_catalog.pg_current_wal_lsn(), replay_lsn) AS replay_lag_bytes
FROM pg_catalog.pg_stat_replication
ORDER BY application_name;
このアップグレードではオプティマイザの統計情報が更新されないため、 ANALYZE を実行するまでは、クエリが実行効率の悪い実行プランを選択してしまう可能性があります。 PostgreSQL 15、16、または17へのアップグレードでは、統計情報は引き継がれません。 PostgreSQL 18 へのアップグレードでは、ほとんどの統計情報が引き継がれますが、 CREATE STATISTICS で作成した拡張統計情報や、 PostGIS
などの拡張機能によって収集された統計情報は引き継がれません。 autovacuum プロセスは、十分な書き込みが行われた後にのみテーブルを分析し、パーティション化されたテーブルは決して分析しません。 タスクの完了を待機しません。 SHOW default_transaction_read_only; が off を返したら、すぐに「 アップグレード後 」の説明に従って統計情報を更新してください。
読み取り専用モードは、新しいトランザクションのデフォルト設定を指定します。 データベースをロックすることはありません。 default_transaction_read_only を off に設定するセッション、あるいは読み書きトランザクションを明示的に開始するセッションでも、書き込みを行うことは可能です。 では、そのロール自身の default_transaction_read_only 設定が
off となっている場合はどうでしょうか。 VACUUM、 ANALYZE、 REINDEX、 CLUSTER などのメンテナンスコマンドも、引き続き実行されます。 読み取り専用モードを有効にしても、すでに実行中の pg_cron ジョブや、 PostgreSQL 17で有効になっているサブスクリプションは停止されません。
このような書き込みがあると、アップグレードが失敗する可能性があります。 アップグレードを実行する前に、読み取り専用モードを無効にするプロセスを停止してください。 pg_cron ジョブなど、書き込みやメンテナンスコマンドの実行を行うスケジュールされたジョブを一時停止し、実行中のジョブが終了するのを待ちます。 「 アップグレード後 」の説明に従って、それらを再開してください。
読み取り専用モードでも、読み取り処理中にトランザクションログが書き込まれることがあります。たとえば、一括ロードや大規模な更新の後、クエリが初めて行を読み込む場合などが挙げられます。 この操作により、読み取り専用フェーズおよび再起動フェーズが待機しているキャッチアップが遅延するため、書き込みがより長くブロックされたままとなり、アップグレードが失敗する可能性があります。 アップグレードを実行する前に、最近データを読み込んだテーブルや大幅に変更を加えたテーブルに対して、 VACUUM を実行してください。
サービスがセッションを終了すると、デプロイメントに直接接続しているクライアントには、SQLSTATE「 57P01 」(admin_shutdown )が返されます。読み取り専用トランザクションでの書き込みは、SQLSTATE「 25006 」(read_only_sql_transaction )で失敗します。変換フェーズ中は、認証情報が変更されていないにもかかわらず、SQLSTATE「
28P01 」などの認証エラーにより、新しい接続が失敗する場合があります。 変換が完了したら、もう一度接続を試してみてください。 タスクのステータスが「 失敗 」となった後もこれらのエラーが続く場合は、サポートまでご連絡ください。 接続プール機能を通じて、アプリケーションは他の接続エラーを把握することができます。
読み書きセッションのみを受け付けるクライアントは、読み取り専用モードが設定されている間は接続できないため、書き込みが再開されるまで、これらのクライアントも読み取り操作を行うことができません。 これは、 target_session_attrs=read-write を設定している libpq クライアント、および targetServerType=primary または master を設定している JDBC クライアントに適用されます。 読み取り操作を継続するには、 target_session_attrs=any を使用するか、 libpq 14 以降では primary を使用してください。 JDBC については、 targetServerType=any をご利用ください。
アプリケーションは、接続エラーや読み取り専用エラーに対処し、再接続を行い、中断されたトランザクションについては、安全が確認された場合にのみ再試行する必要があります。 接続プールを採用しても、これらの要件がなくなるわけではありません。 アプリケーションへのアクセスが、アップグレードタスクが完了したことを示す証拠にはなりません。
バックアップと復旧
このサービスでは、アップグレードの前にデータのバックアップは行われません。 IPMVUを実行する前に、直近の オンデマンドバックアップ を作成し、その内容を確認してください。 アップグレード後にソースバージョンに戻すには、アップグレード前のバックアップまたはリカバリポイントを、ソースバージョンが実行されている新しい展開環境に復元してください。 バージョンを明示的に指定してください。バージョンを指定せずに特定の時点への復元を行うと、現在のバージョンが実行されるデプロイメントが作成されてしまうためです。 このオプションを使用するには、新しいデプロイメントを行う際に、ソースバージョンが引き続き利用可能である必要があります。 その時点以降に行われた変更をアカウント。
アップグレードが正常に完了すると、サービスはアップグレード後のデプロイメントのバックアップをキューに登録します。 バックアップは、アップグレードタスクが完了した後に個別に実行されるため、すぐに開始されない場合があります。 新バージョンでのこの最初のバックアップでは、データベース全体がコピーされるため、データベースの規模が大きい場合は数時間かかる場合があります。 「バックアップと復元 」でその状態を確認してください。 失敗した場合は、オンデマンドバックアップを実行し、それでも問題が解決しない場合はサポートまでご連絡ください。 バックアップの失敗があっても、アップグレードはロールバックされません。
ポイント・イン・タイム・リカバリ(PITR)では、メジャーバージョンのアップグレードをまたぐトランザクションの再実行はできません。 アップグレードタスクが開始される前の時点、またはアップグレード後のデプロイメントの最初のバックアップが完了した後の時点まで、復元することができます。 アップグレードからアップグレード後のバックアップが完了するまでの間に設定されたリカバリポイントへの復元はサポートされていません。 このサービスは、これらのリカバリポイントの一部を拒否する場合があり、また、他のリカバリポイントへの復元は受け入れられるものの、復元処理の途中で失敗することがあります。 このサポート対象外の期間には、書き込みが再開された後の時間も含まれます。 アップグレード後のバックアップが完了するまでは、サービスが復元要求を受け付けた場合でも、利用可能な最新の復旧ポイントへの復元が失敗することがあります。
アップグレード後の変更についてもPITRの適用範囲を維持するには、アップグレード後のバックアップが完了するまで、アプリケーションの書き込みを一時停止しておいてください。 アプリケーション内でそれらを一時停止してください。 書き込みが再開されると、アップグレードによってすべてのデータベースの default_transaction_read_only がリセットされるため、データベースレベルの読み取り専用設定があっても書き込みの一時停止は継続されません。
アップグレードに失敗した場合、バックアップはキューに入れられません。 PITRは、復元処理の開始から次のバックアップが完了するまでの間、ポイント単位での利用ができない場合があります。 アップグレードに失敗した後、 SHOW server_version; がソースバージョンを報告しており、かつデプロイメントが書き込みを受け付けている場合は、オンデマンドバックアップを実行してください。 それ以外の場合は、バックアップを取ったり、その他の変更を行ったりする前に、サポートまでお問い合わせください。
アップグレード前のバックアップおよびリカバリポイントは、以前のバージョンに属しており、引き続き保存期間の制限の対象となります。 詳細については、 PITRを 参照してください。
PostgreSQL: では、skip-backup オプションはサポートされていません。API では skip_backup 、CLI では --skip-backup 、Terraform では version_upgrade_skip_backup です。 それらを有効にするリクエストは失敗します。 API
と CLI がエラーを返し、Terraform のプラン実行が失敗します。
開始前に
これらの要件を、ステージング環境と本番環境の両方に適用してください:
-
「 アプリケーション、拡張、およびレプリケーションの準備 」および「 バックアップの準備 」を完了してください。
-
プレチェックでは検出されない問題を 解決し、 セルフチェッククエリ を実行してください。
-
各データメンバーが、利用可能なディスク容量の半分を大幅に下回るようにし、HAメンバーの再構築時にディスク容量が不足しないようにしてください。 詳細については、「 アップグレード中の利用状況 」を参照してください。
-
デプロイメントに、少なくとも1つの完了済みのバックアップが存在することを確認してください。 それまでは、コンソールでは「 メジャーバージョンのアップグレード 」ボタンが使用不可となり、API もそのリクエストを拒否します。
-
IPMVUは、読み取り専用レプリカの展開環境では利用できません。 レプリカをアップグレードするには、 バージョンアップグレードを行ってレプリカを昇格させます。
-
デプロイメントのすべての読み取り専用レプリカ(他のリージョンにあるレプリカを含む)をプロモートまたは削除し、各操作が完了するまで待ちます。 削除されたレプリカは、完全に削除されるまで、そのデプロイメントに関連付けられたままとなります。 デプロイメントにレプリカが1つでも関連付けられている場合、アップグレードは事前チェックに失敗します。 これらのレプリカから読み取りを行うアプリケーションについて、計画を立ててください。 詳細については、「 読み取り専用レプリカ」および「IPMVU 」を参照してください。
-
アップグレードは一度に1つずつ実行してください。 別のアップグレードタスクがキューに入っているか、実行中の場合、このサービスは新しいアップグレード要求を拒否します。
-
デプロイメントの「
synchronous_commit」設定を「on」に設定している場合は、アップグレードを送信する前に、これを「local」に変更してください。 タスクのステータスが「 完了 」になった後、元に戻してください。onでは、アップグレードに失敗すると、サポートチームがデプロイを復旧するまで、すべてのデータベースが読み取り専用状態になったり、コミットが保留されたりすることがあります。 以下のクエリを実行した際に、ソースがconfiguration fileであるonという結果が返される場合、そのデプロイメントの設定はonとなります:SELECT setting, source FROM pg_catalog.pg_settings WHERE name = 'synchronous_commit'; -
デプロイメントの機能の中から対象を選択してください。 アップグレード遷移として表示される後続のバージョンであれば、中間バージョンを経ることなく、直接アップグレードすることができます。 プロビジョニング可能なバージョンが、必ずしもインプレース・アップグレードの対象となるわけではありません:
ibmcloud cdb deployment-capability-show <NAME|CRN> versions出力では、 アップグレード遷移エントリの「
to_version」の値を使用してください。
事前確認と準備
このサービスは、読み取り専用モードが開始される前に、以下のチェックを実行します。 チェックに失敗した場合、タスクには「 失敗 」と表示され、デプロイは現在のバージョンのまま維持されますが、書き込みはブロックされません。 いずれかのデータベースで「 default_transaction_read_only 」が「 on 」に設定されている場合、チェックに失敗すると、すべてのデータベースでこの設定がリセットされ、すべてのクライアントセッションが終了します。
このタスクでは、どのチェックに失敗したかは報告されないため、アップグレードを送信する前に各項目を確認してください。
| 確認 | 次の場合に合格となる | 操作 |
|---|---|---|
| 導入時の健全性 | すべてのデータメンバーが稼働しており、各HAメンバーはプライマリからデータをストリーミングしています。 | スケーリング、メンテナンス、およびHAメンバーの再構築が完了するまで待ちます。 セルフチェッククエリ 1 を確認してください。 その他のタスクはこのチェックに失敗することはありませんが、アップグレードの開始が遅れます。 「 最近のタスク 」を確認するか、 ibmcloud cdb deployment-tasks-list でタスクの一覧を表示します。 このチェックが繰り返し失敗する場合は、サポートまでご連絡ください。 |
| ディスク・スペース | 各データメンバーは、割り当てられたディスク容量の最大90%を使用します。 | ディスクの容量を調整するか、不要になったデータを削除してください。 使用されていない論理レプリケーションスロットでも、トランザクションログを保持することができます。 このチェックでは最大90%まで許容されますが、HAメンバーの再構築を行う際には、各データメンバーがディスク容量の半分をはるかに下回る範囲で使用する必要があります。 アップグレード中の利用状況については、こちらをご覧ください。 |
| CPU、メモリ、およびディスクI/O | 各データメンバーについて、ホストの1分間の負荷平均は、そのCPU数の90%以下であり、ホストのメモリ使用率も90%以下である。 ディスクI/Oの使用率も最大で90%です。 | アクセスが少ない時間帯にアップグレードを行うか、後で再度アップグレードを申請してください。 このサービスは、ホスト上の他のワークロードを含め、ホスト全体の負荷とメモリ使用量を測定し、数秒間にわたってディスクI/Oをサンプリングします。 負荷平均には、ディスクI/Oを待機しているプロセスも含まれます。 したがって、その値は監視指標とは異なる場合があり、デプロイメントをスケールアップしても、その値が低下しない可能性があります。 このチェックが繰り返し失敗する場合は、サポートまでご連絡ください。 |
| トランザクション・ログのアーカイブ | アーカイブ処理は失敗しておらず、アーカイブ待ちのトランザクション・ログは4 GB以下です。 | バックログが解消されるまで、書き込みレートを下げてください。 セルフチェックの質問 5 にご確認ください。 また、HAメンバーにトランザクションログの待機状態がある場合(たとえば、フェイルオーバー直後など)も、このチェックは失敗します。 このチェックが繰り返し失敗する場合は、サポートまでご連絡ください。 |
| 論理レプリケーション | 論理レプリケーションスロットが存在しません。 PostgreSQL 16 およびそれ以前のバージョンでは、無効化されたサブスクリプションを含め、論理サブスクリプションは存在しません。 | スロットを 削除します。 PostgreSQL 16 およびそれ以前のバージョンでは、 サブスクリプションを 削除してください。 PostgreSQL 17では、これらを無効にしてください。 セルフチェックの質問2と3を確認してください。 |
| 読み取り専用レプリカとレプリケーションクライアント | このデプロイメントには読み取り専用レプリカが関連付けられておらず、HAメンバー以外のレプリケーションクライアントはこれに接続しません。 レプリカは、プロビジョニング中または接続が切断されているレプリカを含め、どのリージョンや州においてもカウントされます。 | コンソール上で、または ibmcloud cdb deployment-read-replicas を使用して、関連するレプリカを一覧表示します。 それぞれを「昇格」または「削除」し、各操作が完了するまで待ちます。 削除されたレプリカは、リストには表示されなくなりますが、完全に削除されるまではカウント対象となります。
「 読み取り専用レプリカ」および「IPMVU 」を参照してください。 他のレプリケーションクライアントの接続を切断してください。 自己チェッククエリ 1 では、接続中のクライアントのみが表示されます。 |
| 事前処理済みの取引 | 準備済みのトランザクションは存在しません。 | 所有アプリケーションまたはトランザクションマネージャーに、準備済みトランザクションを処理させ、アップグレードが完了するまで新しいトランザクションが開始されないようにしてください。 チェックを通すためだけにコミットしたり、ロールバックしたりしないでください。 セルフチェックのクエリ4で確認してください。 |
| スキーマのエクスポート | 各データベースのスキーマは、エラーなくエクスポートされます。 タイムアウトが発生したり、ロックスペースが不足したりしたエクスポートでも、このチェックに失敗することはありません。 | 直近のバックアップから復元したステージング環境上で、アップグレードのリハーサルを行ってください。 このチェックでは、対象バージョンでスキーマを再作成できるかどうかは検証されないため、 事前チェックでは検出されない条件についても 解決してください。 このチェックが繰り返し失敗する場合は、サポートまでご連絡ください。 |
| アップグレードの互換性 | PostgreSQL プライマリおよびすべてのHAメンバーにおいて、アップグレードの互換性チェックに合格しました。 | pgRouting のチェック を含め、 拡張機能の準備 を完了してください。 PostgreSQL 17では、 サブスクリプションを 最大10件まで保持してください。 自己チェック問題の6、8、9、10を確認してください。 |
事前チェックでは検出されない条件
事前チェックでは、以下の状況は検出されません。 書き込みがブロックされた後、アップグレードが失敗してしまうものもあります。 原因が関数やデータベース名などのスキーマにある場合、その問題を解決するまでは、再試行するたびに同じように失敗します。 その他の条件では、サービスがデータベース全体をHAメンバーにコピーすることになり、書き込みが長時間ブロックされたままになるか、書き込みが再開された後にアップグレードが失敗することになります。 変換フェーズまたは再起動フェーズで障害が発生した場合、サポートが再起動を行うまで、HAメンバーが停止したままになることもあります。 アップグレードを送信する前に、各条件について解決策を講じるか、対応策を立てておいてください。
| 条件 | 効果 | 実行するアクション |
|---|---|---|
データベースには、「 UNLOGGED 」というテーブルが含まれています。 |
すべてのHAメンバーが再構築され、 UNLOGGED の内容がリセットされます。 |
セルフチェッククエリ11で確認してください。 UNLOGGED のテーブルおよびシーケンスを 参照してください。 |
| この環境では PostgreSQL 16または17が稼働しており、一括処理や多数の同時挿入・更新によってテーブルが肥大化しました。 | HAのメンバーが再構築されました。 | 再構築のためのメンテナンス期間とディスク容量を計画してください。 アップグレード中の利用状況については、こちらをご覧ください。 |
| HAメンバーが再構築される際、データメンバーはそのディスク容量の約半分以上を使用します。 | 再構築中にディスク容量が不足しました。 書き込みが数時間にわたってブロックされたままの状態が続いても、タスクが失敗することはありません。 | アップグレードを送信する前に、各データメンバーが利用可能なディスク容量の50%を大幅に下回るようになるまで、ディスクの容量を調整してください。 |
インデックス、パーティションキー、保存生成列、または拡張統計では、 LANGUAGE sql 関数が使用されます。この関数の引数として、 pg_catalog 以外のオブジェクトを、スキーマを省略して名前で指定する文字列が渡されます。 インデックスにおいて、 ibm_extension スキーマを指定しても同様の効果があります。 |
変換に失敗しました。 | セルフチェックのクエリ12で確認してください。 インデックス、パーティションキー、および生成列におけるSQL関数については、こちらを参照してください。 |
インデックスまたはストアド生成カラムでは、 earthdistance のバージョン 1.1 が使用されます。 |
変換に失敗しました。 | セルフチェックのクエリ13で確認してください。 earthdistance を参照してください。 |
| SQL標準に準拠した本体を持つビュー、集計関数、または関数が、対象バージョンで削除されたシステム名を使用しています。 あるいは、関数、ロール、またはデータベースの設定で、削除されたパラメータが使用されている。 | 変換に失敗しました。 | セルフチェックの質問7と14を確認してください。 「削除されたシステム名を使用しているオブジェクト」 を参照してください。 |
anon バージョン 2 がインストールされています。 |
変換に失敗しました。 | 「 anon 」の準備 を完了してください。 |
データベース名には、一重引用符(' )、バックスラッシュ(`` )、等号(= )、改行、またはキャリッジリターンが含まれています。 |
アップグレードが失敗し、場合によっては書き込みがブロックされた後に失敗することがあります。 | セルフチェックのクエリ15で確認してください。 データベースの名前を変更し、接続文字列を更新してください。 |
| データベースには、何千ものテーブルやシーケンス、あるいは PostgreSQL 14および15ではビューが含まれています。 | 変換処理でロックスペースが不足し、失敗しました。 | セルフチェッククエリ16で確認し、クエリの結果、必要であると判断された場合は、 max_locks_per_transaction を増やしてください。 |
| この環境には、非常に多くのデータベース、テーブル、または大容量オブジェクトが存在します。 | 変換に制限時間を超えました。 データベースが利用できない状態では、タスクが失敗するか、処理中のままになります。 | セルフチェッククエリ16を使用して、テーブルと大型オブジェクトの数を数えてください。 直近の本番環境のバックアップから復元したステージング環境上でリハーサルを行ってください。 リハーサルが失敗した場合は、サポートまでご連絡ください。 |
| アップグレードが開始されたとき、またはアーカイブ待ちのトランザクションログが多数ある場合、書き込みアクティビティが高くなります。 | 読み取り専用モードが開始されると、HAメンバーとトランザクションログのアーカイブ処理には、遅れを取り戻すためにわずか数分しか与えられません。 事前チェックに合格したバックログでも、アーカイブに時間がかかる場合があり、その結果、アップグレードが失敗することがあります。 | アップグレードが開始されてから書き込みが再開されるまでの間は、負荷を低く抑え、アップグレードの前に、最近読み込まれたテーブルに対して VACUUM を実行してください。 「 アップグレード中の可用性 」にあるクエリを使用してレプリケーションの遅延を確認し、セルフチェッククエリ 5 を使用してアーカイブ状況を確認してください。 |
読み取り専用モードが開始された後も、書き込みは継続されます。例えば、読み取り専用モードのオーバーライド、メンテナンスコマンド、 pg_cron ジョブの実行、または PostgreSQL 17で有効化されたサブスクリプションなどが挙げられます。 |
HAメンバーとアーカイブの処理が間に合わず、アップグレードが失敗する可能性があります。 | 「 アップグレード中の可用性 」に記載されているとおり、アップグレードを送信する前に、これらのライターを停止してください。 |
クライアントは、事前チェックの後、トランザクションを準備します。 PREPARE TRANSACTION は、読み取り専用モードでも引き続き動作します。 |
書き込みがブロックされている間に、アップグレードが失敗します。 PostgreSQL が停止する直前に準備されたトランザクションは、変換の失敗を引き起こす可能性があります。 | タスクが「 完了 」と表示されるまで、2フェーズコミットを使用するクライアントを停止してください。 セルフチェックのクエリ4で確認してください。 |
| アップグレード中にレプリケーションクライアントが接続します。 | これにより作成されるスロットは保持されず、データベースが利用できない間にアップグレードが失敗したり、停止したりする可能性があります。 | タスクのステータスが「 完了 」となるまで、レプリケーションクライアントの接続を切断したままにしておいてください。 セルフチェックの質問1と2を確認してください。 |
| 書き込みが再開されると、連続したバルクロードが実行されます。 | 書き込みが再開されるとタスクは失敗し、サポートチームによるアップグレードが完了するまで、デプロイメントでは対象バージョンが実行され続けます。 | タスクのステータスが「 完了 」となるまでは、一括読み込みを行わないでください。 |
このデプロイメントの「 synchronous_commit 」設定は、 on です。 |
アップグレードに失敗すると、サポートチームがデプロイを復旧するまで、すべてのデータベースが読み取り専用状態のままになる可能性があります。 | 「 開始する前に 」に記載されているとおり、 local に変更してください。 |
PostgreSQL 16 以前のバージョンから 17 以降にアップグレードした際、インデックス、マテリアライズド・ビュー、または拡張統計情報で、 search_path 設定が指定されていない関数が使用されている場合。 |
アップグレード後、 ANALYZE、 REINDEX、 CLUSTER、 VACUUM FULL、および REFRESH MATERIALIZED VIEW が、これらのオブジェクトに対して失敗する可能性があります。 |
セルフチェックの質問17で確認してください。 インデックス、パーティションキー、および生成列におけるSQL関数については、こちらを参照してください。 |
アップグレードの送信からタスクの完了までの間、スキーマ、拡張機能、データベース、論理レプリケーションスロット、およびサブスクリプションを変更しないでください。
自分で準備状況を確認する
アップグレードを送信する前に、 admin ユーザーとして、 psql で以下のクエリを実行してください。 これらは、 PostgreSQL のバージョン14から18までで動作します。 クエリ1から7およびクエリ15はデプロイ全体を対象としているため、いずれかのデータベースで1回実行してください。 各データベースで、残りのクエリを実行してください。
-
レプリケーション接続。 HAメンバーごとに1行ずつ表示されます。HAメンバーの数はデータメンバーの数から1を引いた数であり、各行の状態は
streamingとなります。 それ以外の行は、読み取り専用レプリカまたは別のレプリケーションクライアントです。 「pg_basebackup」という行は、サービスがデータベースをHAメンバーまたは読み取り専用レプリカにコピーしていることを意味します。 コピーが完了するまで待ってから、クエリを再度実行してください。SELECT application_name, client_addr, state FROM pg_catalog.pg_stat_replication ORDER BY application_name; -
論理レプリケーションスロット。 争いなどないだろう。
SELECT slot_name, plugin, database, active FROM pg_catalog.pg_replication_slots WHERE slot_type = 'logical'; -
論理的な購読。 PostgreSQL 16 およびそれ以前のバージョンでは、行は存在しないものと見なしてください。 PostgreSQL 17では、すべての行の「
subenabled」列に「f」が表示されることが予想されます。SELECT d.datname AS database_name, s.subname, s.subenabled FROM pg_catalog.pg_subscription AS s JOIN pg_catalog.pg_database AS d ON d.oid = s.subdbid; -
処理済みの取引。 争いなどないだろう。
SELECT gid, owner, database, prepared FROM pg_catalog.pg_prepared_xacts; -
トランザクション・ログのアーカイブ。
last_failed_timeは空か、last_archived_timeより前の値となり、waiting_filesは 0 または 0 に近い値となることが予想されます。 事前チェックに合格した未処理タスクであっても、読み取り専用モードが開始された後では、その量が膨大すぎてアーカイブできない場合があります。SELECT failed_count, last_failed_time, last_archived_time FROM pg_catalog.pg_stat_archiver;SELECT count(*) AS waiting_files, pg_catalog.pg_size_pretty(count(*) * pg_catalog.pg_size_bytes(pg_catalog.current_setting('wal_segment_size'))) AS waiting_size FROM pg_catalog.pg_ls_archive_statusdir() WHERE name LIKE '%.ready'; -
データベース接続設定。 争いなどないだろう。
datconnlimitが-2であるリストに登録されたデータベースは、無効であるため削除します。 リストにあるその他のデータベースについては、接続を許可するか、削除してください。 クエリに「template0」と表示されている場合は、サポートまでご連絡ください。SELECT datname, datallowconn, datconnlimit FROM pg_catalog.pg_database WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2)) OR (datname = 'template0' AND datallowconn); -
役割とデータベースの設定。
setconfig内のすべてのパラメータが、対象のバージョンに存在することを確認してください。 ターゲットバージョンで削除または名前が変更されたパラメータをリセットし、アップグレード後にその代替となるパラメータを設定します。 これは、名前にピリオドを含む拡張機能によって定義されたパラメータにも当てはまります。 どのロールも、default_transaction_read_onlyを false 値(off、false、no、0など)に設定しないようにしてください。default_transaction_read_onlyを設定している各データベースを記録しておいてください。アップグレードにより、この設定がリセットされるためです。 自己診断クエリ 14 では、関数の設定を確認します。SELECT r.rolname AS role_name, d.datname AS database_name, s.setconfig FROM pg_catalog.pg_db_role_setting AS s LEFT JOIN pg_catalog.pg_roles AS r ON r.oid = s.setrole LEFT JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase; -
PostgreSQL でアップグレードできない列のデータ型。 争いなどないだろう。 このクエリには、システムの複合型、およびこれらの型に基づいて構築されたドメイン、配列、複合型、範囲の列も一覧表示されます。
base_type列には、アップグレードを妨げているブロックが表示されています。aclitemタイプは、 PostgreSQL 14 または 15 から 16 以降へのアップグレードのみをブロックします。WITH RECURSIVE problem_types (type_oid, base_type) AS ( SELECT t.oid, t.typname::text FROM pg_catalog.pg_type AS t WHERE t.typnamespace = 'pg_catalog'::pg_catalog.regnamespace AND t.typname IN ('regcollation', 'regconfig', 'regdictionary', 'regnamespace', 'regoper', 'regoperator', 'regproc', 'regprocedure', 'aclitem') UNION ALL SELECT t.oid, 'system composite type ' || t.oid::pg_catalog.regtype::text FROM pg_catalog.pg_type AS t LEFT JOIN pg_catalog.pg_namespace AS n ON n.oid = t.typnamespace WHERE t.typtype = 'c' AND (t.oid < 16384 OR n.nspname = 'information_schema') UNION ALL SELECT derived.type_oid, derived.base_type FROM ( WITH found AS (SELECT type_oid, base_type FROM problem_types) SELECT t.oid AS type_oid, f.base_type FROM pg_catalog.pg_type AS t JOIN found AS f ON t.typtype = 'd' AND t.typbasetype = f.type_oid UNION ALL SELECT t.oid, f.base_type FROM pg_catalog.pg_type AS t JOIN found AS f ON t.typtype = 'b' AND t.typelem = f.type_oid UNION ALL SELECT t.oid, f.base_type FROM pg_catalog.pg_type AS t JOIN pg_catalog.pg_class AS c ON c.reltype = t.oid JOIN pg_catalog.pg_attribute AS a ON a.attrelid = c.oid AND NOT a.attisdropped JOIN found AS f ON a.atttypid = f.type_oid WHERE t.typtype = 'c' UNION ALL SELECT t.oid, f.base_type FROM pg_catalog.pg_type AS t JOIN pg_catalog.pg_range AS r ON r.rngtypid = t.oid JOIN found AS f ON r.rngsubtype = f.type_oid WHERE t.typtype = 'r' ) AS derived ) SELECT DISTINCT n.nspname AS schema_name, c.relname AS relation_name, a.attname AS column_name, a.atttypid::pg_catalog.regtype AS data_type, p.base_type FROM pg_catalog.pg_attribute AS a JOIN pg_catalog.pg_class AS c ON c.oid = a.attrelid JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace JOIN problem_types AS p ON p.type_oid = a.atttypid WHERE a.attnum > 0 AND NOT a.attisdropped AND c.relkind IN ('r', 'm', 'i') AND n.nspname NOT IN ('pg_catalog', 'information_schema') AND n.nspname !~ '^pg_toast_temp_|^pg_temp_' ORDER BY 1, 2, 3; -
親テーブルに
NOT NULL制約があるにもかかわらず、その制約を持たない継承された列。 争いなどないだろう。 リストされた列を固定するには、テーブルの所有者がALTER TABLE <table_name> ALTER COLUMN <column_name> SET NOT NULL;`` を実行します。SELECT n.nspname AS schema_name, c.relname AS table_name, child.attname AS column_name FROM pg_catalog.pg_inherits AS i JOIN pg_catalog.pg_attribute AS child ON child.attrelid = i.inhrelid JOIN pg_catalog.pg_attribute AS parent ON parent.attrelid = i.inhparent AND parent.attname = child.attname JOIN pg_catalog.pg_class AS c ON c.oid = i.inhrelid JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace WHERE parent.attnum > 0 AND parent.attnotnull AND NOT child.attnotnull AND NOT child.attisdropped; -
インストール済みの拡張機能。 拡張の準備 を完了してください。 次に、残りのすべての拡張機能が、ターゲットバージョン(たとえば、そのバージョンのステージング環境など)で利用可能であることを確認してください。
SELECT extname, extversion FROM pg_catalog.pg_extension ORDER BY extname; -
UNLOGGEDテーブルとシーケンス。 その内容はアップグレード後に引き継がれず、リストに登録されたテーブルがあると、サービスはすべてのHAメンバーを再構築することになります。 アップグレードを行う前に、『UNLOGGED』のテーブルおよびシーケンス についてご確認ください。SELECT n.nspname AS schema_name, c.relname AS relation_name, c.relkind FROM pg_catalog.pg_class AS c JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace WHERE c.relpersistence = 'u' AND c.relkind IN ('r', 'S'); -
変換を失敗させる可能性のあるSQL関数。 争いなどないだろう。 このクエリは、インデックス、部分インデックス述語、パーティションキー、ストアド生成カラム、または拡張統計で使用される、文字列の引数を持つ
LANGUAGE sql関数を一覧表示します。 これは、演算子、ドメインチェック制約、およびSQL標準に準拠した本体を持つ関数を通じた呼び出しに続きます。 記載されている各関数については、 「インデックス、パーティションキー、および生成列におけるSQL関数 」を参照してください。WITH RECURSIVE uses (refclassid, refobjid, used_by) AS ( SELECT d.refclassid, d.refobjid, CASE WHEN c.relkind = 'p' THEN 'partition key of ' ELSE 'index ' END || c.oid::pg_catalog.regclass::text FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_class AS c ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass AND c.oid = d.objid WHERE c.relkind IN ('i', 'I') OR (c.relkind = 'p' AND d.objsubid = 0) UNION SELECT d.refclassid, d.refobjid, 'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_attrdef AS ad ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass AND ad.oid = d.objid JOIN pg_catalog.pg_attribute AS a ON a.attrelid = ad.adrelid AND a.attnum = ad.adnum WHERE a.attgenerated = 's' UNION SELECT d.refclassid, d.refobjid, 'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_attribute AS a ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass AND a.attrelid = d.objid AND a.attnum = d.objsubid WHERE a.attgenerated = 's' UNION SELECT d.refclassid, d.refobjid, 'statistics ' || s.stxname || ' on ' || s.stxrelid::pg_catalog.regclass::text FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_statistic_ext AS s ON d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass AND s.oid = d.objid ), used (fn, used_by) AS ( SELECT x.fn, u.used_by FROM uses AS u CROSS JOIN LATERAL ( SELECT u.refobjid AS fn WHERE u.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass UNION ALL SELECT o.oprcode::pg_catalog.oid FROM pg_catalog.pg_operator AS o WHERE u.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass AND o.oid = u.refobjid UNION ALL SELECT dc.refobjid FROM pg_catalog.pg_constraint AS con JOIN pg_catalog.pg_depend AS dc ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass AND dc.objid = con.oid AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass WHERE u.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass AND con.contypid = u.refobjid ) AS x UNION SELECT x.fn, u.used_by FROM used AS u JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn AND p.prosqlbody IS NOT NULL AND p.proconfig IS NULL AND NOT p.prosecdef JOIN pg_catalog.pg_depend AS d ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND d.objid = u.fn CROSS JOIN LATERAL ( SELECT d.refobjid AS fn WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass UNION ALL SELECT o.oprcode::pg_catalog.oid FROM pg_catalog.pg_operator AS o WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass AND o.oid = d.refobjid ) AS x ) SELECT DISTINCT u.fn::pg_catalog.regprocedure AS function_name, u.used_by FROM used AS u JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang WHERE l.lanname = 'sql' AND p.prosqlbody IS NULL AND p.proconfig IS NULL AND NOT p.prosecdef AND p.pronamespace <> 'pg_catalog'::pg_catalog.regnamespace AND NOT EXISTS (SELECT 1 FROM pg_catalog.pg_depend AS e WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND e.objid = p.oid AND e.deptype = 'e') ORDER BY 1, 2; -
earthdistanceのバージョン 1.1 を使用するインデックスおよび生成済み列(直接使用する場合、またはSQL標準に準拠した本体を持つ関数を通じて使用する場合を含む)。 争いなどないだろう。 掲載されている各オブジェクトについては、earthdistanceを参照してください。WITH RECURSIVE used (fn, via, used_by) AS ( SELECT d.refobjid, d.refobjid, 'index ' || c.oid::pg_catalog.regclass::text FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_class AS c ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass AND c.oid = d.objid AND c.relkind IN ('i', 'I') WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass UNION SELECT d.refobjid, d.refobjid, 'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text FROM pg_catalog.pg_depend AS d LEFT JOIN pg_catalog.pg_attrdef AS ad ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass AND ad.oid = d.objid JOIN pg_catalog.pg_attribute AS a ON a.attgenerated = 's' AND ((a.attrelid = ad.adrelid AND a.attnum = ad.adnum) OR (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass AND a.attrelid = d.objid AND a.attnum = d.objsubid)) WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass UNION SELECT d.refobjid, u.via, u.used_by FROM used AS u JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn AND p.prosqlbody IS NOT NULL AND p.proconfig IS NULL JOIN pg_catalog.pg_depend AS d ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND d.objid = u.fn AND d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass ) SELECT e.extversion, u.via::pg_catalog.regprocedure AS used_function, u.used_by FROM used AS u JOIN pg_catalog.pg_depend AS m ON m.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND m.objid = u.fn AND m.refclassid = 'pg_catalog.pg_extension'::pg_catalog.regclass AND m.deptype = 'e' JOIN pg_catalog.pg_extension AS e ON e.oid = m.refobjid JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang WHERE e.extname = 'earthdistance' AND e.extversion IN ('1.0', '1.1') AND l.lanname = 'sql' AND p.proconfig IS NULL ORDER BY 2, 3; -
システムカタログ名や、 PostgreSQL の後のバージョンで削除された構成パラメータを使用するビュー、マテリアライズドビュー、集計関数、および関数。 「
removed_in」の列には、名前が含まれていない最初のバージョンが表示されています。removed_inのバージョンが、対象バージョン以下である行は存在しないと想定してください。 名前は、カタログ参照ではないテキストと一致する場合があるため、リストされている各オブジェクトを確認してください。 「削除されたシステム名を使用しているオブジェクト」 を参照してください。WITH removed (relation_name, identifier, removed_in) AS ( VALUES (NULL, 'pg_is_in_backup', 15), (NULL, 'pg_backup_start_time', 15), (NULL, 'pg_start_backup', 15), (NULL, 'pg_stop_backup', 15), ('pg_database', 'datlastsysoid', 15), (NULL, 'force_parallel_mode', 16), ('pg_stat_bgwriter', 'checkpoints_timed', 17), ('pg_stat_bgwriter', 'checkpoints_req', 17), ('pg_stat_bgwriter', 'checkpoint_write_time', 17), ('pg_stat_bgwriter', 'checkpoint_sync_time', 17), ('pg_stat_bgwriter', 'buffers_checkpoint', 17), ('pg_stat_bgwriter', 'buffers_backend', 17), ('pg_stat_bgwriter', 'buffers_backend_fsync', 17), (NULL, 'pg_stat_get_bgwriter_timed_checkpoints', 17), (NULL, 'pg_stat_get_bgwriter_requested_checkpoints', 17), (NULL, 'pg_stat_get_checkpoint_write_time', 17), (NULL, 'pg_stat_get_checkpoint_sync_time', 17), (NULL, 'pg_stat_get_bgwriter_buf_written_checkpoints', 17), (NULL, 'pg_stat_get_buf_written_backend', 17), (NULL, 'pg_stat_get_buf_fsync_backend', 17), ('pg_stat_progress_vacuum', 'max_dead_tuples', 17), ('pg_stat_progress_vacuum', 'num_dead_tuples', 17), ('pg_database', 'daticulocale', 17), ('pg_collation', 'colliculocale', 17), ('element_types', 'domain_default', 17), (NULL, 'interval_accum', 17), (NULL, 'interval_accum_inv', 17), (NULL, 'interval_combine', 17), ('pg_stat_wal', 'wal_write', 18), ('pg_stat_wal', 'wal_sync', 18), ('pg_stat_wal', 'wal_write_time', 18), ('pg_stat_wal', 'wal_sync_time', 18), ('pg_stat_io', 'op_bytes', 18), ('pg_backend_memory_contexts', 'parent', 18), ('pg_attribute', 'attcacheoff', 18) ), definitions (object_name, definition) AS ( SELECT 'view ' || c.oid::pg_catalog.regclass::text, pg_catalog.pg_get_viewdef(c.oid) FROM pg_catalog.pg_class AS c WHERE c.relkind IN ('v', 'm') AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace, 'information_schema'::pg_catalog.regnamespace) UNION ALL SELECT 'function ' || p.oid::pg_catalog.regprocedure::text, pg_catalog.concat_ws(' ', pg_catalog.pg_get_function_sqlbody(p.oid), pg_catalog.array_to_string(p.proconfig, ' ')) FROM pg_catalog.pg_proc AS p WHERE (p.prosqlbody IS NOT NULL OR p.proconfig IS NOT NULL) AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace, 'information_schema'::pg_catalog.regnamespace) UNION ALL SELECT 'aggregate ' || a.aggfnoid::pg_catalog.regprocedure::text, pg_catalog.concat_ws(' ', a.aggtransfn, a.aggfinalfn, a.aggcombinefn, a.aggmtransfn, a.aggminvtransfn, a.aggmfinalfn) FROM pg_catalog.pg_aggregate AS a JOIN pg_catalog.pg_proc AS p ON p.oid = a.aggfnoid WHERE p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace, 'information_schema'::pg_catalog.regnamespace) ) SELECT d.object_name, r.identifier, r.removed_in FROM definitions AS d JOIN removed AS r ON d.definition ~ ('\m' || r.identifier || '\M') AND (r.relation_name IS NULL OR d.definition ~ ('\m' || r.relation_name || '\M')) ORDER BY 3, 1, 2; -
アップグレードで使用できないデータベース名。 争いなどないだろう。 リストにあるデータベースを修正するには、その所有者が別のデータベースに接続し、名前を変更するデータベースにセッションが接続されていない状態で
ALTER DATABASE "<database_name>" RENAME TO <new_name>;を実行する必要があります。 また、所有者には「CREATEDB」属性が設定されている必要があります。 その後、データベースに接続するアプリケーションをすべて更新してください。SELECT datname FROM pg_catalog.pg_database WHERE pg_catalog.strpos(datname, '''') > 0 OR pg_catalog.strpos(datname, pg_catalog.chr(92)) > 0 OR pg_catalog.strpos(datname, '=') > 0 OR pg_catalog.strpos(datname, pg_catalog.chr(10)) > 0 OR pg_catalog.strpos(datname, pg_catalog.chr(13)) > 0 ORDER BY datname; -
アップグレードによってロックされるリレーション、大型オブジェクト、およびデプロイメントのロック容量。 値が最も高い4つのデータベースについて、
locked_relationsを合計してください。 PostgreSQL 14および15では、locked_relationsにはビューおよびマテリアライズド・ビューが含まれます。これは、アップグレードによってこれらもロックされるためです。 合計がlock_capacityを超えた場合は、max_locks_per_transactionlock_capacityが合計値を超えるようになるまで増加させます。 この変更によりデータベースが再起動されるため、アップグレードを実行する前にこの変更を行ってください。 テーブルの数が多い場合や、オブジェクトのサイズが大きい場合も変換に時間がかかるため、実際のスキーマとデータを使ってアップグレードの予行演習を行ってください。SELECT pg_catalog.current_database() AS database_name, (SELECT pg_catalog.count(*) FROM pg_catalog.pg_class AS c WHERE (c.relkind IN ('r', 'p', 'S') OR (c.relkind IN ('v', 'm') AND pg_catalog.current_setting('server_version_num')::integer < 160000)) AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace, 'information_schema'::pg_catalog.regnamespace)) AS locked_relations, (SELECT pg_catalog.count(*) FROM pg_catalog.pg_largeobject_metadata) AS large_objects, pg_catalog.current_setting('max_locks_per_transaction')::integer * (pg_catalog.current_setting('max_connections')::integer + pg_catalog.current_setting('max_prepared_transactions')::integer) AS lock_capacity; -
search_path設定がない関数で、インデックス、マテリアライズド・ビュー、および拡張統計情報が使用するもの。 このクエリは、演算子、ドメインチェック制約、およびSQL標準に準拠した本体を持つ関数を通じて呼び出しを実行します。 PostgreSQL 16 以前のバージョンから PostgreSQL 17 以降のバージョンにアップグレードする場合は、このクエリを実行してください。 本体内でpg_catalogの外にあるオブジェクトをスキーマを指定せずに参照しているリスト化された関数があると、アップグレード後にメンテナンスコマンドが失敗します。 関数が影響を受けないのは、その本体およびその関数が呼び出すすべての関数が、pg_catalog外のすべてのオブジェクトをそのスキーマで指定している場合に限られる。 その他のリストされている関数については、その所有者が「search_path」設定を追加します。詳細については、「 インデックス、パーティションキー、および生成列におけるSQL関数 」を参照してください。WITH RECURSIVE refreshed (relid, used_by) AS ( SELECT c.oid, c.oid::pg_catalog.regclass FROM pg_catalog.pg_class AS c WHERE c.relkind = 'm' UNION SELECT v.oid, f.used_by FROM refreshed AS f JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid JOIN pg_catalog.pg_depend AS d ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass AND d.objid = r.oid AND d.refclassid = 'pg_catalog.pg_class'::pg_catalog.regclass JOIN pg_catalog.pg_class AS v ON v.oid = d.refobjid AND v.relkind = 'v' ), refs (refclassid, refobjid, used_by) AS ( SELECT d.refclassid, d.refobjid, c.oid::pg_catalog.regclass FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_class AS c ON c.oid = d.objid AND c.relkind IN ('i', 'I') WHERE d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass UNION SELECT d.refclassid, d.refobjid, f.used_by FROM refreshed AS f JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid JOIN pg_catalog.pg_depend AS d ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass AND d.objid = r.oid UNION SELECT d.refclassid, d.refobjid, s.stxrelid::pg_catalog.regclass FROM pg_catalog.pg_depend AS d JOIN pg_catalog.pg_statistic_ext AS s ON s.oid = d.objid WHERE d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass ), used (fn, used_by) AS ( SELECT x.fn, r.used_by FROM refs AS r CROSS JOIN LATERAL ( SELECT r.refobjid AS fn WHERE r.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass UNION ALL SELECT o.oprcode::pg_catalog.oid FROM pg_catalog.pg_operator AS o WHERE r.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass AND o.oid = r.refobjid UNION ALL SELECT dc.refobjid FROM pg_catalog.pg_constraint AS con JOIN pg_catalog.pg_depend AS dc ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass AND dc.objid = con.oid AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass WHERE r.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass AND con.contypid = r.refobjid ) AS x UNION SELECT x.fn, u.used_by FROM used AS u JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn AND p.prosqlbody IS NOT NULL AND NOT EXISTS (SELECT 1 FROM pg_catalog.unnest(p.proconfig) AS setting WHERE setting LIKE 'search\_path=%') JOIN pg_catalog.pg_depend AS d ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND d.objid = u.fn CROSS JOIN LATERAL ( SELECT d.refobjid AS fn WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass UNION ALL SELECT o.oprcode::pg_catalog.oid FROM pg_catalog.pg_operator AS o WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass AND o.oid = d.refobjid ) AS x ) SELECT DISTINCT p.oid::pg_catalog.regprocedure AS function_name, u.used_by FROM used AS u JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang WHERE l.lanname NOT IN ('c', 'internal') AND p.prosqlbody IS NULL AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace, 'information_schema'::pg_catalog.regnamespace) AND NOT EXISTS (SELECT 1 FROM pg_catalog.unnest(p.proconfig) AS setting WHERE setting LIKE 'search\_path=%') AND NOT EXISTS (SELECT 1 FROM pg_catalog.pg_depend AS e WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND e.objid = p.oid AND e.deptype = 'e') ORDER BY 1, 2;
これらのチェックに合格したからといって、アップグレードが成功することや、アプリケーションが対象バージョンと互換性があることが保証されるわけではありません。 ステージング環境でのデプロイ時のリハーサルにおいてのみ、変換処理全体が実行されます。
アップグレード期間の計画
ステージングリハーサルを利用して、メンテナンスの実施期間を見積もってください。 変換にかかる時間は、主にデータベースとオブジェクトの数によって決まります。 HAメンバーの再構築にかかる時間は、データベースのサイズによって異なります。 ワークロードとトランザクションログの量は、チェック処理とキャッチアップ処理に影響を与えます。 書き込みがブロックされる時間だけでなく、アップグレード作業全体にかかる時間を考慮してください。
「開始期限」は、キューに入れられたアップグレードが開始できる最も遅い時刻を設定します。 デフォルトではリクエストから5分後になっていますが、最大24時間先まで設定可能です。 バックアップなどの処理や、以前にキューに登録されたリクエストがあると、開始が遅れます。 有効期限が切れるまでにアップグレードが開始されない場合、アップグレードは実行されず、そのタスクには「 有効期限切れ 」と表示されます。 有効期限が切れても、すでに開始されたアップグレードは中断されません。 たとえば、キューに入れられたリクエストは、UTC 22:30 に有効期限が切れます。 UTC 22:25 に開始されるタスクは、その時刻を過ぎてからも継続することがあります。
アップグレードの実行中は、デプロイに関するその他のリクエストは、アップグレードが完了するまで待機します。 これには、手動および自動のスケーリング、設定の変更、ユーザーおよびパスワードの変更、許可されるIPアドレスの変更、およびバックアップなどが含まれます。 アップグレードタスクがキューに登録されている間、または実行中の間は、デプロイメントを削除しないでください。
タスクが完了するまでは、読み取り専用レプリカを作成しないでください。 このサービスでは、そのようなリクエストをブロックしません。 作成した場合、アップグレードの事前チェックに失敗したり、新しいレプリカがアップグレードされたデプロイメントからレプリケーションを行えなくなったりする可能性があります。 そのようなレプリカを削除し、タスクが完了した後、新しいレプリカを作成してください。
UI でのアップグレード
- オンデマンドバックアップ を作成し、その内容を確認します。 このアップグレードでは、それが必要ありません。
- デプロイメントの「 概要 」ページで、「 メジャーバージョンのアップグレード 」をクリックします。
- 「ガイダンス」 ステップでは、ガイダンスを確認し、「 ガイダンスを読み、アップグレードを進める準備ができました 」を選択して、「 次へ 」をクリックしてください。 読み取りおよび書き込みが利用できない時期については、「 アップグレード中の可用性 」を参照してください。
- 「 バージョンへのアップグレード 」で、対象のバージョンを選択してください。 複数のターゲットが利用可能な場合、リストではデフォルトで最新のものが選択されます。 この手順にある「 読み取りレプリカ 」に関する注意事項は、すでに古くなっています。 デプロイメントに読み取り専用レプリカが1つでも関連付けられている場合、アップグレードの事前チェックに失敗するため、アップグレードを行う前にすべてのレプリカをプロモートするか削除してください。
- 「 アップグレード開始までの待機時間 」で、リクエストが開始されるまでの待機時間を選択します。 デフォルトは 5 分です。
- **「アップグレード」**をクリックします。 リクエストが待機中または実行中の間、「 概要 」ページの「 バージョン 」行には、「 アップグレードがキューに入れられています 」または「 アップグレードが進行中です 」と表示されます。
- 「 最近のタスク 」でそのタスクを確認してください。 書き込みが再開され次第、「 アップグレード後 」の項に記載されている手順に従って、統計情報を更新してください。 タスクのステータスが「 完了 」と表示されたら、そのセクションの残りの手順を完了させてください。 「 失敗 」と表示された場合は、「 トラブルシューティング 」を参照してください。 「有効期限切れ 」と表示されている場合は、アップグレードが開始されていません。有効期限を遅らせて再度送信してください。
API を使用したアップグレード
エンド /deployments/{id}/version ポイントにリクエスト PATCH を送信します。 version を対象のメジャーバージョンに設定し、 expiration_datetime クエリパラメータを使用して有効期限の開始日を設定します:
curl -X PATCH \
'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version?expiration_datetime=<EXPIRATION_TIME>' \
-H 'Authorization: Bearer <IAM_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"version": "18"}'
<EXPIRATION_TIME> を、リクエストから5分後から24時間後までの範囲で、 2026-11-03T22:30:00Z のようなISO 8601形式のUTC時刻に置き換えてください。 expiration_datetime を省略した場合、リクエストは5分以内に開始されない限り、タイムアウトとなります。
リクエストが成功すると、タスクが返されます。 リクエストが受理されたからといって、アップグレードが完了したわけではありません。 「 タスクに関する情報の取得 」でタスクIDを使用して、アップグレードの進捗状況を監視してください。 利用可能なターゲットを一覧表示するには、「 versions 」機能を使用して、
デプロイメントから機能情報を取得します。 すべてのパラメータについては、 APIリファレンス を参照してください。
CLI を使用したアップグレード
Cloud Databases CLIプラグインは、バージョン 0.20.0 以降を使用してください。 --expire-in または --expire-at を使用して、リクエストから5分後から24時間後までの範囲で有効期限の開始時刻を設定します。 デフォルトは 5 分です。
ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait
--nowait を指定しない場合、コマンドはタスクが完了するか失敗するまで待機します。 アップグレードが開始される前に有効期限が切れた場合、この関数は何も返しません。そのため、スクリプト内では --nowait を使用してください。 --nowait の場合、サービスがリクエストを受け付けた後にコマンドが終了します。 以下のコマンドでタスクを監視します deployment-tasks-list:
ibmcloud cdb deployment-tasks-list <NAME|CRN>
すべてのパラメータについて、 ibmcloud cdb deployment-version-upgrade --help を実行してください。
Terraformによるアップグレード
IBM Cloud® を使用してください。Terraform プロバイダーのバージョンは、 1.79.2 以降にしてください。 「 version 」を利用可能なターゲットに設定し、プランを確認してから適用します。 対象がインプレースアップグレードの対象外である場合、この計画は失敗します。
リソースの更新タイムアウトは、アップグレード全体が完了するのに十分な長さ、かつ少なくとも5分以上になるように設定してください。 プロバイダーは、このタイムアウト(最大24時間)を有効期限の開始時刻としても使用します。 したがって、キューに入れられたアップグレードは、タイムアウトが切れるまでの間、いつでも開始される可能性があります。 バックアップやその他の操作が実行中またはキューに登録されていない状態で変更を適用し、アップグレードが直ちに開始されるようにしてください。 アップグレードの開始後に適用処理がタイムアウトした場合でも、アップグレードは継続されます。
タイムアウトが経過してもアップグレードがまだキューに残っている場合、そのアップグレードは失効し、実行されません。 terraform plan または terraform apply を再度実行する前に、タスクが完了するまでお待ちください。
アップグレードタスクが失敗した場合は、 terraform apply を再度実行する前に、「 トラブルシューティング 」の手順を完了してください。 デプロイメントで依然としてソースバージョンが報告されている場合、Terraformはアップグレードを再度実行します。
Terraform 外部でアップグレードを行った後は、 version を新しいバージョンに設定するか、設定から version を削除してください。 Terraform 以外のアップグレードには、UI、CLI、または API でのアップグレード、および 強制アップグレード が含まれます。 設定を更新するまでは、そのデプロイメントを含むすべての terraform
plan および terraform apply が失敗し、同じ設定内の他のリソースへの変更が行えなくなります。 このエラーは、 Version 14 is not a valid upgrade version や No available upgrade versions for version 18 にあるものと同様です。
PostgreSQL では、 version_upgrade_skip_backup 引数はサポートされていません。 詳細については、 データベースリソースのリファレンスを参照してください。
アップグレード後
書き込みが再開されたら、直ちにオプティマイザの統計情報が完全であることを確認してください。 タスクの完了を待機しません。 SHOW default_transaction_read_only; が新しいセッションで off を返すようになると、書き込みが再開されます。 各データベースにおいて、次のクエリを実行すると、統計情報が設定されていないテーブルおよびマテリアライズド・ビューの一覧が表示されます。 リストされている各リレーションについて、
ANALYZE <table_name>; を実行してください。 ユーザーがリレーションを分析する権限を持っていない場合は、リレーションの所有者としてコマンドを実行してください。 パーティション化されたテーブルを分析すると、そのパーティションも分析されます。
SELECT c.oid::pg_catalog.regclass AS relation_name
FROM pg_catalog.pg_class AS c
WHERE c.relkind IN ('r', 'm', 'p')
AND c.reltuples < 0
AND NOT c.relispartition
AND c.relpersistence <> 't'
AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
'information_schema'::pg_catalog.regnamespace)
AND NOT EXISTS (SELECT 1
FROM pg_catalog.pg_depend AS e
WHERE e.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
AND e.objid = c.oid
AND e.deptype = 'e');
PostgreSQL 17 以降では、 ANALYZE を実行すると、「 function ... does not exist 」といったエラーが発生し、処理が失敗する場合があります。 その場合は、自己チェッククエリ 17 に記載されている関数を修正し、 ANALYZE を再度実行してください。 データベース全体の ANALYZE がエラーで停止した場合、残りのテーブルは分析されません。
PostgreSQL 18 では、 psql コマンド( \dX )で一覧表示される統計オブジェクトを持つ各テーブル、および PostGIS 列を含む各テーブルについても分析を行ってください。これは、アップグレード時にこれらの統計情報が引き継がれないためです。
タスクのステータスが「 完了 」と表示された後:
-
コンソールまたはAPI上で、デプロイのバージョンがターゲットバージョンを示していること、および
SHOW server_version;がそのバージョンを返すことを確認してください。 セルフチェッククエリ 1 を実行し、すべての HA メンバーがストリーミングを行っていることを確認してください。 また、すべてのデータベースで書き込みが再開されたことを確認してください。以下のクエリでは、行が返されません。 HAメンバーが欠落している場合、pg_basebackupという名前の行が残っている場合、またはクエリにデータベースがリストされている場合は、サポートまでご連絡ください。SELECT d.datname AS database_name, s.setconfig FROM pg_catalog.pg_db_role_setting AS s JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase WHERE s.setrole = 0 AND d.datallowconn AND NOT d.datistemplate AND EXISTS (SELECT 1 FROM pg_catalog.unnest(s.setconfig) AS c(setting) WHERE c.setting LIKE 'default_transaction_read_only=%'); -
拡張機能を更新します。 このアップグレードでは、各拡張機能はインストール済みのバージョンのまま維持されます。 各データベースにおいて、新しいバージョンが存在する拡張機能を一覧表示し、それぞれを更新してください:
SELECT name, installed_version, default_version FROM pg_catalog.pg_available_extensions WHERE installed_version <> default_version;ALTER EXTENSION <extension_name> UPDATE;PostgreSQL 14、15、または16から PostgreSQL 17以降にアップグレードした場合、
pg_stat_statementsを更新すると、そのblk_read_timeおよびblk_write_time列の名前が、それぞれshared_blk_read_timeおよびshared_blk_write_timeに変更されます。 これらの列を読み取るクエリを更新してください。 -
準備 の手順に従って、拡張機能とマスキングを復元してください。 エクスポートしたデータから、
UNLOGGEDのテーブルを再読み込みします。 各UNLOGGEDシーケンスを、現在使用中の値よりも大きい値に設定します。例えば、SELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));のように設定します。 削除した論理レプリケーションスロット、サブスクリプション、および読み取り専用レプリカを再作成し、無効化していたサブスクリプションを有効にしてください。 依存するアプリケーションの処理を再開する前に、消費者との接続を再確立し、データの再同期を行ってください。 -
データベースに対して
default_transaction_read_onlyを設定した場合は、再度設定してください。 このアップグレードにより、すべてのデータベースでこの設定がリセットされるため、それらのデータベースは再び書き込みを受け付けるようになります。 -
アップグレード後のバックアップ が完了したことを確認してください。 データベース全体をコピーするため、数時間かかる場合があります。 アップグレード後に加えられた変更について、特定時点への復旧が必要な場合は、その時点までアプリケーションの書き込みを一時停止しておいてください。
-
PostgreSQL 14 または 15 から PostgreSQL 16 以降にアップグレードした場合は、「 バージョンアップ時のロール権限に関する問題 」に記載されているロールクエリを実行してください。 ロールを管理するジョブを再開する前に、記載されているロールを付与してください。
-
Terraform がデプロイを管理しており、Terraform 以外でアップグレードを行った場合は、「 Terraform を使用したアップグレード 」の説明に従って、
versionを新しいバージョンに設定するか、削除してください。 -
一時停止していたアプリケーションの書き込み処理およびスケジュールされたジョブを再開します。
synchronous_commitなど、アップグレードのために変更した設定を元に戻してください。 -
新しいバージョンの PostgreSQL では新しいUnicodeデータが使用されるため、Unicodeデータに依存するオブジェクトを再構築してください:
- PostgreSQL 16から PostgreSQL 17へアップグレードした場合を除き、インデックス、マテリアライズド・ビュー、チェック制約、および式に
normalize()またはis_normalized()を使用しているパーティションキーを確認してください。 影響を受けるのは、新しいUnicodeバージョンで追加された文字を含むテキストのみです。 - PostgreSQL 17 から PostgreSQL 18 へアップグレードした場合は、
unicode_assigned()を使用しているオブジェクトも確認してください。 また、組み込みのC.UTF-8ロケールにおいて、テキストに対して正規表現、ILIKE、lower()、upper()、またはinitcap()を適用するオブジェクトについても確認してください。pg_c_utf8の照合順序、およびC.UTF-8でbuiltinロケールプロバイダを使用するデータベースは、このロケールを使用します。 - PostgreSQL 18 にアップグレードし、データベースで「
icu」または「builtin」ロケールプロバイダーが使用されている場合は、そのフルテキスト検索インデックスおよびpg_trgmインデックスを再構築してください。
影響を受ける各インデックスに対して「
REINDEX INDEX <index_name>;」を実行し、影響を受ける各マテリアライズド・ビューに対して「REFRESH MATERIALIZED VIEW <view_name>;」を実行してください。 行が、影響を受けるチェック制約を依然として満たしており、かつ正しいパーティションに属していることを確認してください。 - PostgreSQL 16から PostgreSQL 17へアップグレードした場合を除き、インデックス、マテリアライズド・ビュー、チェック制約、および式に
-
アプリケーションの動作やパフォーマンスを、ステージング環境での結果と比較してください。
トラブルシューティング
サービスがリクエストを拒否した場合、エラーが直ちに表示されます。 UIには通常、「 アップグレードに失敗しました 」というメッセージと理由が表示され、APIはエラーメッセージを返し、CLIはヒント付きのエラーを出力します。 リクエストを修正して、再度送信してください。
タスクのステータスが「 期限切れ 」と表示されている場合、アップグレードは開始されておらず、デプロイメントの状態は変更されていません。 他の操作が実行中またはキューに入っていない状態で、アップグレードを再度送信するか、開始期限を遅らせて設定してください。
後で「 失敗 」と表示されるタスクでは、どのチェックやステップで失敗したのかが特定されず、UIにも原因が表示されません。 失敗したステップに応じて、デプロイは以下のいずれかの状態になります:
- ソースバージョンについて :デプロイではソースバージョンが実行され、書き込みを受け付けます。 事前チェックに失敗すると、デプロイメントはこの状態となり、読み取り専用モード中のほとんどの障害発生後、サービスは書き込みアクセスを復旧させます。 失敗した試みであっても、長期的な影響を残すことがある。 これにより、
old_snapshotを削除したり、UNLOGGEDのテーブルを空にしたり、UNLOGGEDのシーケンスをリセットしたりすることができ、PITRの復旧範囲にギャップが生じる可能性があります。 また、データベースレベルのdefault_transaction_read_only設定をリセットすることもできるため、それらのデータベースは再び書き込みを受け付けるようになります。 いずれかのデータベースに対してdefault_transaction_read_onlyをonに設定している場合、試行が失敗すると、事前チェックが失敗した場合であっても、すべてのクライアントセッションが終了します。 - ターゲットバージョンについて :デプロイではターゲットバージョンが実行されますが、サポートチームによる処理が完了するまではアップグレードは未完了となります。 コンソールとAPIでは、引き続きソースバージョンを表示できます。 それまでは、HAメンバーが起動しない可能性があり、バックアップやトランザクションログのアーカイブが失敗する恐れがあります。 セルフチェックのクエリ1または5で問題が検出された場合は、サポートチームがアップグレードを完了するまで、アプリケーションの書き込みを一時停止してください。
- 障害中 :サポートによる復旧が行われるまで、デプロイメントは読み取り専用または利用不可のままであるか、あるいはHAメンバーなしで実行されます。 変換フェーズまたは再起動フェーズで障害が発生すると、書き込みが再開された後でも、サポートチームが再起動を行うまでHAメンバーが停止したままになる可能性があります。
状態を確認するには、 admin として接続し、 SHOW server_version; を実行してください。 使用する各データベースで、 SHOW default_transaction_read_only; を実行してください。 セルフチェッククエリ 1 を実行し、すべての HA メンバーがストリーミングを行っていることを確認します。
認証エラーなどの理由でタスクが失敗し、 admin が接続できない場合は、サポートまでご連絡ください。 このアップグレードによって、お客様の認証情報は変更されません。
デプロイメントが書き込みを受け付け、ソースバージョンを実行しており、すべてのHAメンバーがストリーミングを行っている場合は、 事前チェック を確認し、 自己診断クエリ を実行してください。 未解決の項目をすべて解決し、オンデマンドバックアップを実行してから、アップグレードを再度実行してください。 それ以外の場合は、あるいは次の試みも失敗した場合は、再試行やその他の変更を行う前に、 サポートまでご連絡ください。 組み込み:
- デプロイメントのCRNと、失敗したタスクのID。 タスクが失敗した際は、タスクIDを記録しておいてください。タスクリストには直近のタスクしか表示されないためです。
- ソースおよび指定されたターゲットの PostgreSQL のバージョン、および
SHOW server_version;の実行結果。 - おおよその障害発生時刻およびタイムゾーン。
- アプリケーションが接続、読み取り、書き込みを行えるかどうか。
- 自己診断クエリの出力結果。
- 最近昇格または削除されたレプリカを含め、関連する各読み取り専用レプリカのCRN。
リクエストが内部エラーにより失敗した場合は、サポートまでご連絡ください。 UI上では、このエラーは「 インプレースアップグレードタスクの作成に失敗しました 」というメッセージとともに「 アップグレードに失敗しました 」と表示されます。 また、実際の理由を表示できない場合、UIでは他の却下されたリクエストに対してもこのメッセージが表示されます。 その理由を確認するには、CLI または API を使用してリクエストを送信してください。
また、タスクの処理時間がリハーサル時よりも大幅に長引く場合は、サポートまでご連絡ください。 失敗後、サービスが復旧を試みている間、タスクは「進行中」の状態(CLIおよびAPIではステータス「 running 」)のままとなる場合があります。
準備手順および自己チェックの質問項目に挙げられているオブジェクトのみを削除してください。 チェックをすり抜けるために、他の物を落とさないでください。 その場合は、サポートまでお問い合わせください。
読み取り専用レプリカからのアップグレード
ソースのデプロイメントから 読み取り専用のレプリカを作成し、レプリカの同期が完了するまで待ちます。 次に、 /remotes/promotion エンドポイント を使用して、レプリカをプロモートおよびアップグレードします。 version を、レプリカがその機能一覧に記載しているターゲットに設定します:
curl -X POST \
https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
-H 'Authorization: Bearer <IAM_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"promotion": {
"version": "18",
"skip_initial_backup": false
}
}'
プロモーションによって実行される初期バックアップをスキップしたい場合のみ、 skip_initial_backup を true に設定してください。 この設定により、プロモーション作業の時間を短縮できますが、プロモーション後の環境を復旧するには、その後、スケジュールされたバックアップまたはオンデマンドのバックアップを正常に実行する必要があります。
バージョンアップを伴うプロモーションが失敗した場合、サービスはプロモーション対象のデプロイメントを無効化します。 サポートにお問い合わせください。 本番環境への展開をレプリカ上でバージョンアップを伴うプロモーションとしてリハーサルを行い、実際に運用に投入する前に確認してください。
バックアップを復元してアップグレードする
サポート対象のターゲットバージョンを使用しているデプロイメントに、 バックアップを復元します。 CLI または API を使用してバックアップを復元する際、リソース割り当てパラメータを指定しない場合、新しいデプロイメントでは、バックアップが作成された時点でのソースデプロイメントのリソース割り当てが使用されます。 UIでは、復元ページにはソースのデプロイメントの現在の割り当てが初期表示されますが、これを変更することができます。
UI でのバックアップのリストア
デプロイメントダッシュボードの「 バックアップと復元 」から、使用したいバックアップの「 バックアップを復元 」をクリックします。 表示されたページで、「 データベースのバージョン 」からサポートされているターゲットバージョンを選択し、新しいデプロイメントのオプションを設定してください。 次に、「 バックアップを復元 」をクリックします。
CLI を使用したバックアップの復元
-p のJSON引数にターゲットバージョンとバックアップIDを指定して、デプロイメントを作成します:
ibmcloud resource service-instance-create example-upgrade databases-for-postgresql standard us-south \
-p '{
"backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
"version": "18"
}' \
--service-endpoints "public"
API でのバックアップのリストア
Resource コントローラー API を使用して、バックアップを、対象バージョンが実行されている新しいデプロイメントに復元します。 デプロイメント名、場所、リソースグループ、プラン、バックアップ ID、およびターゲットバージョンを指定してください:
curl -X POST \
https://resource-controller.cloud.ibm.com/v2/resource_instances \
-H 'Authorization: Bearer <IAM_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"name": "my-instance",
"target": "bluemix-us-south",
"resource_group": "5g9f447903254bb58972a2f3f5a4c711",
"resource_plan_id": "databases-for-postgresql-standard",
"parameters": {
"backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
"version": "18"
}
}'
強制アップグレード
サポート終了日以降、非推奨バージョンを実行しているすべてのアクティブな Databases for PostgreSQL デプロイメントは、自動的に次のサポート対象バージョンにアップグレードされます。
強制アップグレードはIPMVUに該当するため、サポート終了日までに IPMVUの準備 を完了してください。
以下のようなリスクを避けるため、耐用年数終了前にアップグレードすること:
- このタイプの強制アップグレードにはSLAは提供されない。
- データが一部失われる可能性があります。
- アプリケーションが長時間停止する可能性があります。
- 新しいバージョンと互換性がない場合、アプリケーションが動作しなくなる可能性があります。
- このアップグレードのタイミングは、あなたの配備では制御でき ません。
- この強制アップグレードにはロールバック処理はありません。
- Terraformがデプロイを管理し、
versionを設定している場合、強制アップグレード後は、versionを更新するまで、すべてのterraform planが失敗します。
サポート終了日については、 バージョンポリシーページ をご覧ください。
バージョンアップ時のロール権限に関する問題
PostgreSQL 16 以降では、 admin のように「 CREATEROLE 」属性を持つロールは、それを管理するために別のロールに「 ADMIN OPTION 」属性が必要です。 ロールの管理には、パスワードや属性の変更、ロールの削除、およびメンバーシップの付与が含まれます。 PostgreSQL 14 または 15 から 16 以降へアップグレードしても、アップグレード前に存在していたロールについては、
admin にこのオプションが表示されません。 パスワードのローテーションなど、 admin としてこれらのロールを管理するジョブは、その結果、失敗してしまいます。 詳細については、『 PostgreSQL 16』のリリースノート、
ロール属性、 およびロールの権限付与を参照してください。
たとえば、パスワードの変更が失敗すると、次のようなメッセージが表示されます:
ERROR: permission denied to alter role
DETAIL: To change another role's password, the current user must have the CREATEROLE attribute and the ADMIN option on the role.
アップグレードを行う前に、 admin として以下のクエリを実行してください。 ここでは、UI、CLI、またはAPIを使用して作成したユーザーを除き、アップグレード後に admin で管理できなくなるロールの一覧を示しています。 PostgreSQL 16 以降では、 admin でもこれらのユーザーを変更することはできないため、UI、CLI、または API を使用して管理してください。
SELECT r.rolname AS role_name,
pg_catalog.pg_has_role(r.oid, 'admin'::name, 'MEMBER') AS member_of_admin
FROM pg_catalog.pg_roles AS r
WHERE NOT r.rolsuper
AND NOT r.rolreplication
AND r.rolname <> 'admin'
AND r.rolname !~ '^(pg_|ibm-)'
AND NOT EXISTS (
SELECT 1
FROM pg_catalog.pg_auth_members AS m
JOIN pg_catalog.pg_roles AS b ON b.oid = m.roleid
WHERE m.member = r.oid
AND b.rolname IN ('ibm-cloud-base-user', 'ibm-cloud-base-user-ro'))
AND NOT pg_catalog.pg_has_role(r.oid, 'MEMBER WITH ADMIN OPTION')
ORDER BY 1;
リストに登録されたロールを引き続き管理するには、アップグレードする前に、そのロールを admin に付与してください:
GRANT <role_name> TO admin WITH ADMIN OPTION;
member_of_admin の値が t であるロールに対して、この付与は失敗します。これは、そのロールが admin のメンバーであるためです。 アップグレード後、 admin ではそのようなロールを管理できなくなります。
PostgreSQL 16 以降にアップグレードした後、クエリを再度実行してください。 member_of_admin の値が f となっている各リストされたロールについて、 ibmclouddb または postgres 以外のデータベースに接続した状態で、以下のヘルパーを実行してください。 他の役割を含めないでください。1つの助成申請が不承認になると、その公募全体が取り消されてしまうためです。
このヘルパーは、何度でも安全に実行できます:
SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');
これらの権限付与により、 admin もそのロールのメンバーとなるため、 admin はそのロールの権限を利用できるようになります。