Aurora PostgreSQL グローバルデータベースで書き込み転送を使用する

Aurora PostgreSQL での書き込み転送を利用できるリージョンとバージョン

書き込み転送は、Aurora PostgreSQL バージョン 15.4 以降のマイナーバージョンと、バージョン 14.9 以降のマイナーバージョンでサポートされます。書き込み転送は、Aurora PostgreSQL ベースのグローバルデータベースが利用可能なすべてのリージョンで利用できます。

Aurora PostgreSQL グローバルデータベースで利用できるバージョンとリージョンについては、「Aurora PostgreSQL を使用した Aurora グローバルデータベース」を参照してください。

Aurora PostgreSQL での書き込み転送の有効化

デフォルトでは、セカンダリクラスターを Aurora Global Database に追加すると、書き込み転送は有効になりません。セカンダリ DB クラスターの書き込み転送は、作成中または作成後にいつでも有効にできます。必要に応じて、後で無効にすることができます。書き込み転送を有効または無効にしても、ダウンタイムや再起動は発生しません。

コンソールでは、セカンダリ DB クラスターを作成または変更するときに、書き込み転送を有効または無効にすることができます。

セカンダリ DB クラスターの作成時に書き込み転送を有効または無効にする

新しいセカンダリ DB クラスターを作成するときは、[リードレプリカの書き込み転送] の [グローバル書き込み転送を有効にする] チェックボックスをオンにして、書き込み転送を有効にします。または、チェックボックスをオフにしてこの機能を無効にします。セカンダリ DB クラスターを作成するには、「Amazon Aurora DB クラスターの作成」の DB エンジンの手順に従ってください。

次のスクリーンショットは、[グローバル書き込み転送を有効にする] チェックボックスがオンになっている[リードレプリカの書き込み転送] セクションを示しています。

セカンダリ DB クラスターの修正時に書き込み転送を有効または無効にする

コンソールでは、セカンダリ DB クラスターを修正して書き込み転送を有効または無効にすることができます。

コンソールでセカンダリ DB クラスターの書き込み転送を有効または無効にするには

1. AWS Management Console にサインインし、Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

2. [データベース] をクリックします。

3. セカンダリ DB クラスターを選択し、[変更] を選択します。

4. [リードレプリカの書き込み転送] セクションで、[グローバル書き込み転送を有効にする] チェックボックスをオンまたはオフにします。

5. Continue (続行) をクリックします。

6. [変更をスケジュール] で、[すぐに適用] を選択します。次に [スケジュールされたメンテナンスウィンドウで適用] を選択すると、Aurora ではこの設定が無視され、書き込み転送が直ちにオンになります。

7. [クラスタークラスターの変更] を選択します。

AWS CLI を使用して書き込み転送を有効にするには、--enable-global-write-forwarding オプションを使用します。このオプションは、create-db-cluster コマンドを使用して新しいセカンダリクラスターを作成するときに機能します。modify-db-cluster コマンドを使用して、既存のセカンダリクラスターを変更する場合にも機能します。グローバルデータベースでは、書き込み転送をサポートする Aurora バージョンを使用する必要があります。これらの同じ CLI コマンドで --no-enable-global-write-forwarding オプションを使用することで、書き込み転送をオフにすることができます。

以下の手順では、AWS CLI を使用してグローバルクラスター内のセカンダリ DB クラスターの書き込み転送を有効または無効にする方法について説明します。

既存のセカンダリ DB クラスターの書き込み転送を有効または無効にするには

• modify-db-cluster AWS CLI コマンドを呼び出して以下の値を指定します。

  • --db-cluster-identifier - DB クラスターの名前。

  • オンにする場合は --enable-global-write-forwarding、オフにする場合は --no-enable-global-write-forwarding。

  次の例では、DB クラスター sample-secondary-db-cluster の書き込み転送を有効にします。

  Linux、macOS、Unix の場合:

  aws rds modify-db-cluster \
      --db-cluster-identifier sample-secondary-db-cluster \
      --enable-global-write-forwarding

  Windows の場合:

  aws rds modify-db-cluster ^
      --db-cluster-identifier sample-secondary-db-cluster ^
      --enable-global-write-forwarding

Amazon RDS API を使用して書き込み転送を有効にするには、EnableGlobalWriteForwarding パラメータを true に設定します。このパラメータは、CreateDBCluster オペレーションを使用して新しいセカンダリクラスターを作成するときに機能します。この操作は、ModifyDBCluster オペレーションを使用して既存のセカンダリクラスターを変更する場合にも機能します。グローバルデータベースでは、書き込み転送をサポートする Aurora バージョンを使用する必要があります。EnableGlobalWriteForwarding パラメータを false に設定することで、書き込み転送をオフにすることができます。

セカンダリクラスターで Aurora PostgreSQL での書き込み転送が有効になっているかどうかの確認

セカンダリクラスターからの書き込み転送を使用できるかどうかを判断するには、クラスターに属性 "GlobalWriteForwardingStatus": "enabled" があるかどうかを確認します。

AWS Management Console では、クラスターの詳細ページの [設定] タブに Read replica write forwarding が表示されます。すべてのクラスターのグローバル書き込み転送設定のステータスを表示するには、次の AWS CLI コマンドを実行します。

セカンダリクラスターには、書き込み転送がオンかオフかを示す値 "enabled" または "disabled" が表示されます。値 null は、そのクラスターで書き込み転送が使用できないことを示します。クラスターがグローバルデータベースの一部ではないか、セカンダリクラスターではなくプライマリクラスターです。書き込み転送をオンまたはオフにする処理中の場合、値は "enabling" または "disabling" になります。

aws rds describe-db-clusters --query '*[].{DBClusterIdentifier:DBClusterIdentifier,GlobalWriteForwardingStatus:GlobalWriteForwardingStatus}'
[
    {
        "GlobalWriteForwardingStatus": "enabled",
        "DBClusterIdentifier": "aurora-write-forwarding-test-replica-1"
    },
    {
        "GlobalWriteForwardingStatus": "disabled",
        "DBClusterIdentifier": "aurora-write-forwarding-test-replica-2"
    },
    {
        "GlobalWriteForwardingStatus": null,
        "DBClusterIdentifier": "non-global-cluster"
    }
]

グローバル書き込み転送が有効になっているすべてのセカンダリクラスターを検索するには、次のコマンドを実行します。このコマンドは、クラスターのリーダーエンドポイントも返します。Aurora Global Database でセカンダリからプライマリへの書き込み転送を使用するときは、セカンダリクラスターのリーダーエンドポイントを使用します。

aws rds describe-db-clusters --query 'DBClusters[].{DBClusterIdentifier:DBClusterIdentifier,GlobalWriteForwardingStatus:GlobalWriteForwardingStatus,ReaderEndpoint:ReaderEndpoint} | [?GlobalWriteForwardingStatus == `enabled`]'
[
    {
        "GlobalWriteForwardingStatus": "enabled",
        "ReaderEndpoint": "aurora-write-forwarding-test-replica-1.cluster-ro-cnpexample.us-west-2.rds.amazonaws.com",
        "DBClusterIdentifier": "aurora-write-forwarding-test-replica-1"
    }
]

書き込み転送とアプリケーションおよび Aurora PostgreSQL の互換性

特定のステートメントは、書き込み転送機能を持つグローバルデータベースで使用すると、許可されないか、または古い結果を生成する可能性があります。また、ユーザー定義関数とユーザー定義プロシージャはサポートされていません。したがって、セカンダリクラスターで EnableGlobalWriteForwarding の設定はデフォルトではオフになっています。オンにする前に、アプリケーションコードがこれらの制限の影響を受けていないことを確認してください。

書き込み転送では、次の種類の SQL ステートメントを使用できます。

書き込み転送では、次の種類の SQL ステートメントはサポートされていません。

Aurora PostgreSQL での書き込み転送の分離と整合性

書き込み転送を使用するセッションでは、REPEATABLE READ および READ COMMITTED 分離レベルのみを使用できます。ただし、SERIALIZABLE 分離レベルはサポートされていません。

セカンダリクラスターの読み取り整合性の程度を制御できます。読み取り整合性レベルは、一部またはすべての変更がプライマリクラスターからレプリケートされるように、各読み取りオペレーションの前にセカンダリクラスターが実行する待機時間を決定します。読み取り整合性レベルを調整して、セッションから転送されたすべての書き込みオペレーションが、後続のクエリの前にセカンダリクラスターに表示されるようにすることができます。また、この設定を使用して、セカンダリクラスターのクエリに、常にプライマリクラスターからの最新の更新が表示されるようにすることもできます。これは、他のセッションまたは他のクラスターによって送信されたものであっても同様です。アプリケーションでこの種類の動作を指定するには、セッションレベルのパラメータ apg_write_forward.consistency_mode の適切な値を選択します。apg_write_forward.consistency_mode パラメータは、書き込み転送が有効になっているセカンダリクラスターでのみ有効です。

整合性レベルを上げると、アプリケーションは、AWS リージョン間で変更が反映されるのを待つ時間が長くなります。応答時間の短縮と、クエリを実行する前に他の場所で行われた変更が完全に使用可能であることのバランスを選択できます。

整合性モードを設定できるたびに、次のような効果が得られます。

書き込み転送に関連するすべてのパラメータの詳細については、「Aurora PostgreSQL での書き込み転送の設定パラメータ」を参照してください。

Aurora PostgreSQL での書き込み転送を使用したマルチパートステートメントの実行

DML ステートメントは、INSERT ... SELECT ステートメントや DELETE ... WHERE ステートメントなど、複数の部分から構成される場合があります。この場合、ステートメント全体がプライマリクラスターに転送され、そこで実行されます。

Aurora PostgreSQL での書き込み転送の設定パラメータ

Aurora クラスターのパラメータグループには、書き込み転送機能の設定が含まれています。これらはクラスターパラメータであるため、各クラスターのすべての DB インスタンスは、これらの可変に同じ値を持ちます。これらのパラメータの詳細を次の表にまとめ、表に続いて使用上の注意を記載してください。

apg_write_forward.max_forwarding_connections_percent パラメータは、リーダーから転送されたクエリを処理するために使用できるデータベース接続スロットの上限です。これは、プライマリクラスター内の書き込み DB インスタンスの max_connections 設定のパーセンテージで表されます。例えば、max_connections が 800、apg_write_forward.max_forwarding_connections_percent が 10 の場合、書き込みは最大 80 の同時転送セッションを許可します。これらの接続は、max_connections 設定によって管理される同じ接続プールから取得されます。この設定は、セカンダリクラスターで少なくとの 1 つの書き込み転送が有効になっている場合に、プライマリクラスターにのみ適用されます。

セカンダリクラスターでは以下の設定を使用します。

Aurora PostgreSQL での書き込み転送の Amazon CloudWatch メトリクス

次の Amazon CloudWatch メトリクスは、1 つ以上のセカンダリクラスターで書き込み転送を使用する場合、プライマリクラスターに適用されます。これらのメトリクスはすべて、プライマリクラスターのライター DB インスタンスで測定されます。

次の CloudWatch メトリクスは、各セカンダリクラスターに適用されます。これらのメトリクスは、書き込み転送が有効になっているセカンダリクラスターのリーダー DB インスタンスで測定されます。

Aurora PostgreSQL での書き込み転送のイベントを待機する

Aurora PostgreSQL で書き込み転送を使用すると、Amazon Aurora は次の待機イベントを生成します。

IPC:AuroraWriteForwardConnect

IPC:AuroraWriteForwardConnect イベントは、セカンダリ DB クラスターのバックエンドプロセスが、プライマリ DB クラスターのライターノードへの接続が開かれるのを待っているときに発生します。

待機時間が増加する原因の可能性

このイベントは、セカンダリージョンのリーダーノードからプライマリ DB クラスターのライターノードへの接続試行回数が増えるにつれて増加します。

アクション

セカンダリノードからプライマリリージョンのライターノードへの同時接続数を減らします。

IPC:AuroraWriteForwardConsistencyPoint

IPC:AuroraWriteForwardConsistencyPoint イベントは、転送された書き込みオペレーションの結果が現在のリージョンにレプリケートされるまでセカンダリ DB クラスターのノードからのクエリが待機する時間を記述します。このイベントは、セッションレベルのパラメータ apg_write_forward.consistency_mode が次のいずれかに設定されている場合にのみ生成されます。

apg_write_forward.consistency_mode パラメータの設定の詳細については、「Aurora PostgreSQL での書き込み転送の設定パラメータ」をご参照ください。

待機時間が増加する原因の可能性

待機時間が長くなる一般的な原因には以下のものがあります。

アクション

アプリケーションの要件に応じて、整合性モードを変更します。

IPC:AuroraWriteForwardExecute

IPC:AuroraWriteForwardExecute イベントは、セカンダリ DB クラスターのバックエンドプロセスが、転送されたクエリを完了し、プライマリ DB クラスターのライターノードからの結果を取得するのを待っているときに発生します。

待機時間が増加する原因の可能性

待機時間の増加の一般的な原因としては、以下が挙げられます。

アクション

待機イベントの原因に応じたさまざまなアクションをお勧めします。

IPC:AuroraWriteForwardGetGlobalConsistencyPoint

IPC:AuroraWriteForwardGetGlobalConsistencyPoint イベントは、GLOBAL 整合性モードを使用しているセカンダリ DB クラスター上のバックエンドプロセスが、クエリを実行する前に、ライターノードからグローバル整合性ポイントを取得するのを待っているときに発生します。

待機時間が増加する原因の可能性

待機時間の増加の一般的な原因としては、以下が挙げられます。

アクション

待機イベントの原因に応じたさまざまなアクションをお勧めします。

IPC:AuroraWriteForwardXactAbort

IPC:AuroraWriteForwardXactAbort イベントは、セカンダリ DB クラスターのバックエンドプロセスがリモートクリーンアップクエリの結果を待っているときに発生します。クリーンアップクエリは、書き込み転送されたトランザクションが中止された後にプロセスを適切な状態に戻すために発行されます。Amazon Aurora は、エラーが見つかったか、ユーザーが明示的な ABORT コマンドを発行したか、実行中のクエリをキャンセルしたためにそれらを実行します。

待機時間が増加する原因の可能性

待機時間の増加の一般的な原因としては、以下が挙げられます。

アクション

待機イベントの原因に応じたさまざまなアクションをお勧めします。

IPC:AuroraWriteForwardXactCommit

IPC:AuroraWriteForwardXactCommit イベントは、セカンダリ DB クラスターのバックエンドプロセスが、転送されたコミットトランザクションコマンドの結果を待っているときに発生します。

待機時間が増加する原因の可能性

待機時間の増加の一般的な原因としては、以下が挙げられます。

アクション

セカンダリノードまたはプライマリリージョンのライターノードが CPU またはネットワーク帯域幅によって制約されている場合は、CPU キャパシティまたはネットワーク帯域幅の大きいインスタンスタイプに変更することを検討してください。

IPC:AuroraWriteForwardXactStart

IPC:AuroraWriteForwardXactStart イベントは、セカンダリ DB クラスターのバックエンドプロセスが、転送された開始トランザクションコマンドの結果を待っているときに発生します。

待機時間が増加する原因の可能性

待機時間の増加の一般的な原因としては、以下が挙げられます。

アクション

セカンダリノードまたはプライマリリージョンのライターノードが CPU またはネットワーク帯域幅によって制約されている場合は、CPU キャパシティまたはネットワーク帯域幅の大きいインスタンスタイプに変更することを検討してください。