PolarDB:PolarProxy の設定

前提条件

プロダクトエディションは PolarDB for MySQL Cluster Edition である必要があります。プロダクトエディションの詳細については、「Enterprise Edition」をご参照ください。

注意事項

PolarProxy のパラレルクエリを有効化し、その並列処理の次数を設定できるのは、PolarDB for MySQL 8.0 クラスターでのみです。

操作手順

1. PolarDB コンソール にログインします。左側のナビゲーションウィンドウで クラスター をクリックします。リージョン でご利用のクラスターがデプロイされているリージョンを選択し、対象のクラスター ID をクリックします。

2. 概要 ページの データベースへの接続 セクションで、対象のクラスターエンドポイントを見つけ、エンドポイント名の右側にある 構成 をクリックします。

3. 表示されたダイアログボックスで、必要に応じてクラスターエンドポイントの設定を変更します。以下の表にパラメーターの説明を示します。

   表 1. 設定項目

   パラメーター		説明
   ネットワーク情報		デフォルトでは、PolarDB は各クラスターエンドポイントにプライベートエンドポイントを割り当てます。プライベートエンドポイントを変更する場合やパブリックエンドポイントを申請する場合は、「エンドポイントの管理」をご参照ください。
   クラスター設定	読み書きモード	クラスターエンドポイントの読み書きモードです。有効な値は、読み取り専用 および 読み書き (自動読み書き分離) です。 説明 カスタムエンドポイント作成後、読み書きモードを変更できます。新しいモードは新規接続に対してのみ適用され、既存の接続には影響しません。
   	エンドポイント名	クラスターエンドポイントの名前を入力します。
   ノード設定	選択されていないノード および 選択ノード	［選択されていないノード］ボックスには、プライマリノードとすべての読み取り専用ノードが表示されます。読み取りリクエストを処理するノードを選択し、 アイコンをクリックして［選択ノード］ボックスに移動します。 説明 ノードの選択は読み書きモードに影響しません。 読み書きモードが 読み書き (自動読み書き分離) の場合、書き込みリクエストは常にプライマリノードに送信されます。これは、プライマリノードが 選択ノード ボックス内にあるかどうかに関係ありません。 読み書きモードが 読み取り専用 の場合、すべての読み取りリクエストは選択された読み取り専用ノード間で分散されます。プライマリノードが 選択ノード ボックスに含まれていても、リクエストはプライマリノードに送信されません。 読み書きモードが 読み書き (自動読み書き分離) の場合、マルチプライマリクラスター (Limitless) ではデータベース/テーブル単位のルーティングメカニズムを使用します。ターゲットのデータベースまたはテーブルをホストするプライマリノードを読み書きエンドポイントに追加するか、すべてのプライマリノードを選択する必要があります。ノードを選択する前に、ルーティングへの影響を評価してください。
   	新しいノードを自動的に関連付ける	新しく追加されたノードをこのエンドポイントに自動的に追加するかどうかを指定します。
   SLB 設定	負荷バランスポリシー	読み書き分離が有効な場合に、複数のノード間で読み取りリクエストを分散するためのスケジューリングポリシーです。有効な値は、接続数に基づく負荷分散 および アクティブなリクエストベースのロードバランシング です。詳細については、「負荷分散ポリシー」をご参照ください。
   	プライマリノードによる読み取りリクエストの許可	いいえ を選択すると、クエリは読み取り専用ノードにのみ送信されます。これにより、プライマリノードの負荷が軽減され、安定性が確保されます。 はい を選択すると、クエリはプライマリノードおよび読み取り専用ノードの両方に送信されます。 詳細については、「プライマリノードが読み取りリクエストを受け付ける」をご参照ください。 説明 この設定は、読み書き (自動読み書き分離) モードでのみ利用可能です。
   	トランザクション分離	トランザクション分割機能を有効または無効にします。詳細については、「トランザクション分割」をご参照ください。 説明 この設定は、読み書き (自動読み書き分離) モードでのみ利用可能です。
   	オンデマンド接続	オンデマンド接続機能を有効または無効にします。詳細については、「オンデマンド接続」をご参照ください。 説明 この設定は、ロードバランシング方式 が アクティブなリクエストベースのロードバランシング に設定されている場合にのみ利用可能です。
   整合性設定	一貫性レベル	読み書きモードが 読み書き (自動読み書き分離) の場合、最終的な整合性 (弱)、セッション整合性 (中)、または グローバル整合性 (強) を選択できます。詳細については、「整合性レベル」をご参照ください。 読み書きモードが 読み取り専用 の場合、整合性レベルは 最終的な整合性 (弱) に固定されます。 重要 整合性レベルの設定は、クラスターに少なくとも 1 つの読み取り専用 (RO) ノードがある場合にのみ表示されます。クラスターに読み取り専用ノードがない場合は、このセクションは表示されません。 このモードを 1 つのエンドポイントで有効にすると、クラスター内のすべてのエンドポイントで有効になります。無効にすると、すべてのエンドポイントが以前に設定されていた整合性レベルに戻ります。 整合性レベルの設定は、クラスターに少なくとも 1 つの読み取り専用 (RO) ノードがある場合にのみ表示されます。クラスターに読み取り専用ノードがない場合は、このセクションは表示されません。
   	グローバル一貫性タイムアウト	読み取り専用ノードがプライマリノードからのデータ同期を待機するタイムアウト期間です。有効な値：0～60,000。デフォルト値：20。単位：ms。 説明 このパラメーターは、一貫性レベル が グローバル整合性 (強) に設定されており、かつ グローバル整合性モード が 伝統モード に設定されている場合にのみ利用可能です。
   	グローバル一貫性タイムアウトポリシー	読み取り専用ノードでタイムアウトが発生した際に PolarDB が適用するポリシーです。有効な値： プライマリノードにリクエストを送信 (デフォルト) SQL 例外：レプリケーション完了タイムアウトを待ち、再試行してください。 説明 このパラメーターは、一貫性レベル が グローバル整合性 (強) に設定されており、かつ グローバル整合性モード が 伝統モード に設定されている場合にのみ利用可能です。
   	グローバル整合性読み取りタイムアウト (高性能モード)	読み取り専用ノードがプライマリノードからのデータ同期を待機するタイムアウト期間です。有効な値：1～1,000,000。デフォルト値：100。単位：ms。 重要 グローバル整合性 (高性能モード) はクラスター内のすべてのエンドポイントに適用されます。1 つのエンドポイントでこのモードを有効にすると、すべてのエンドポイントで有効になります。 このパラメーターは、一貫性レベル が グローバル整合性 (強) に設定されており、かつ グローバル整合性モード が 高性能モード に設定されている場合にのみ利用可能です。
   	グローバル整合性読み取りタイムアウトポリシー (高性能モード)	読み取り専用ノードでタイムアウトが発生した際に PolarDB が適用するポリシーです。有効な値： プライマリノードにリクエストを送信 (デフォルト) 1：タイムアウトエラー。クライアントはエラーメッセージを返します クエリ内のグローバル一貫性読み取りがタイムアウトした場合、クエリの一貫性レベルは非一貫性読み取りにダウングレードされます。クライアントにエラーメッセージは返されません。 説明 このパラメーターは、一貫性レベル が グローバル整合性 (強) に設定されており、かつ グローバル整合性モード が 高性能モード に設定されている場合にのみ利用可能です。
   	セッション整合性の読み取りタイムアウト	読み取り専用ノードがプライマリノードからのデータ同期を待機するタイムアウト期間です。有効な値：0～60,000。デフォルト値：0。単位：ms。 重要 このパラメーターは、一貫性レベル が セッション整合性 (中) に設定されている場合にのみ利用可能です。
   	セッション整合性の読み取りタイムアウトポリシー	読み取り専用ノードでタイムアウトが発生した際に PolarDB が適用するポリシーです。有効な値： プライマリノードにリクエストを送信 (デフォルト) SQL 例外：レプリケーション完了タイムアウトを待ち、再試行してください。 説明 このパラメーターは、一貫性レベル が セッション整合性 (中) に設定されている場合にのみ利用可能です。
   接続プールの設定	接続プール	オフ (デフォルト)、セッションレベル、または トランザクションレベル を選択できます。詳細については、「接続プール」をご参照ください。 説明 この設定は、読み書き (自動読み書き分離) モードでのみ利用可能です。 これらの変更は新規接続に対してのみ適用されます。既存のセッションに適用するには、アプリケーションを再起動するか、データベース接続を再確立してください。
   HTAP の最適化	並行クエリ	パラレルクエリ機能を有効または無効にし、並列処理の次数を設定します。 エラスティックパラレルクエリ (ePQ) を有効にすると、マルチコア CPU の並列処理能力 (クラスター内のアイドルコンピューティングリソース) を活用して複雑なクエリを高速化できます。詳細については、「エラスティック並列クエリ」をご参照ください。 説明 2023 年 4 月 1 日以降、クラスターが以下の条件を満たす場合、エラスティックパラレルクエリはデフォルトで有効になり、並列処理の次数は 2 に設定されます。 新規クラスターの場合：クラスターの CPU コア数が 8 コア以上であること。 既存クラスターの場合：CPU コア数が 8 コア以上の既存クラスターに対してカスタムクラスターエンドポイントが作成されること。
   	トランザクションと分析処理の分離	トランザクション処理/分析処理の分割機能を有効または無効にします。詳細については、「トランザクション処理/分析処理の分割の設定」をご参照ください。 説明 PolarDB for MySQL 8.0.1 クラスターでマイナーエンジンバージョンが 8.0.1.1.22 以降の場合、クラスターエンドポイントが 読み書き モードであり、かつ ノード設定 の 選択ノード ボックスに少なくとも 1 つの読み取り専用カラムストアノードが含まれている場合にのみ、この設定がサポートされます。
   	列ストアノードは OLTP リクエストを処理します。	カラムストアノードが OLTP リクエストを受け付けるかどうかを指定します。 有効にすると、カラムストアノードは OLAP リクエストと OLTP リクエストの両方を処理します。データベースプロキシは、アクティブリクエスト数に基づいて OLTP 読み取りリクエストをカラムストアノードにルーティングするため、これらのノードの負荷が増加する可能性があります。 説明 この設定は、トランザクションと分析処理の分離 が有効になっている場合にのみ利用可能です。
   セキュリティ保護	過負荷保護	過負荷保護機能を有効または無効にします。詳細については、「過負荷保護」をご参照ください。

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

よくある質問

API リファレンス