OCI Database with PostgreSQLのメジャー・バージョン・アップグレード・ガイド

• pg_dumpおよびpg_restoreは、論理バックアップ・ツールです。
• メジャー・バージョン・アップグレードに適しています。
• 最終スイッチオーバー中の停止時間が必要です。
• ロールは常に個別に処理する必要があります。

pg_dumpおよびpg_restoreを使用したアップグレード・プロセスは、次のステップで構成されます。

1. ステップ1: グローバル・オブジェクトのダンプ(ロール)

   このステップにより、すべてのロール、権限およびアクセス制御が保持され、ユーザーおよびアプリケーションがアップグレード後に一貫したアクセスを維持できるようになります。

2. ステップ2: データベースのダンプ

   このステップでは、データベースの完全な論理バックアップを作成し、アップグレードされた環境にデータを転送するための信頼できる方法を提供します。

3. ステップ3: グローバル・ダンプ・ファイルの変更

   このステップでは、必要に応じてダンプを確認および調整できるため、ターゲットのPostgreSQLバージョンとの互換性とよりスムーズなリストア・プロセスを確保できます。

4. ステップ4: グローバル・オブジェクトのリストア

   最初にロールをリストアすると、データが再導入される前に適切なユーザーおよび権限が確保され、一貫性のあるセキュアな環境がサポートされます。

5. ステップ5: データベースのリストア

   このステップでは、アップグレードされたシステムにデータを取り込み、移行を完了し、データベースを新しいPostgreSQLバージョンで使用できるようにする。

• 使用可能なCPUに基づいて、より高い-j値を使用します。
• ダンプ中に-Z0を使用すると、パフォーマンスが向上します。
• 十分なディスクI/O容量を確保する
• 詳細ログを使用してリストアの進行状況を監視する

リストアが完了したら、次のタスクを実行します。

• 行数の検証

  このタスクは、すべてのデータが正常に移行されたこと、およびソース・データベースとターゲット・データベースの間に相違がないことを確認するのに役立ちます。

• アプリケーション接続の確認

  このタスクにより、アプリケーションは、アップグレードされたデータベースを想定どおりに接続して操作できるようになります。

• ロールと権限の検証

  このタスクは、ユーザーおよびロールが新しい環境で適切なアクセスおよび権限を持っていることを確認するのに役立ちます。

• 各データベースに対して次のコマンドを実行します。

  VACUUM ANALYZE <database_name>;

  このコマンドは、問合せプランナで使用される内部統計の更新に役立ち、OCI PostgreSQLは現在のデータに基づいてより効率的な実行計画を生成できます。また、リストア後の全体的なパフォーマンスの最適化(特に、複雑な問合せを使用する大規模なデータベースまたはワークロードの場合)にも役立ちます。

• 両方のデータベース・システムが同じVCN内にある場合、接続は自動的に使用可能になります。
• If databases are in different VCNs within the same region, configure the Local Peering Gateway (LPG) to establish communication.
• データベースが異なるリージョン内の異なるVCNsにある場合は、動的ルート・ゲートウェイ(DRG)を構成して通信を確立します。

ソース(以前のバージョン)データベースとターゲット(後のバージョン)データベースの両方で次のステップを実行します。

1. Oracle Cloudコンソールにサインインし、OCI PostgreSQLデータベース・システムに移動します。
2. 構成ファイルにアクセスして、構成を変更します。
3. 「構成のコピー」を選択し、必要なパラメータを更新します。「ユーザー変数(読取り/書込み)」で、次の手順を実行します。
   • wal_level = logical
   • track_commit_timestamp = 1
4. 拡張の有効化: 「拡張機能の構成」で、pglogicalを選択し、構成を作成します。
5. データベース・システムにナビゲートし、「構成」で「編集」を選択して、以前に作成した構成をデータベース・システムに適用します。

   データベース・システムの状態は、最初は更新中です。「アクティブ」になるまで待ってから続行します。

   この構成では、必要な設定および拡張を有効にすることで、両方の環境を論理レプリケーション用に準備し、アップグレード・プロセス中にpglogicalがソース・データベースとターゲット・データベース間で変更を確実に取得および同期できるようにします。

6. データベース・システムがアクティブになったら、データベースに接続し、次の問合せを使用して有効な拡張機能を確認します。

   SHOW oci.admin_enabled_extensions;

7. 次のコマンドを使用して、pglogical拡張を作成します。

   CREATE EXTENSION pglogical;

管理ユーザー(OCI PostgreSQLデータベースの作成時に指定したユーザー)としてログインし、論理レプリケーションを有効にするために必要な権限を付与します。

alter role xxx with replication; 
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_reset() to xxx ; 
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx ; 
grant all on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx;

xxxは、データベース・システムのプロビジョニング中に作成されたサンプル・ユーザーです。

管理ユーザー(OCI PostgreSQLデータベースの作成時に指定したユーザー)としてログインし、論理レプリケーションを有効にするために必要な権限を付与します。

alter role xxx with replication;
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_reset() to xxx ;
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx ;
grant all on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx;

xxxは、データベース設定時に作成されるサンプル・ユーザーです。

続行する前に、次のことを確認してください。

• 必要なすべてのスキーマおよびオブジェクトがターゲットに存在します

  アイテムには、スキーマ、表、索引、拡張機能および必要なデータベース・オブジェクトが含まれます。これらを設定することで、依存関係の欠落によるエラーなしでレプリケーション操作またはリストア操作を続行できます。スキーマ・リストを比較し(たとえば、\dnおよび\dtをpsqlで使用)、必要な拡張がソースとターゲットの両方にインストールされていることを検証することで、存在を確認できます。

• データベース構造がソースと一致する

  ターゲット・データベースは、スキーマ定義、オブジェクト名および全体的な構造に関して、ソースと密接に連携している必要があります。この一貫性は、スムーズなデータ移行をサポートし、同期中の競合や不整合の可能性を低減するのに役立ちます。スキーマ定義を確認するか(pg_dump --schema-onlyの使用など)、またはソース・システムとターゲット・システム間で表構造とオブジェクト数を比較して検証します。

1. ターゲット・データベースにサブスクライバ・ノードを作成します。

   SELECT pglogical.create_node(node_name := 'subscriber1', dsn := 'host=<target_database_fqdn> port=5432 user=xxx password=xxxxx dbname=pglogical_target');

   • node_name: ターゲット・データベースでサブスクライバの名前を定義します。
   • host: ターゲット・データベースの完全修飾ドメイン名(FQDN)を入力します。
   • port_number: ターゲット・データベースが稼働しているポートを入力します。
   • database_name: サブスクリプションが作成されるデータベースの名前を指定します
2. バックグラウンド同期およびレプリケーション・プロセスを開始するためのサブスクリプションを作成します。

   SELECT pglogical.create_subscription(subscription_name := 'subscription1', provider_dsn := 'host=<source_database_fqdn> port=5432 user=xxx password=xxxxxx dbname=pglogical_source sslmode=require');

   • subscription_name: サブスクリプションの名前を指定します。
   • host: ソース・データベースのFQDNを指定します。
   • port_number: ターゲット・データベースが稼働しているポートを指定します。
   • database_name: ソース・データベースの名前を入力します。

1. サブスクリプション・ステータス(ターゲット)の確認: 次の文を実行して、ターゲット・データベースのサブスクリプションのステータスを確認します。

   SELECT * FROM pglogical.show_subscription_status();

2. レプリケーション・ステータス(ソース)の確認: 次の文を実行して、ソース・データベース上のレプリケーションのステータスを確認します。

   SELECT * FROM pg_stat_replication;

両方のチェックで、ラグまたは保留中の変更がないアクティブ・ステータスが示されている場合、この結果では、レプリケーションが完了し、ターゲット・データベースがソースと完全に同期していることが示されます。

詳細なステップおよび説明を含むpglogicalの詳細は、「pglogical拡張機能を使用したOCI Database with PostgreSQLのリージョン間の同期」を参照してください