読み取り専用レプリカ

Databases for PostgreSQL読み取り専用のレプリカは、非同期レプリケーションによって、すべてのデータをリーダー配置からレプリカ配置にレプリケートします。 名前が示すとおり、読み取り専用レプリカは読み取りトランザクションをサポートするので、書き込み中心の操作と読み取り中心の操作の両方があるデータベースの負荷を分散させることができます。 読み取り専用レプリカの PostgreSQL データ・メンバーは 1 つであり、リーダーと同じようにメンバー当たりの消費レートが課金されます。

高可用性の読み取り専用レプリカ

高可用性のDatabases for PostgreSQL 読み取り専用レプリカは、読み取りスケーラビリティの向上、可用性の向上、読み取り待ち時間の短縮、バックアップとディザスタリカバリ機能、読み取りトラフィックの効率的な分散機能などの利点を提供します。 これは、アプリケーションのための、より堅牢で応答性の高いデータベース・インフラストラクチャに貢献します。 詳細については、高可用性読み取り専用レプリカ を参照してください。

リーダー

Databases for PostgreSQL のデプロイメントの 「読み取り専用レプリカ 」タブでは、読み取り専用レプリカがプロビジョニングされる前は、中央のペインに「読み取り専用レプリカは存在しません」と表示され、「 作成 」ボタンが表示されます。

デプロイメントがリーダーであり、既に読み取り専用レプリカが接続されている場合、_「複製」_ペインには、レプリカ・デプロイメントのリストと、各デプロイメントへのリンクが表示されます。 読み取り専用レプリカのデプロイメント名の右側にある歯車アイコンをクリックして、そのレプリカを管理します。

読み取り専用レプリカのプロビジョニング

PostgreSQL デプロイメントのリソースはデプロイメントごとに割り振られ、通常のデプロイメントには 2 つのメンバーがあります。 読み取り専用レプリカにはメンバーが1つしかないため、また、プロビジョニングでは現在、メモリとストレージについて要求値の半分が使用されていることから、プロビジョニングが失敗する可能性があります。 Web UI ではストレージの値を変更することはできず、リーダーのデプロイメントの値が自動的に使用されます。その値は半分に削減されています。 それでもデータが収まらない場合は、API または CLI を使用して、プロビジョニングしたいストレージ容量の 2 倍を指定する必要があります。 (メモリについても同様ですが、メモリ容量が少なくても復元が正常に行えないとは限りません。)

UIによるプロビジョニング

リーダーの「 レプリカを読み込む 」タブで、「 読み取り専用レプリカを作成する 」をクリックして、読み取り専用レプリカをプロビジョニングします。 ソースインスタンスは自動的に完了します。 読み取り専用レプリカの名前は_「サービス名」_フィールドに自動生成されますが、自由に名前変更できます。 レプリカをデプロイするリージョンと、初期メモリー割り振り量を選択できます。 ディスク・サイズ、バージョン、パブリック・エンドポイントまたはプライベート・エンドポイントは、リーダーのデプロイメントの設定に合わせて自動的に構成されます。

Key Protect を使用する場合は、CLI と API でプロビジョニングしないと、Bring Your Own Key (BYOK) がサポートされません。 それ以外でプロビジョンすると、読み取り専用レプリカは、生成された鍵で暗号化されます。

CLIによるプロビジョニング

CLI および API で読み取り専用レプリカをプロビジョニングする作業は、標準の Databases for PostgreSQL デプロイメントをプロビジョニングする作業と似ています。 プロビジョニングはリソース・コントローラーで処理され、パラメーター {"remote_leader_id": "crn:v1:..."} を使用して、プロビジョニングするレプリカのリーダーを指定します。

CLIで読み取り専用レプリカをプロビジョニングするには、次のようなコマンドを使用します:

ibmcloud resource service-instance-create <READ-REPLICA-NAME> databases-for-postgresql standard <REGION> -p '{ "remote_leader_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71819::", "members_memory_allocation_mb": "32768", "members_disk_allocation_mb": "20480"}' --service-endpoints public

最小サイズはRAM 8GB、ディスク10GBであることを念頭に、RAMとディスクの両方の容量を指定する必要があります。 オプションで、読み取り専用レプリカでパブリックとプライベートのどちらのエンドポイントを使用するかを指定します。 読み取り専用レプリカのバージョンは指定できません。 このバージョンは、リーダーのデプロイメントと同じメジャー・バージョンに自動的に設定されます。

API を使用したプロビジョニング

APIを通じて読み取り専用のレプリカをプロビジョニングすることは、標準的なDatabases for PostgreSQLデプロイメントのプロビジョニング と同様に機能します。 プロビジョニングはリソース・コントローラーで処理され、パラメーター {"remote_leader_id": "crn:v1:..."} を使用して、プロビジョニングするレプリカのリーダーを指定します。

APIを通じて読み取り専用のレプリカをプロビジョニングするには、以下のようなコマンドを使用する:

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<REPLICA_NAME_OR_CRN>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP_ID>",
    "resource_plan_id": "databases-for-postgresql-standard",
    "parameters": {
      "remote_leader_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71819::",
      "members_memory_allocation_mb": "2048",
      "members_disk_allocation_mb": "10240"
    }
  }'

最小サイズはRAM 8GB、ディスク10GBであることを念頭に、RAMとディスクの両方の容量を指定する必要があります。 オプションで、読み取り専用レプリカでパブリックとプライベートのどちらのエンドポイントを使用するかを指定します。 読み取り専用レプリカのバージョンは指定できません。 このバージョンは、リーダーのデプロイメントと同じメジャー・バージョンに自動的に設定されます。

読み取り専用レプリカ

読み取り専用レプリカの [ 読み取りレプリカ ] タブでは、[ レプリケーション ] 欄に、そのレプリカの名前とリージョン、およびそのリーダーの名前とリージョンが表示されます。 また、読み取り専用レプリカを再同期するボタンや、プロモートするボタンもあります。

レプリケーション状況の確認

レプリケーションの状態は自動的に監視されないので、レプリケーションを監視する必要があります。

psql を使用して読み取り専用レプリカのレプリケーションステータスを確認しますが、これはそのリーダーからのみ実行してください。 管理者アカウントの認証情報 を使用して、 psql 経由でリーダーのデプロイメントに接続します。 接続が完了したら、次のコマンドを実行してください:

SELECT * from pg_stat_replication;

レプリケーション・ラグの出力を監視する場合、 application_name はレプリカのフォーメーションID、つまりクラウド・リソース名(CRN)の最後に入力されたセクションを参照していることに注意してください。 レプリケーション中に「async」の sync_state 値、「Streaming」の state 値、および時間統計を探してください。

デプロイメントには常に HA ペアノードのレプリカがあり、 application_name はメインのデプロイメントと同じで、 sync_state 値は「sync」になります。 各読み取り専用レプリカには、追加の出力行が期待される。 application_name は異なり、 sync_state は "async "となる。 そして、クエリー結果によって提供される追加情報と同期しているかどうかを評価することができる。

細については、 pg_stat_replicationを参照してください。

読み取り専用レプリカのユーザーと特権

  • リーダーのユーザーは、読み取り専用レプリカをプロビジョニングする前に存在していたユーザーであっても、リーダーのオブジェクトに対して持っている特権と同じ特権で、読み取り専用レプリカにログインして読み取りを実行することができます。

  • 1 つのリーダーに複数の読み取り専用レプリカを関連付けた場合、リーダーで作成したユーザーは、他のすべての読み取り専用レプリカにも作成されます。

  • adminユーザーを含め、リーダーで作成したユーザーは、読み取り専用レプリカをスタンドアロン・デプロイメントにプロモートしてもレプリカに存在し続けます。 読み取り専用レプリカをプロモートすると、リーダーのすべてのユーザーと特権が、プロモートしたデプロイメントに転送されます。

  • 読み取り専用レプリカに対する書き込み操作は、すべてのユーザーについてフィルタリングまたは拒否されるわけではなく、データベース・レベルで機能しなくなります。

読み取り専用レプリカにはアクセスできるが、読み取り専用レプリカからリーダーにアクセスすることはできないユーザーを作成することもできます。 1 つのリーダーに複数の読み取り専用レプリカを関連付けた場合に、いずれかの読み取り専用レプリカでユーザーを作成すると、そのユーザーは他のすべての読み取り専用レプリカにも作成されます。

ある読み取り専用レプリカで作成した読み取り専用レプリカ・ユーザーは、それらのレプリカに接続して読み取りを実行することができます。 読み取り専用レプリカ・ユーザーは、リーダーに接続して操作を実行することはできません。 また、読み取り専用レプリカをスタンドアロン・デプロイメントにプロモートすると、存在しなくなります。

読み取り専用レプリカで作成したユーザーには、リーダーから特権が割り当てられ、ibm-cloud-base-user-ro 役割が割り当てられ、 ibm-cloud-base-user グループのメンバーになります。 サービス資格情報、CLI、または API を使用して作成されたリーダーのすべてのユーザーを含め、このグループの他のメンバーによって作成されたすべてのオブジェクトにアクセスできます。 ibm-cloud-base-user の権限設定に従い、読み取り専用レプリカで作成されたユーザーは、adminユーザーによって作成されたオブジェクトや、 psql を通じて作成された他のユーザーにはアクセスできません。 詳しくは、PostgreSQL の役割と特権のページを参照してください。

読み取り専用レプリカの再同期

読み取り専用レプリカを再同期する必要がある場合は、**「読み取り専用レプリカの再同期 (Resync Read-Only Replica)」**ボタンをクリックします。 再同期は中断を伴う操作です。再同期を実行すると、読み取り専用レプリカのデータは解体されて最初から再構築されます。 再同期の実行中は、読み取り専用レプリカで他の操作を実行することも、照会を実行することもできません。 照会の宛先がリーダーに変更されることはないので、読み取り専用レプリカへの接続は、再同期が完了するまで失敗します。

読み取り専用レプリカの再同期にかかる時間はそれぞれに異なりますが、長い時間がかかるプロセスになる可能性があります。

CLIによる読み取り専用レプリカの再同期

CLI を使用して再同期を開始するには、cdb read-replica-resync コマンドを使用します。

ibmcloud cdb read-replica-resync <DEPLOYMENT_NAME_OR_CRN>

APIによる読み取り専用レプリカの再同期

API を使用して再同期を開始するには、/deployments/{id}/remotes/resync エンドポイントに POST を送信します。

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/remotes/resync \
  -H 'Authorization: Bearer <>'

読み取り専用レプリカのプロモート

読み取り専用レプリカを、読み取り操作だけでなく書き込み操作も受け入れる独立したクラスターにプロモートすることができます。 リーダーのデプロイメントに問題が発生した場合に、読み取り専用レプリカをスタンドアロン・クラスターにプロモートして、アプリケーションからの書き込みの受け入れを開始することができます。 read-replicaクラスタにすでに複数のデータメンバが存在する場合、read-replicaクラスタをスタンドアロンクラスタに昇格させる方が速くなります。

プロモーションが行われると、読み取り専用レプリカはリーダーへの接続を終了し、スタンドアロンの Databases for PostgreSQL のデプロイメントになります。 このデプロイメントは読み取り操作と書き込み操作の受け入れと実行を開始できます。バックアップが有効になり、独自の管理者ユーザーが発行されます。 単一メンバーの読み取り専用レプリカの場合、プロモーションによって2番目のデータメンバーが追加されます。 その結果、1メンバーあたりの同一料金で2つのデータメンバー分の料金が請求されるため、コストが増加します。

読み取り専用レプリカをプロモートするときに、通常はプロモート時に取得する初期バックアップをスキップすることができます。 初期バックアップをスキップすると、レプリカはより早く使用可能になりますが、即時バックアップは利用できません。 プロモーションのプロセスが完了したら、オンデマンド・バックアップを開始できます。

独立したデプロイメントにプロモートした読み取り専用レプリカは、読み取り専用レプリカに戻すことも、リーダーに再参加させることもできなくなります。

UIで読み取り専用レプリカをプロモートする

UI から読み取り専用レプリカを昇格させるには、「 読み取り専用レプリカを昇格 」をクリックします。

CLIで読み取り専用レプリカをプロモートする

CLI を使用してプロモートするには、cdb read-replica-promote コマンドを使用します。

ibmcloud cdb read-replica-promote <DEPLOYMENT_NAME_OR_CRN>

APIによる読み取り専用レプリカのプロモート

API を使用してプロモートするには、/deployments/{id}/remotes/promotion エンドポイントに POST を送信します。

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{"promotion": {}}' \

プロモートし、プロモート後の初期バックアップをスキップするには、JSON 本文に skip_initial_backup も設定します。

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

完了までの時間

プロモーションタスクが完了する前に、読み取りおよび書き込みアクセスが可能になる場合があります。 プロモートされたデプロイメントの高可用性を活用するには、タスクが完了するまで待ってください。

読み取りレプリカの全プロモーション時間は、データのサイズに基づいて、以下の 2 つの可能な方法によって判別されます。

  • 単一メンバーの読み取り専用レプリカをプロモートすると、2つ目のデータメンバーが追加されます。 そのレプリカの作成にかかる時間は、データベースのサイズ、利用可能なリソース、およびワークロードによって異なります。 大規模なデータベースの場合、コピーに時間がかかることがあります。 このタスクは、そのレプリカが作成されるまで完了しません。
  • プロモーションの一環としてバックアップを取ることを選択した場合は、そのバックアップも完了しないとタスクは完了しません。 これについても、データベースのサイズによって異なります。

プロモートされたデプロイメントの最初のバックアップを、独立したリカバリのマイルストーンと見なしてください。 初期バックアップを選択した場合は、正常に完了したことを確認してください。 それ以外の場合は、オンデマンドのバックアップを作成するか、スケジュールされたバックアップが正常に完了するのを待ってから、昇格されたデプロイメントのバックアップからの復元を行うようにしてください。

プロモート中のアップグレード

データベースの新しいメジャー・バージョンにアップグレードする必要がある場合は、読み取り専用レプリカをスタンドアロン・デプロイメントにプロモートするときにアップグレードすることができます。 詳細については、「 読み取り専用レプリカからのアップグレード 」を参照してください。

読み取り専用レプリカに関する考慮事項

  • 読み取り専用レプリカは、ソース構成と同じリージョンに置くことも、別のリージョンに置いて、リージョンをまたいでデータを複製することもできます。

  • 読み取り専用レプリカは、リーダーと同じメジャー・バージョンでなければなりません。

  • 読み取り専用レプリカではバックアップは無効になっています。 バックアップは、リーダーのデプロイメントでのみ取得されます。

  • レプリカは他のリージョンに復元可能ですが、EU Cloud対応リージョン(現在、 eu-de、 eu-es、および par-01 )は例外であり、これらのリージョン間でのみ復元が可能です(たとえば、 par-01 のレプリカは eu-de に復元でき、その逆も可能です)。

  • リーダー1つにつき、読み取り専用レプリカは5つまでという制限があります。

  • 読み取り専用レプリカはリーダー・クラスターのリーダー/フォロワーの選択に関与しないので、読み取り専用レプリカへのフェイルオーバーは自動化されません。 読み取り専用レプリカのフル・デプロイメントへのプロモーションは、ユーザーが開始して手動で行う作業です。

  • 読み取り専用レプリカの最小要件は、8 GBのRAMと10 GBのディスク容量です。 リーダーのデプロイメントがこれより小さくても、この最小サイズは変わりません。

  • 読み取り専用レプリカが、リーダーに合わせて自動的にスケーリングされることはありません。 保管するデータの量がデプロイメントに割り振られているディスクの量を超える場合は、読み取り専用レプリカのディスクをスケーリングしてから、リーダーのディスクをスケーリングしてください。 読み取り専用レプリカを最初にスケーリングすることで、読み取り専用レプリカのスペースが枯渇しないようにします。 スペースではなくパフォーマンスのためにリーダーのディスクをスケーリングした場合は、読み取り専用レプリカのスケーリングは必須ではありません。

  • レプリケーションは非同期で行われるので、レプリケーションに遅れが生じることがあります。 デフォルトでは、プライマリとレプリカの間で一貫性のある通信は行われません。 再同期が必要になるほど、読み取り専用のレプリカが遅れる可能性があります。 リーダーから地理的に遠く離れたリージョンにレプリカを置くと、レプリケーションの遅れが大きくなります。

  • IBM Cloud Monitoring サービスでデプロイメントを監視する場合、 PostgreSQL レプリカのレプリケーション遅延 メトリックの傾向を観察することができます。 このメトリックの値が -2 、問題を示している可能性がある場合は、 レプリケーションのステータスを確認する の手順に従って、レプリケーションが期待どおりに機能しているかどうかを判断してください。 レプリケーションのステータスを確認しても問題がある場合は、 IBM Cloud サポートに連絡し、再同期の前にデプロイメントを確認してください。

  • 読み取り専用レプリカとは、データメンバーが1つだけのデプロイメントであり、内部的な高可用性機能は備えていません。 メンテナンス時には一時的な中断やダウンタイムが発生しがちです。 読み取り専用レプリカに依存するアプリケーションがある場合は、失敗した照会を再試行するロジックや、複数の読み取り専用レプリカに負荷を分散させるロジックを実装してください。

読み取り専用レプリカとインプレースでのメジャーバージョンアップ

インプレース・メジャー・バージョン・アップグレード(IPMVU)では、ソース・デプロイメントとその組み込みの高可用性コンポーネントがアップグレードされます。 読み取り専用レプリカは、そのソースと同じ PostgreSQL のメジャーバージョンを実行している必要があります。 メジャーバージョンが異なるソースからの 物理的なレプリケーションを継続することはできません。

ソースに読み取り専用レプリカが関連付けられている場合、アップグレードの事前チェックに失敗します。 これには、他のリージョンにあるレプリカ、高可用性の読み取り専用レプリカ、およびプロビジョニング中のレプリカが含まれます。 レプリカは、接続が切断されている間も有効です。 レプリカの一覧を表示するには、 ibmcloud cdb deployment-read-replicas ソースのデプロイメント名またはCRNを指定して実行します。 このリストには、回収待ちの削除済みレプリカは含まれていません。 これらのレプリカはリストには表示されていませんが、それでも事前チェックに合格しません。

ソースのアップグレードをリクエストする前に:

  • 保存しておく必要がある レプリカをプロモートしてください。 プロモーションによりレプリケーションが終了し、各レプリカが独立したデプロイメントとなります。 昇格されたレプリカは、ソースからの変更を受け取らなくなり、レプリカとしてソースに再参加することはできなくなります。 これらのレプリカから最新のデータを読み取るアプリケーションについて、計画を立ててください。
  • 不要になったレプリカは、 ibmcloud resource service-instance-delete コマンドにレプリカの名前またはCRNを指定して、不要になったレプリカを削除してください。 削除されたレプリカは、完全に削除されるまでソースと関連付けられたままとなります。 完全に削除するには、 ibmcloud resource reclamationsでそのリクレイメーションIDを特定し、その後 ibmcloud resource reclamation-delete そのIDを指定して実行してください。

アップグレードをリクエストする前に、すべてのプロモーションまたは削除が完了するのを待ち、アップグレードタスクが完了するまでは読み取り専用レプリカを作成しないでください。 このサービスでは、アップグレード中にレプリカの作成をブロックすることはありません。 アップグレードの実行中に作成したレプリカは、アップグレードされたデプロイメントからレプリケーションを行うことはできません。 それを削除し、タスクが完了したら新しいものを作成してください。 すべてのレプリカを昇格または削除した後もプレチェックが失敗し続ける場合は、サポートまでご連絡ください。 アップグレードタスクのステータスが「 失敗 」と表示される場合は、「 IPMVUのトラブルシューティング 」を参照してください。

ソースのアップグレードが完了したら、必要に応じて新しい読み取り専用レプリカをプロビジョニングし、 レプリケーションが追いついていることを確認してから、それらのレプリカへ読み取りトラフィックを転送してください。

IPMVUは、読み取り専用レプリカの展開環境では利用できません。 レプリカを独立したデプロイメントに昇格させる際にアップグレードを行うには、「 昇格時のアップグレード」を 参照してください。 ソースのアップグレード準備および可用性については、「 インプレースでのメジャーバージョンアップグレード 」を参照してください。