PolarDB:PolarProxyの設定

前提条件

PolarDB for MySQLクラスターはcluster Editionです。 クラスターのエディションの詳細については、「エディション」をご参照ください。

使用上の注意

並列クエリ機能を有効にし、並列処理の程度を指定できるのは、PolarDB for MySQL 8.0クラスターにPolarProxyを設定する場合のみです。

手順

1. PolarDBコンソールにログインします。

2. 左上隅で、クラスターがデプロイされているリージョンを選択します。

3. クラスターを見つけて、そのIDをクリックします。

4. クラスターの概要ページのデータベース接続セクションクで、PolarProxyを設定したいクラスターエンドポイントを見つけ、エンドポイント名の右側に設定をクリックします。

   

5. 表示されるダイアログボックスで、ビジネス要件に基づいてクラスターエンドポイントの設定を変更します。 次の表に、設定できるパラメーターを示します。

   表 1. Parameters

   パラメーター		説明
   ネットワーク情報		デフォルトでは、PolarDBは各クラスターエンドポイントにプライベートエンドポイントを提供します。 プライベートエンドポイントを変更するか、パブリックエンドポイントを申請することができます。 詳細については、「エンドポイントの管理」をご参照ください。
   クラスター設定	読み書きモード	クラスターエンドポイントの読み取り /書き込みモード。 ビジネス要件に基づいて、読み取り専用 または 読み書き (自動読み書き分離) を選択できます。 説明 クラスターエンドポイントの作成後に、カスタムクラスターエンドポイントの読み取り /書き込みモードを変更できます。 カスタムクラスタエンドポイントの読み取り /書き込みモードを変更すると、新しいモードは新しい接続に対してのみ有効になります。 元のモードは、既存の接続に対して引き続き有効になります。
   	エンドポイント名	カスタムクラスターエンドポイントの名前。
   ノード設定	選択されていないノードおよび選択ノード	左側の 選択されていないノード リストから、クラスターエンドポイントに関連付けるノードを選択します。 [使用可能なノード] リストには、プライマリノードとすべての読み取り専用ノードが含まれます。 次に、アイコンをクリックして、選択したノードを右側の 選択ノード リストに追加します。 説明 選択したノードのタイプは、エンドポイントの読み取り /書き込みモードには影響しません。 読み取り /書き込みパラメーターを読み書き (自動読み書き分離) に設定した場合、プライマリノードが 選択ノード リストに追加されているかどうかに関係なく、書き込みリクエストはプライマリノードにのみ送信されます。 読み取り /書き込みパラメーターを読み取り専用に設定した場合、すべての読み取りリクエストはロードバランシングモードの読み取り専用ノードに転送されます。 プライマリノードが 選択ノード リストに追加されても、読み取り要求はプライマリノードに転送されません。
   	新しいノードを自動的に関連付ける	新しいノードをクラスターエンドポイントに自動的に関連付けるかどうかを指定します。
   SLB 設定	負荷バランスポリシー	読み取り専用ノード間で読み取り要求を負荷分散するためのポリシー。 ビジネス要件に基づいて、接続数に基づく負荷分散 と アクティブなリクエストベースのロードバランシング を選択できます。 負荷分散ポリシーの詳細については、「負荷分散ポリシー」をご参照ください。
   	プライマリノードによる読み取りリクエストの許可	このパラメーターを [いいえ] に設定すると、読み取り要求は読み取り専用ノードにのみ送信され、プライマリノードの負荷が軽減されます。 このパラメーターを [はい] に設定すると、読み取り要求はプライマリノードと読み取り専用ノードに送信されます。 詳細については、「プライマリノードが読み取り要求を受け入れる」をご参照ください。 説明 このパラメーターは、読み取り /書き込みパラメーターを読み書き (自動読み書き分離) に設定した場合にのみ使用できます。
   	トランザクション分離	トランザクション分割機能を有効にするかどうかを指定します。 詳細については、「トランザクション分割」をご参照ください。 説明 このパラメーターは、読み取り /書き込みパラメーターを読み書き (自動読み書き分離) に設定した場合にのみ使用できます。
   	オンデマンド接続	オンデマンド接続を有効にするかどうかを指定します。 詳細については、「オンデマンド接続」をご参照ください。 説明 このパラメーターは、[負荷分散ポリシー] パラメーターを アクティブなリクエストベースのロードバランシング に設定した場合にのみ使用できます。
   整合性設定	一貫性レベル	読み取り /書き込みパラメーターを読み書き (自動読み書き分離) に設定した場合、最終的な整合性 (弱) 、セッション整合性 (中) 、およびグローバル整合性 (強) の整合性レベルを使用できます。 詳細については、「一貫性レベル」をご参照ください。 読み取り /書き込みパラメーターを読み取り専用に設定した場合、整合性レベルはデフォルトで最終的な整合性 (弱) であり、変更することはできません。 重要 整合性レベルの変更は、すぐにすべての接続に反映されます。 グローバル整合性 (高パフォーマンスモード) は、有効化後のクラスターのすべてのエンドポイントに適用されます。 このモードを無効にすると、すべてのエンドポイントの整合性レベルがモードを有効にする前の値に復元されます。
   	グローバル一貫性タイムアウト	PolarProxyが読み取り要求を受信した後、すべての読み取り専用ノードがプライマリノードの最新のLSNに更新されるのをPolarProxyが待機する最大期間。 有効な値: 0 ~ 60,000 デフォルト値は 20 です。 単位：ミリ秒。 説明 このパラメーターは、一貫性レベル パラメーターを [グローバル一貫性 (強力)] に設定し、[グローバル一貫性モード] パラメーターを [従来のモード] に設定した場合にのみ使用できます。
   	グローバル一貫性タイムアウトポリシー	指定されたタイムアウト期間内にPolarDB読み取り専用ノード間でグローバル整合性が達成されない場合に適用する既定のポリシー。 有効な値： プライマリノードにリクエストを送信 (デフォルト) SQL 例外：レプリケーション完了タイムアウトを待ち、再試行してください。 説明 このパラメーターは、一貫性レベル パラメーターを [グローバル一貫性 (強力)] に設定し、[グローバル一貫性モード] パラメーターを [従来のモード] に設定した場合にのみ使用できます。
   	グローバル整合性読み取りタイムアウト (ハイパフォーマンスモード)	PolarProxyが読み取り要求を受信した後、すべての読み取り専用ノードが最新のセッションLSNと同期するのをPolarProxyが待機する最大期間。 値の範囲: 1 ~ 1,000,000 デフォルト値：100 単位：ミリ秒。 重要 グローバル整合性 (高パフォーマンスモード) は、有効化後のクラスターのすべてのエンドポイントに適用されます。 クラスターの1つのエンドポイントに対してこのモードを有効にすると、クラスターの他のすべてのエンドポイントに対してこのモードが有効になります。 このパラメーターは、一貫性レベル パラメーターを [グローバル一貫性 (強力)] に設定し、[グローバル一貫性モード] パラメーターを [高性能モード] に設定した場合にのみ使用できます。
   	グローバル整合性読み取りタイムアウトポリシー (ハイパフォーマンスモード)	指定されたタイムアウト期間内にPolarDB読み取り専用ノード間でグローバル整合性が達成されない場合に適用する既定のポリシー。 有効な値： プライマリノードへのリクエストの送信 (デフォルト) タイムアウトによるエラーメッセージの返信 クエリ内のグローバルな一貫性のある読み取りがタイムアウトしたときに、クエリの一貫性レベルを一貫性のない読み取りにダウングレードします。 クライアントにはエラーメッセージは返されません。 説明 このパラメーターは、一貫性レベル パラメーターを [グローバル一貫性 (強力)] に設定し、[グローバル一貫性モード] パラメーターを [高性能モード] に設定した場合にのみ使用できます。
   	セッション整合性タイムアウト	PolarProxyがセッションで読み取り要求を受信した後、セッション内の読み取り専用ノードが最新のセッションLSNと同期するのをPolarProxyが待機する最大期間。 有効な値: 0 ~ 60,000 デフォルト値：0 単位：ミリ秒。 重要 このパラメーターは、[一貫性レベル] パラメーターを [セッション一貫性 (中)] に設定した場合にのみ使用できます。 グローバル整合性 (高パフォーマンスモード) は、有効化後のクラスターのすべてのエンドポイントに適用されます。 このモードを無効にすると、すべてのエンドポイントの整合性レベルがモードを有効にする前の値に復元されます。
   	セッション整合性タイムアウトポリシー	指定された期間内にPolarDB読み取り専用ノード間でセッションの一貫性が達成されなかった場合に適用する既定のポリシー。 有効な値： プライマリノードへのリクエストの送信 (デフォルト) SQL例外: レプリケーション完了タイムアウトを待ちます。再試行してください。 説明 このパラメーターは、[一貫性レベル] パラメーターを [セッション一貫性 (中)] に設定した場合にのみ使用できます。
   接続プールの設定	接続プール	有効な値: オフ、Session-level、Transaction-level。 デフォルト値: Off。 接続プールの詳細については、「接続プール」をご参照ください。 説明 このパラメーターは、読み取り /書き込みパラメーターを読み書き (自動読み書き分離) に設定した場合にのみ使用できます。
   HTAP最適化	並行クエリ	並列クエリ機能を有効にするかどうかを指定し、並列処理の程度を指定します。 elastic parallel query (ePQ) 機能は、マルチコアCPUとクラスター内のアイドルコンピューティングリソースを効果的に使用して、複雑なクエリを高速化できます。 詳細については、「ePQの概要」をご参照ください。 説明 2023年4月1日以降、クラスターが次の条件を満たすと、クラスターに対してePQ機能が自動的に有効になります。 デフォルトの並列度は2です。 新しいクラスターの場合、CPUコアの数は8以上です。 既存のクラスターの場合、カスタムクラスターエンドポイントが作成され、CPUコアの数は8以上です。
   	トランザクションと分析処理の分離	行ストアおよび列ストアノード間でのリクエストの自動配布を有効にするかどうかを指定します。 詳細については、「行ストアおよび列ストアノード間のリクエストの自動配布」をご参照ください。 説明 このパラメーターは、次の要件を満たしている場合にのみ使用できます。クラスターは、リビジョンバージョンが8.0.1.1.22以降のPolarDB for MySQL 8.0.1を実行します。 クラスターエンドポイントが読み書き モードになっています。 ノード設定 セクションの 選択ノード リストには、少なくとも1つの読み取り専用列ストアノードが含まれます。
   	列ストアノードはOLTP要求を処理します	列ストアノードがオンライントランザクション処理 (OLTP) 要求を処理できるようにするかどうかを指定します。 列ストアノードがOLTP要求を処理することが許可されている場合、ノードはオンライン分析処理 (OLAP) とOLTP要求の両方を受信します。 PolarProxyは、アクティブな要求の数に基づいて、OLTP読み取り要求を列ストアノードにルーティングします。 これにより、列ストアノードの負荷が増加する可能性があります。 説明 このパラメーターは、トランザクションと分析処理の分離を有効にした場合にのみ使用できます。
   セキュリティ保護	過負荷保護	過負荷保護機能を有効にするかどうかを指定します。 詳細については、「オーバーロード保護」をご参照ください。

6. OKをクリックします。

関連する API 操作