すべてのプロダクト
Search

このプロダクト

    PolarDB:構成パラメーター

    ドキュメントセンター

    PolarDB:構成パラメーター

    最終更新日:May 30, 2025

    このトピックでは、elastic parallel query 機能のパラメーターと変数について説明します。

    パラレルクエリ パラメーター

    説明

    MySQL 構成ファイルの互換性プレフィックス loose_メディアをアップロードする は、PolarDB コンソールのすべてのクラスタパラメーターに追加されます。 PolarDB コンソールでパラメーターを変更する場合は、loose_ プレフィックスを含むパラメーターを変更してください。

    パラメーター

    レベル

    説明

    loose_max_parallel_degree

    グローバルとセッション

    個々のクエリの並列処理の最大次数（DOP）。 このパラメーターは、クエリを並列で実行するために使用されるワーカーの最大数を指定します。

    • 有効な値: 0 ～ 1024。

    • デフォルト値: 0。この値は、elastic parallel query 機能が無効になっていることを示します。

    説明

    • PolarDB オプティマイザーは、異なる elastic parallel query 実行プランを使用して、メインクエリとサブクエリを並列で実行できます。 オプティマイザーが同じプランを使用する場合、ワーカーの最大数は loose_max_parallel_degree の値を超えることはできません。 クエリ全体で使用されるワーカーの総数は、メインクエリとサブクエリで使用されるワーカーの合計です。

    • コンソールの elastic parallel query 設定と loose_max_parallel_degree パラメーターは、次のルールに基づいて有効になります。

      • PolarDB コンソールで elastic parallel query 機能を有効にし、loose_max_parallel_degree パラメーターを構成した場合、コンソールの設定が有効になります。 PolarDB コンソールで elastic parallel query 機能を有効にすることをお勧めします。

      • PolarDB コンソールで elastic parallel query 機能を有効にしていないが、loose_max_parallel_degree パラメーターを 0 より大きい値に設定した場合、elastic parallel query 機能は自動的に有効になります。

    loose_max_parallel_workers

    グローバル

    パラレルワーカーの最大数。 パラレルワーカーの数が指定された値を超えると、新しいパラレルクエリはキューに入り、待機します。

    • 有効な値: 1 ～ 10000。

    • デフォルト値は CPU コア数の 2 倍です。

    説明

    loose_queuing_parallel_degree_limit

    グローバル

    一度にキューに入ることができるパラレルクエリの DOP 値の最大合計。 指定された値を超えると、追加のクエリにはパラレルクエリのリソースが付与されず、順次実行が使用されます。

    • 有効な値: 0 ～ 10000。

    • デフォルト値: 64。

    loose_pq_max_queuing_time

    グローバルとセッション

    キューでの最大待機時間。 キューでの待機時間が指定された値を超えると、順次実行が使用されます。

    • 有効な値: 0 ～ 18446744073709551615。

    • デフォルト値: 200。

    • 単位: ミリ秒。

    loose_parallel_degree_policy

    グローバル

    個々のクエリの DOP ポリシー。 有効な値:

    • TYPICAL: PolarDB は、CPU 使用率などのデータベース負荷に関係なく、DOP を loose_max_parallel_degree と同じ値に設定します。

    • AUTO: PolarDB は、CPU 使用率などのデータベース負荷に基づいて elastic parallel query 機能を有効または無効にし、クエリコストに基づいて DOP を選択します。

    • REPLICA_AUTO (デフォルト): 読み取り専用ノードのみが、CPU 使用率などのデータベース負荷に基づいて elastic parallel query 機能を有効にするかどうかを決定し、クエリコストに基づいて DOP を選択します。 プライマリノードは elastic parallel query を実行しません。

    説明

    並列処理の次数の構成ポリシーの詳細については、「DOP ポリシー」をご参照ください。

    loose_records_threshold_for_parallelism

    セッション

    スキャンされた行数が loose_records_threshold_for_parallelism の値を超えると、オプティマイザーは elastic parallel query 機能を有効にします。

    • 有効な値: 0 ～ 18446744073709551615。

    • デフォルト値: 10000。

    説明

    クエリの大部分が単純で、少量のデータしか含まれていない場合は、しきい値を少なくとも 2000 に設定することをお勧めします。

    loose_cost_threshold_for_parallelism

    セッション

    順次クエリの コスト が cost_threshold_for_parallelism の値を超えると、オプティマイザーは elastic parallel query 機能を有効にします。

    • 有効な値: 0 ～ 18446744073709551615。

    • デフォルト値: 50000。

    loose_records_threshold_for_mpp

    セッション

    クエリ文に含まれるテーブルのスキャン行数がこのしきい値を超えると、オプティマイザーはマルチノード elastic parallel query の使用を検討します。

    • 有効な値: 0 ～ 18446744073709551615。

    • デフォルト値: 0。値 0 は、[loose_records_threshold_for_parallelism 値の N 倍を示します。 N 値は、現在のクラスターのノード数です。]

    loose_cost_threshold_for_mpp

    セッション

    クエリ文の順次実行コストがこのしきい値を超えると、オプティマイザーはマルチノード elastic parallel query の使用を検討します。

    • 有効な値: 0 ～ 18446744073709551615。

    • デフォルト値: 0。値 0 は、[loose_cost_threshold_for_parallelism 値の N 倍を示します。 N 値は、現在のクラスターのノード数です。]

    パラレルクエリ変数

    変数

    レベル

    説明

    Parallel_workers_created

    グローバルとセッション

    セッション開始以降に作成されたパラレルワーカーの数。

    Gather_records

    グローバルとセッション

    収集されたレコードの総数。

    PQ_refused_over_total_workers

    グローバルとセッション

    ワーカーの総数の制限により、並列で実行されなかったクエリの数。

    PQ_refused_over_max_queuing_time

    グローバルとセッション

    パラレルクエリキューのタイムアウトにより、並列で実行されなかったクエリの数。

    Total_running_parallel_workers

    グローバル

    実行中のパラレルワーカーの数。