MySQL :: MySQL 8.0 リファレンスマニュアル :: 18.8 グループレプリケーションシステム変数

9.5 English
9.4 English
9.3 English
9.2 English
9.1 English
9.0 English
8.4 English
8.0 English
5.7 English

MySQL 8.0 リファレンスマニュアル / グループレプリケーション / グループレプリケーションシステム変数

このページは機械翻訳したものです。

18.8 グループレプリケーションシステム変数

このセクションでは、Group Replication プラグインに固有のシステム変数を一覧表示します。すべての構成オプションには、接頭辞として "group_replication " が付きます。

Group Replication のほとんどのシステム変数は動的と記述され、その値はサーバーの実行中に変更できます。ただし、ほとんどの場合、変更が有効になるのは、STOP GROUP_REPLICATION ステートメントの後に START GROUP_REPLICATION ステートメントを使用してグループメンバーでグループレプリケーションを停止して再起動した後のみです。 Group Replication を停止および再起動せずに、次のシステム変数への変更が有効になります:

group_replication_advertise_recovery_endpoints
group_replication_autorejoin_tries
group_replication_consistency
group_replication_exit_state_action
group_replication_flow_control_applier_threshold
group_replication_flow_control_certifier_threshold
group_replication_flow_control_hold_percent
group_replication_flow_control_max_commit_quota
group_replication_flow_control_member_quota_percent
group_replication_flow_control_min_quota
group_replication_flow_control_min_recovery_quota
group_replication_flow_control_mode
group_replication_flow_control_period
group_replication_flow_control_release_percent
group_replication_force_members
group_replication_member_expel_timeout
group_replication_member_weight
group_replication_transaction_size_limit
group_replication_unreachable_majority_timeout

グループレプリケーションのほとんどのシステム変数は、グループメンバーごとに異なる値を持つことができます。次のシステム変数では、トランザクションの不要なロールバック、メッセージ配信の失敗またはメッセージリカバリの失敗を回避するために、グループのすべてのメンバーに同じ値を設定することをお薦めします:

group_replication_auto_increment_increment
group_replication_communication_max_message_size
group_replication_compression_threshold
group_replication_message_cache_size
group_replication_transaction_size_limit

グループレプリケーション固有のシステム変数や一般的なシステム変数など、グループレプリケーショングループメンバーの一部のシステム変数は、グループ全体の構成設定です。これらのシステム変数は、すべてのグループメンバーで同じ値を持つ必要があり、グループレプリケーションの実行中は変更できません。また、値の変更を有効にするには、グループの完全な再起動 (group_replication_bootstrap_group=ON を使用したサーバーによるブートストラップ) が必要です。これらの条件は、次のシステム変数に適用されます:

group_replication_single_primary_mode
group_replication_enforce_update_everywhere_checks
group_replication_gtid_assignment_block_size
default_table_encryption
lower_case_table_names
transaction_write_set_extraction

MySQL 8.0.16 から、group_replication_switch_to_single_primary_mode() および group_replication_switch_to_multi_primary_mode() UDF を使用して、グループの実行中に group_replication_single_primary_mode および group_replication_enforce_update_everywhere_checks の値を変更できます。詳細は、セクション18.4.1.2「グループモードの変更」を参照してください。

重要

グループレプリケーションの多くのシステム変数は、コマンドライン引数としてサーバーに渡された場合、サーバーの起動時に完全には検証されません。これらのシステム変数には、group_replication_group_name, group_replication_single_primary_mode, group_replication_force_members、SSL 変数およびフロー制御システム変数が含まれます。これらは、サーバーの起動後にのみ完全に検証されます。
グループメンバーの IP アドレスまたはホスト名を指定するグループレプリケーションのシステム変数は、START GROUP_REPLICATION ステートメントが発行されるまで検証されません。グループレプリケーショングループ通信システム (GCS) は、その時点まで値を検証できません。

Group Replication プラグインに固有のシステム変数は次のとおりです:

group_replication_advertise_recovery_endpoints

コマンド行形式	`--group-replication-advertise-recovery-endpoints=value`
導入	8.0.21
システム変数	`group_replication_advertise_recovery_endpoints`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	文字列
デフォルト値	`DEFAULT`

このシステム変数の値は、Group Replication の実行中に変更できます。変更はすぐにメンバーに反映されます。ただし、システム変数の以前の値をすでに受け取っている結合メンバーは、その値を引き続き使用します。値の変更後に結合されたメンバーのみが新しい値を受け取ります。

group_replication_advertise_recovery_endpoints は、結合メンバーが分散リカバリのために状態転送のために既存のメンバーへの接続を確立する方法を指定します。この接続は、リモートクローニング操作とドナーのバイナリログからの状態転送の両方に使用されます。

デフォルト設定の DEFAULT の値は、参加メンバーが MySQL Server hostname および port システム変数で指定されている既存のメンバー標準 SQL クライアント接続を使用することを意味します。 report_port システム変数で代替ポート番号が指定されている場合は、かわりにそのポート番号が使用されます。「パフォーマンススキーマ」テーブル replication_group_members では、この接続アドレスとポート番号が MEMBER_HOST および MEMBER_PORT フィールドに表示されます。これは、MySQL 8.0.20 までのリリースでのグループメンバーの動作です。

DEFAULT のかわりに、既存のメンバーが使用する参加メンバーに通知する分散リカバリエンドポイントを指定できます。分散リカバリエンドポイントを提供することで、管理者は、グループメンバーへの通常の MySQL クライアント接続とは別に分散リカバリトラフィックを制御できます。メンバーの結合では、リストで指定された順序で各エンドポイントが順に試行されます。

分散リカバリエンドポイントを IP アドレスとポート番号のカンマ区切りリストとして指定します。次に例を示します:

group_replication_advertise_recovery_endpoints= "127.0.0.1:3306,127.0.0.1:4567,[::1]:3306,localhost:3306"

IPv4 アドレスと IPv6 アドレスおよびホスト名は、任意の組合せで使用できます。 IPv6 アドレスは大カッコで囲んで指定する必要があります。ホスト名はローカル IP アドレスに解決される必要があります。ワイルドカードアドレス書式は使用できず、空のリストは指定できません。標準 SQL クライアント接続は、分散リカバリエンドポイントのリストに自動的には含まれないことに注意してください。エンドポイントとして使用する場合は、リストに明示的に含める必要があります。

分散リカバリエンドポイントとして IP アドレスとポートを選択する方法、およびメンバーを結合する方法の詳細は、セクション18.4.3.1.1「分散リカバリエンドポイントのアドレスの選択」を参照してください。要件のサマリーは次のとおりです:

IP アドレスは MySQL Server 用に構成する必要はありませんが、サーバーに割り当てる必要があります。
ポートは、port、report_port または admin_port システム変数を使用して MySQL Server 用に構成する必要があります。
admin_port を使用する場合は、分散リカバリのレプリケーションユーザーに適切な権限が必要です。
group_replication_ip_allowlist または group_replication_ip_whitelist システム変数で指定された Group Replication 許可リストに IP アドレスを追加する必要はありません。
接続の SSL 要件は、group_replication_recovery_ssl_* オプションで指定されたとおりです。

group_replication_allow_local_lower_version_join

コマンド行形式	`--group-replication-allow-local-lower-version-join[={OFF\|ON}]`
システム変数	`group_replication_allow_local_lower_version_join`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Boolean
デフォルト値	`OFF`

このシステム変数の値は、Group Replication の実行中に変更できますが、変更はグループメンバーで Group Replication を停止して再起動した後にのみ有効になります。

group_replication_allow_local_lower_version_join では、現在のサーバーがグループより低いバージョンの MySQL Server を実行している場合でも、グループに参加できます。デフォルト設定の OFF では、既存のグループメンバーより低いバージョンを実行しているサーバーはレプリケーショングループに参加できません。この標準ポリシーは、グループのすべてのメンバーがメッセージを交換し、トランザクションを適用できることを確認します。 MySQL 8.0.17 以上を実行しているメンバーは、互換性をチェックするときにリリースのパッチバージョンを考慮することに注意してください。 MySQL 8.0.16 以下または MySQL 5.7 を実行しているメンバーには、メジャーバージョンのみが考慮されます。

次のシナリオでのみ、group_replication_allow_local_lower_version_join を ON に設定します:

グループのフォルトトレランスを改善するには、緊急時にサーバーをグループに追加する必要があり、古いバージョンのみを使用できます。
グループ全体を停止して再度ブートストラップせずに、1 つ以上のレプリケーショングループメンバーのアップグレードをロールバックする場合。

警告

このオプションを ON に設定しても、新しいメンバーはグループと互換性がなく、既存のメンバーによる互換性のない動作から保護されずにグループに参加できます。新しいメンバーが正しく動作するようにするには、次の予防措置の both を使用します:

下位バージョンを実行しているサーバーがグループに参加する前に、そのサーバーでのすべての書込みを停止します。
下位バージョンを実行しているサーバーがグループに参加した時点から、グループ内の他のサーバーに対するすべての書込みを停止します。

これらの予防措置がないと、低いバージョンを実行しているサーバーで問題が発生し、エラーで終了する可能性があります。

group_replication_auto_increment_increment

コマンド行形式	`--group-replication-auto-increment-increment=#`
システム変数	`group_replication_auto_increment_increment`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値	`7`
最小値	`1`
最大値	`65535`

このシステム変数は、すべてのグループメンバーで同じ値を持つ必要があります。グループレプリケーションの実行中は、このシステム変数の値を変更できません。各グループメンバーでグループレプリケーションを停止し、システム変数の値を変更してから、グループレプリケーションを再起動する必要があります。このプロセス中、システム変数の値はグループメンバー間で異なってもかまいませんが、グループメンバーの一部のトランザクションはロールバックされる可能性があります。

group_replication_auto_increment_increment は、このサーバーインスタンスで実行されるトランザクションの自動増分カラムの連続する値の間隔を決定します。間隔を追加すると、グループメンバーに対する書込みに対して重複する自動増分値が選択されないため、トランザクションがロールバックされます。デフォルト値の 7 は、使用可能な値の数とレプリケーショングループの最大許容サイズ (9 メンバー) のバランスを表します。グループのメンバー数が多いか少ない場合は、グループレプリケーションが開始される前に、グループメンバーの予想数と一致するようにこのシステム変数を設定できます。

グループレプリケーションがサーバーインスタンスで開始されると、サーバーシステム変数 auto_increment_increment の値がこの値に変更され、サーバーシステム変数 auto_increment_offset の値がサーバー ID に変更されます。グループレプリケーションが停止すると、変更は元に戻されます。これらの変更は、auto_increment_increment および auto_increment_offset のそれぞれのデフォルト値が 1 の場合にのみ行われ、元に戻されます。これらの値がすでにデフォルトから変更されている場合、Group Replication はそれらを変更しません。 MySQL 8.0 からは、グループレプリケーションが単一プライマリモードで、サーバー書込みが 1 つのみの場合も、システム変数は変更されません。

group_replication_autorejoin_tries

コマンド行形式	`--group-replication-autorejoin-tries=#`
導入	8.0.16
システム変数	`group_replication_autorejoin_tries`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値 (≥ 8.0.21)	`3`
デフォルト値 (≤ 8.0.20)	`0`
最小値	`0`
最大値	`2016`

このシステム変数の値は、Group Replication の実行中に変更でき、変更はただちに有効になります。動作が必要であることを意味する問題が発生すると、システム変数 current 値が読み取られます。

group_replication_autorejoin_tries では、メンバーが明示された場合、または group_replication_unreachable_majority_timeout 設定に到達する前にグループの大部分にアクセスできない場合に、メンバーが自動的にグループに再参加しようとする試行回数を指定します。メンバー削除または到達不能な大部分のタイムアウトに達すると、(現在のプラグインオプション値を使用して) 再結合を試みてから、指定された試行回数までさらに自動再結合を試みます。自動再結合の試行に失敗すると、メンバーは次の試行の 5 分前に待機します。指定された試行回数がメンバーの再参加または停止なしで使い果たされた場合、メンバーは group_replication_exit_state_action システム変数で指定されたアクションに進みます。

MySQL 8.0.20 までは、デフォルト設定は 0 です。つまり、メンバーは自動的に再結合を試みません。 MySQL 8.0.21 からは、デフォルト設定は 3 です。これは、メンバーがグループへの再参加を自動的に 3 回試行し、それぞれの間に 5 分間試行することを意味します。最大 2016 回の試行を指定できます。

自動再結合の試行中および試行の間、メンバーはスーパー読取り専用モードのままで書込みを受け入れませんが、時間の経過とともに失効した読取りの可能性を高くして、メンバーに対して読取りを実行できます。一定期間失効した読取りの可能性を許容できない場合は、group_replication_autorejoin_tries を 0 に設定します。自動再結合機能、およびこのオプションの値を選択する際の考慮事項の詳細は、セクション18.6.6.3「Auto-Rejoin」を参照してください。

group_replication_bootstrap_group

コマンド行形式	`--group-replication-bootstrap-group[={OFF\|ON}]`
システム変数	`group_replication_bootstrap_group`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Boolean
デフォルト値	`OFF`

group_replication_bootstrap_group は、グループをブートストラップするようにこのサーバーを構成します。このシステム変数は、グループを初めて起動するとき、またはグループ全体を再起動するときに、あるサーバーおよびのみで設定する必要があります。グループがブートストラップされたら、このオプションを OFF に設定します。動的にも構成ファイルでも、OFF に設定する必要があります。グループの実行中に 2 つのサーバーを起動するか、このオプションを設定して 1 つのサーバーを再起動すると、人工的なスプリットブレーン状況が発生し、同じ名前の独立した 2 つのグループがブートストラップされる場合があります。

group_replication_clone_threshold

コマンド行形式	`--group-replication-clone-threshold=#`
導入	8.0.17
システム変数	`group_replication_clone_threshold`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値	`9223372036854775807`
最小値	`1`
最大値	`9223372036854775807`

group_replication_clone_threshold では、分散リカバリプロセス中に参加メンバーへの状態転送のためにリモートクローニング操作の使用をトリガーする既存のメンバー (ドナー) と参加メンバー (受信者) の間のトランザクションギャップを多数のトランザクションとして指定します。参加メンバーと適切なドナーの間のトランザクションギャップがしきい値を超えると、グループレプリケーションはリモートクローニング操作で分散リカバリを開始します。トランザクションギャップがしきい値を下回る場合、またはリモートクローニング操作が技術的に可能でない場合、Group Replication はドナーのバイナリログからの状態転送に直接進みます。

警告

アクティブグループの group_replication_clone_threshold には低い設定を使用しないでください。リモートクローニング操作の進行中にしきい値を超える数のトランザクションがグループで発生した場合、参加メンバーは再起動後にリモートクローニング操作を再度トリガーし、これを無期限に続行できます。この状況を回避するには、リモートクローニング操作にかかる時間内にグループ内で発生すると予想されるトランザクション数よりも大きい数をしきい値に設定してください。

この関数を使用するには、クローニングをサポートするようにドナーと参加メンバーの両方を事前に設定する必要があります。その手順は、セクション18.4.3.2「分散リカバリのためのクローニング」を参照してください。リモートクローニング操作が実行されると、group_replication_start_on_boot=ON が設定されている場合は、グループレプリケーションによって管理され、必要なサーバーの再起動も含まれます。そうでない場合は、サーバーを手動で再起動する必要があります。リモートクローニング操作では、結合メンバーの既存のデータディクショナリが置換されますが、結合メンバーに他のグループメンバーに存在しない追加のトランザクションがある場合、これらのトランザクションはクローニング操作によって消去されるため、グループレプリケーションによってチェックされ、続行されません。

デフォルト設定 (GTID 内のトランザクションに許可される最大シーケンス番号) は、ドナーのバイナリログからの状態転送が、クローニングではなく実質的に常に試行されることを意味します。ただし、結合メンバーに必要なトランザクションが既存のグループメンバーのバイナリログで使用できないためなど、ドナーバイナリログからの状態転送が不可能な場合、グループレプリケーションはしきい値に関係なく常にクローニング操作を実行しようとします。レプリケーショングループでクローニングをまったく使用しない場合は、クローンプラグインをメンバーにインストールしないでください。

group_replication_communication_debug_options

コマンド行形式	`--group-replication-communication-debug-options=value`
システム変数	`group_replication_communication_debug_options`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	文字列
デフォルト値	`GCS_DEBUG_NONE`
有効な値	`GCS_DEBUG_NONE` `GCS_DEBUG_BASIC` `GCS_DEBUG_TRACE` `XCOM_DEBUG_BASIC` `XCOM_DEBUG_TRACE` `GCS_DEBUG_ALL`

group_replication_communication_debug_options は、グループ通信システム (GCS) やグループ通信エンジン (XCom、Paxos バリアント) などの様々なグループレプリケーションコンポーネントに提供するデバッグメッセージのレベルを構成します。デバッグ情報は、データディレクトリの GCS_DEBUG_TRACE ファイルに格納されます。

文字列として指定された使用可能なオプションのセットを組み合せることができます。次のオプションを使用できます。

GCS_DEBUG_NONE では、GCS と XCom の両方のデバッグレベルがすべて無効になります。
GCS_DEBUG_BASIC を使用すると、GCS で基本的なデバッグ情報を使用できます。
GCS_DEBUG_TRACE は GCS でトレース情報を有効にします。
XCOM_DEBUG_BASIC を使用すると、XCom の基本的なデバッグ情報を使用できます。
XCOM_DEBUG_TRACE を使用すると、XCom でトレース情報を使用できます。
GCS_DEBUG_ALL では、GCS と XCom の両方ですべてのデバッグレベルが有効になります。

デバッグレベルを GCS_DEBUG_NONE に設定すると、他のオプションを指定せずに指定した場合にのみ有効になります。デバッグレベルを GCS_DEBUG_ALL に設定すると、他のすべてのオプションがオーバーライドされます。

group_replication_communication_max_message_size

コマンド行形式	`--group-replication-communication-max-message-size=#`
導入	8.0.16
システム変数	`group_replication_communication_max_message_size`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値	`10485760`
最小値	`0`
最大値	`1073741824`

group_replication_communication_max_message_size では、グループレプリケーション通信の最大メッセージサイズを指定します。このサイズより大きいメッセージは、個別に送信され、受信者によって再アセンブルされるフラグメントに自動的に分割されます。詳細は、セクション18.6.4「メッセージの断片化」を参照してください。

10485760 バイト (10 MiB) の最大メッセージサイズがデフォルトで設定されています。つまり、MySQL 8.0.16 からのリリースでは、断片化がデフォルトで使用されます。最大許容値は、slave_max_allowed_packet システム変数の最大値 1073741824 バイト (1 GB) と同じです。アプライヤスレッドは slave_max_allowed_packet より大きいメッセージフラグメントを処理できないため、group_replication_communication_max_message_size の設定は slave_max_allowed_packet の設定より小さくする必要があります。断片化をオフにするには、group_replication_communication_max_message_size にゼロ値を指定します。

レプリケーショングループのメンバーが断片化を使用するには、グループ通信プロトコルのバージョンが MySQL 8.0.16 以上である必要があります。 group_replication_get_communication_protocol() UDF を使用して、グループ通信プロトコルのバージョンを表示します。下位バージョンが使用されている場合、グループメンバーはメッセージを断片化しません。すべてのグループメンバーがサポートしている場合は、group_replication_set_communication_protocol() UDF を使用して、グループ通信プロトコルを上位バージョンに設定できます。詳細は、セクション18.4.1.4「グループ通信プロトコルバージョンの設定」を参照してください。

group_replication_components_stop_timeout

コマンド行形式	`--group-replication-components-stop-timeout=#`
システム変数	`group_replication_components_stop_timeout`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値	`31536000`
最小値	`2`
最大値	`31536000`

group_replication_components_stop_timeout では、グループレプリケーションが停止時に各コンポーネントを待機するタイムアウトを秒単位で指定します。

group_replication_compression_threshold

コマンド行形式	`--group-replication-compression-threshold=#`
システム変数	`group_replication_compression_threshold`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値	`1000000`
最小値	`0`
最大値	`4294967295`

このシステム変数は、すべてのグループメンバーで同じ値を持つ必要があります。このシステム変数の値は、Group Replication の実行中に変更できます。変更は、メンバーでグループレプリケーションを停止して再起動した後、各グループメンバーで有効になります。このプロセス中、システム変数の値はグループメンバー間で異なってもかまいませんが、メッセージ配信の効率はすべてのメンバーで同じではありません。

group_replication_compression_threshold では、グループメンバー間で送信されるメッセージに圧縮が適用されるしきい値をバイト単位で指定します。このシステム変数をゼロに設定すると、圧縮は無効になります。

グループレプリケーションでは、LZ4 圧縮アルゴリズムを使用して、グループで送信されるメッセージを圧縮します。 LZ4 圧縮アルゴリズムでサポートされる最大入力サイズは 2113929216 バイトです。この制限は、XCom で受け入れられる最大メッセージサイズと一致する、group_replication_compression_threshold システム変数の最大可能値を下回っています。 LZ4 圧縮アルゴリズムでは、メッセージ圧縮が有効な場合、このサイズを超えるトランザクションはコミットできないため、group_replication_compression_threshold に 2113929216 バイトを超える値を設定しないでください。

詳細は、セクション18.6.3「メッセージ圧縮」を参照してください。

group_replication_consistency

コマンド行形式	`--group-replication-consistency=value`
導入	8.0.14
システム変数	`group_replication_consistency`
スコープ	グローバル、セッション
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	列挙
デフォルト値	`EVENTUAL`
有効な値	`EVENTUAL` `BEFORE_ON_PRIMARY_FAILOVER` `BEFORE` `AFTER` `BEFORE_AND_AFTER`

このシステム変数の値は、Group Replication の実行中に変更できます。group_replication_consistency は Group Replication プラグイン固有の変数ではなくサーバーシステム変数であるため、変更を有効にするために Group Replication を再起動する必要はありません。システム変数のセッション値の変更はただちに有効になり、グローバル値の変更は変更後に開始される新しいセッションに対して有効になります。このシステム変数のグローバル設定を変更するには、GROUP_REPLICATION_ADMIN 権限が必要です。

group_replication_consistency は、グループが提供するトランザクションの一貫性保証を制御します。一貫性はグローバルに構成することも、トランザクションごとに構成することもできます。group_replication_consistency は、単一のプライマリグループで新しく選択されたプライマリによって使用されるフェンシングメカニズムも構成します。変数の効果は、読取り専用 (RO) トランザクションと読取り/書込み (RW) トランザクションの両方で考慮する必要があります。次のリストは、トランザクションの一貫性保証を高めるために、この変数に指定できる値を示しています:

EVENTUAL

RO トランザクションと RW トランザクションはどちらも、実行前に先行するトランザクションが適用されるのを待機しません。これは、この変数が追加される前の Group Replication の動作です。 RW トランザクションは、他のメンバーがトランザクションを適用するのを待機しません。つまり、あるメンバーでトランザクションを外部化してから別のメンバーに外部化できます。つまり、プライマリフェイルオーバーが発生した場合、新しいプライマリは、前のプライマリトランザクションがすべて適用される前に新しい RO および RW トランザクションを受け入れることができます。 RO トランザクションは古い値になる可能性があり、RW トランザクションは競合のためロールバックする可能性があります。
BEFORE_ON_PRIMARY_FAILOVER

古いプライマリからバックログを適用している、新しく選択されたプライマリを持つ新しい RO または RW トランザクションは、バックログが適用されるまで保持されます (適用されません)。これにより、プライマリフェイルオーバーが意図的に発生したかどうかにかかわらず、クライアントには常にプライマリの最新の値が表示されます。これにより一貫性が保証されますが、バックログが適用されている場合、クライアントは遅延を処理できる必要があります。通常、この遅延は最小限に抑える必要がありますが、バックログのサイズによって異なります。
BEFORE

RW トランザクションは、先行するすべてのトランザクションが完了するまで待機してから適用されます。 RO トランザクションは、先行するすべてのトランザクションが完了するまで待機してから実行されます。これにより、トランザクションのレイテンシにのみ影響を与えることで、このトランザクションが最新の値を読み取るようになります。これにより、RO トランザクションでのみ同期が使用されるようになるため、すべての RW トランザクションでの同期のオーバーヘッドが削減されます。この一貫性レベルには、BEFORE_ON_PRIMARY_FAILOVER によって提供される一貫性保証も含まれます。
AFTER

RW トランザクションは、その変更が他のすべてのメンバーに適用されるまで待機します。この値は RO トランザクションには影響しません。このモードでは、トランザクションがローカルメンバーでコミットされたときに、後続のトランザクションが書込み値またはグループメンバーのより新しい値を読み取ることが保証されます。このモードは、主に RO 操作に使用されるグループとともに使用して、適用された RW トランザクションがコミット後のすべての場所に確実に適用されるようにします。これは、後続の読取りで最新の書込みを含む最新のデータがフェッチされるようにするために、アプリケーションで使用できます。これにより、RW トランザクションでのみ同期が使用されるようになるため、RO トランザクションごとの同期のオーバーヘッドが削減されます。この一貫性レベルには、BEFORE_ON_PRIMARY_FAILOVER によって提供される一貫性保証も含まれます。
BEFORE_AND_AFTER

RW トランザクションは、1) 前のすべてのトランザクションが適用されるまで待機し、2) 変更が他のメンバーに適用されるまで待機します。 RO トランザクションは、先行するすべてのトランザクションが完了するまで待機してから実行されます。この一貫性レベルには、BEFORE_ON_PRIMARY_FAILOVER によって提供される一貫性保証も含まれます。

詳細は、セクション18.4.2「トランザクション一貫性保証」を参照してください。

group_replication_enforce_update_everywhere_checks

コマンド行形式	`--group-replication-enforce-update-everywhere-checks[={OFF\|ON}]`
システム変数	`group_replication_enforce_update_everywhere_checks`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Boolean
デフォルト値	`OFF`

このシステム変数は、グループ全体の構成設定です。値の変更を有効にするには、すべてのグループメンバーで同じ値を持つ必要があり、グループレプリケーションの実行中は変更できず、グループ (group_replication_bootstrap_group=ON を使用したサーバーによるブートストラップ) を完全に再起動する必要があります。 MySQL 8.0.16 から、group_replication_switch_to_single_primary_mode() および group_replication_switch_to_multi_primary_mode() UDF を使用して、グループの実行中にこのシステム変数の値を変更できます。詳細は、セクション18.4.1.2「グループモードの変更」を参照してください。

group_replication_enforce_update_everywhere_checks は、マルチプライマリ更新の厳密な整合性チェックをどこでも有効または無効にします。デフォルトでは、チェックは無効になっています。シングルプライマリモードでは、すべてのグループメンバーでこのオプションを無効にする必要があります。マルチプライマリモードでは、このオプションを有効にすると、ステートメントは次のようにチェックされ、マルチプライマリモードと互換性があることが確認されます:

トランザクションが SERIALIZABLE 分離レベルで実行される場合、トランザクション自体をグループと同期するとコミットは失敗します。
カスケード制約を持つ外部キーを持つテーブルに対してトランザクションが実行される場合、トランザクションはグループとの同期時にコミットに失敗します。

group_replication_exit_state_action

コマンド行形式	`--group-replication-exit-state-action=value`
導入	8.0.12
システム変数	`group_replication_exit_state_action`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	列挙
デフォルト値 (≥ 8.0.16)	`READ_ONLY`
デフォルト値 (≥ 8.0.12, ≤ 8.0.15)	`ABORT_SERVER`
有効な値 (≥ 8.0.18)	`ABORT_SERVER` `OFFLINE_MODE` `READ_ONLY`
有効な値 (≥ 8.0.12, ≤ 8.0.17)	`ABORT_SERVER` `READ_ONLY`

group_replication_exit_state_action では、たとえばアプライヤエラーが発生した後、大部分が失われた場合、または疑わしいタイムアウトのためにグループの別のメンバーがグループを明示する場合などに、このサーバーインスタンスが意図せずグループを離れたときのグループレプリケーションの動作を構成します。大部分が失われた場合にメンバーがグループを離れるタイムアウト期間は group_replication_unreachable_majority_timeout システム変数によって設定され、疑わしい場合のタイムアウト期間は group_replication_member_expel_timeout システム変数によって設定されます。削除されたグループメンバーは、グループに再接続するまで削除されたことを認識しないため、指定されたアクションが実行されるのは、メンバーが再接続を管理している場合、またはメンバーがそれ自体で疑わしいことを引き起こして削除した場合のみです。

疑わしいタイムアウトまたは大部分の損失が原因でグループメンバーが削除された場合、メンバーの group_replication_autorejoin_tries システム変数が自動再結合の試行回数を指定するように設定されていると、最初にスーパー読取り専用モードで指定された回数試行し、次に group_replication_exit_state_action で指定されたアクションに従います。アプライヤエラーの場合、自動再結合はリカバリできないため試行されません。

group_replication_exit_state_action が READ_ONLY に設定されている場合、メンバーが誤ってグループを終了するか、自動再結合の試行を使い果たすと、インスタンスは MySQL をスーパー読取り専用モードに切り替えます (システム変数 super_read_only を ON に設定します)。 READ_ONLY 終了アクションは、システム変数が導入される前の MySQL 8.0 リリースの動作であり、MySQL 8.0.16 から再度デフォルトになりました。

group_replication_exit_state_action が OFFLINE_MODE に設定されている場合、メンバーが誤ってグループを終了するか、自動再結合の試行を使い果たすと、インスタンスは MySQL をオフラインモードに切り替えます (システム変数 offline_mode を ON に設定します)。このモードでは、接続クライアントユーザーは次のリクエストで切断され、CONNECTION_ADMIN 権限 (または非推奨の SUPER 権限) を持つクライアントユーザーを除き、接続は受け入れられなくなります。 Group Replication は、システム変数 super_read_only を ON に設定することもできるため、クライアントが CONNECTION_ADMIN または SUPER 権限で接続されていても更新を行うことはできません。 OFFLINE_MODE 終了アクションは、MySQL 8.0.18 から使用できます。

group_replication_exit_state_action が ABORT_SERVER に設定されている場合、メンバーが意図せずグループを終了するか、自動再結合の試行を使い果たすと、インスタンスは MySQL を停止します。この設定は、システム変数が MySQL 8.0.15 に追加されたときの MySQL 8.0.12 のデフォルトでした。

重要

メンバーがグループに正常に参加する前に障害が発生した場合、指定された終了アクション取得されません。これは、ローカル構成チェック中に障害が発生した場合、または参加メンバーの構成とグループの構成が一致しない場合です。このような状況では、super_read_only システム変数は元の値のままで、接続は引き続き受け入れられ、サーバーは MySQL を停止しません。したがって、Group Replication が起動しなかったときにサーバーが更新を受け入れられないようにするには、起動時に super_read_only=ON をサーバー構成ファイルに設定することをお薦めします。これは、正常に起動された後、プライマリメンバー上の OFF にグループレプリケーションが変更されます。この保護策は、サーバーがサーバー起動時に Group Replication (group_replication_start_on_boot=ON) を起動するように構成されている場合に特に重要ですが、START GROUP_REPLICATION コマンドを使用して Group Replication を手動で起動する場合にも役立ちます。

このオプションの使用方法および exit アクションが実行される状況の完全なリストの詳細は、セクション18.6.6.4「終了処理」を参照してください。

group_replication_flow_control_applier_threshold

コマンド行形式	`--group-replication-flow-control-applier-threshold=#`
システム変数	`group_replication_flow_control_applier_threshold`
スコープ	グローバル
動的	はい
`SET_VAR` ヒントの適用	いいえ
型	Integer
デフォルト値	`25000`
最小値	`0`
最大値	`2147483647`