Aurora PostgreSQL のローカル書き込み転送の使用

PDFRSS

以下のセクションを使用して、データベースクラスターでローカル書き込み転送が有効になっているかどうかと、互換性に関する考慮事項、設定可能なパラメータと認証設定について確認できます。この情報は、Aurora PostgreSQL でローカル書き込み転送機能を効果的に活用するための詳細を提供します。

注記

ローカル書き込み転送を使用しているクラスター内のライターインスタンスが再起動されると、ローカル書き込み転送を使用しているリーダーインスタンス上のアクティブで転送されたトランザクションとクエリは自動的に閉じられます。ライターインスタンスが再び使用可能になったら、これらのトランザクションを再試行できます。

DB クラスターでローカル書き込み転送が有効になっているかどうかの確認

DB クラスターでローカル書き込み転送を使用できることを確かめるには、クラスターの属性 LocalWriteForwardingStatus が enabled に設定されていることを確認します。

AWS Management Console のクラスターの詳細ページの [設定] タブで、[ローカルリードレプリカの書き込み転送] のステータスが [有効] と表示されます。

すべてのクラスターについてローカル書き込み転送設定のステータスを確認するには、次の AWS CLI コマンドを実行します。

aws rds describe-db-clusters \
--query '*[].{DBClusterIdentifier:DBClusterIdentifier,LocalWriteForwardingStatus:LocalWriteForwardingStatus}'

[
{
"LocalWriteForwardingStatus": "enabled",
"DBClusterIdentifier": "write-forwarding-test-cluster-1"
},
{
"LocalWriteForwardingStatus": "disabled",
"DBClusterIdentifier": "write-forwarding-test-cluster-2"
},
{
"LocalWriteForwardingStatus": "requested",
"DBClusterIdentifier": "test-global-cluster-2"
},
{
"LocalWriteForwardingStatus": "null",
"DBClusterIdentifier": "aurora-postgresql-v2-cluster"
}
]

DB クラスターは、LocalWriteForwardingStatus として以下の値を持ちます。

• disabled — ローカル書き込み転送は無効です。

• disabling — ローカル書き込み転送は無効化中です。

• enabled — ローカル書き込み転送は有効です。

• enabling — ローカル書き込み転送は有効化中です。

• null — この DB クラスターではローカル書き込み転送を使用できません。

• requested — ローカル書き込み転送がリクエストされていますが、まだアクティブではありません。

書き込み転送のデフォルトのパラメータ設定

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

パラメータ	スコープ	タイプ	デフォルト値	有効値
apg_write_forward.connect_timeout	セッション	秒	30	0-2147483647
apg_write_forward.consistency_mode	セッション	enum	セッション	SESSION、EVENTUAL、GLOBAL、および OFF
apg_write_forward.idle_in_transaction_session_timeout	セッション	ミリ秒	86400000	0-2147483647
apg_write_forward.idle_session_timeout	セッション	ミリ秒	300000	0-2147483647
apg_write_forward.max_forwarding_connections_percent	グローバル	int	25	1–100

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

ローカル書き込み転送リクエストを制御するには、以下の設定を使用します。

• apg_write_forward.consistency_mode — リードレプリカの読み取り整合性の度合いを制御するセッションレベルのパラメータ。有効な値は SESSION、EVENTUAL、GLOBAL、または OFF です。デフォルトでは、値は SESSION に設定されます。値を OFF に設定すると、セッションでのローカル書き込み転送が無効になります。整合性レベルの詳細については、Aurora PostgreSQL でのローカル書き込み転送の整合性と分離 を参照してください。このパラメータは、ローカル書き込み転送が有効になっているリーダーインスタンスにのみ関係します。

• apg_write_forward.connect_timeout – リードレプリカがライター DB インスタンスへの接続を確立するために待機を始めてから止めるまでの最大秒数。値が 0 の場合、無期限に待機することになります。

• apg_write_forward.idle_in_transaction_session_timeout — リーダー DB インスタンスが、オープントランザクションを持つリードレプリカから転送されるアクティビティを接続で待機し始めてから、接続を閉じるまでのミリ秒数。トランザクションでこの期間を超えてセッションがアイドル状態のままである場合、Aurora はセッションを終了します。0 の値は、タイムアウトを無効にします。

• apg_write_forward.idle_session_timeout — ライター DB インスタンスが、リーダーインスタンスから転送されるアクティビティを接続で待機し始めてから、接続を閉じるまでのミリ秒数。この期間を超えてセッションがアイドル状態のままである場合、Aurora はセッションを終了します。0 の値は、タイムアウトを無効にします。

rdswriteforwarduser

rdswriteforwarduser は、リードレプリカとライター DB インスタンスの間の接続を確立するために使用するユーザーです。

注記

rdswriteforwarduser は PUBLIC ロールを介して CONNECT 権限をカスタマーデータベースに継承します。PUBLIC ロールの権限が取り消された場合は、書き込みを転送する必要があるデータベースに接続権限を付与 (GRANT CONNECT) する必要があります。