並列クエリの有効化または無効化
ダウンロード
フォーカスモード
フォントサイズ
TDSQL-C for MySQLはパラレルクエリ機能をサポートしています。コンソールまたはコマンドラインを通じて関連パラメータを調整し、インスタンスのパラレルクエリ機能を有効または無効にすることができます。
前提条件
データベースバージョン：TDSQL-C for MySQL 8.0 カーネルバージョン 3.1.8 以上。
新規サポートパラメータ機能を使用するには、カーネルバージョン TXSQL 8.0 3.1.15 以上が必要です。
パラメータ説明
説明：
読み書きインスタンスと読み取り専用インスタンスの両方がパラレルクエリ機能の有効化をサポートしています。ただし、インスタンスのCPUコア数は4以上である必要があります。
コンソールまたはコマンドラインを通じて、パラメータ txsql_max_parallel_worker_threads と txsql_parallel_degree を0以外の値に設定することで、現在のインスタンスのパラレルクエリ機能を有効にできます。パラメータの関連情報と具体的な設定推奨事項は以下の通りです。
パラメータ情報
パラメータ | 変数タイプ | スコープ | 既定値 | 値の範囲 | 説明 |
txsql_max_parallel_worker_threads | Integer | Global | 0 | 0 - 1024 | インスタンスノードでパラレルクエリに利用可能なスレッドリソースの総数です。0に設定するとパラレルスレッドが利用不可となり、パラレルクエリ機能が無効化されたとみなされます。 |
txsql_parallel_degree | Integer | Global Session | 4 | 0 - 1024 | 単一クエリのパラレルクエリで使用可能な最大スレッド数（デフォルトの並列度）。0に設定するとパラレルクエリ機能が無効化されたとみなされます。 |
設定推奨
並列度仕様制限：txsql_parallel_degreeパラメータの値は単一クエリのパラレルクエリで使用される最大スレッド数（デフォルト並列度）を示します。並列度はインスタンスのCPUコア数の半分を超えないことを推奨します。安定性を確保するため、CPUコア数が4未満の小規模クラスタではパラレルクエリ機能が無効化され、コンソールまたはコマンドラインによる並列クエリ関連パラメータの調整はできません。
SQL文がパラレルクエリを実行する場合、デフォルトでtxsql_parallel_degreeに設定された並列度を使用しますが、ユーザーはhint文を使用して単一SQL文のパラレルクエリ並列度を調整できます。詳細についてはhint文による制御を参照してください。
txsql_max_parallel_worker_threadsパラメータの値は、パラレルクエリでインスタンスが利用可能なスレッド数を示します。txsql_max_parallel_worker_threads／txsql_parallel_degreeの値は、同時にパラレルクエリを実行できるSQL文の最大本数を示します。
txsql_max_parallel_worker_threads と txsql_parallel_degree は共同でパラレルクエリ機能の有効化と無効化を制御します。いずれかのパラメータが0に設定された場合、パラレルクエリ機能が無効化されたことを示します。
TDSQL-C for MySQL は、パラレルクエリの実行条件を設定するための多種のパラメータも提供しています。これにより、お客様はビジネス要件に合わせた個別設定が可能となり、業務の安定稼働を確保できます。設定後、TDSQL-C for MySQL はステートメントの実行コスト、テーブルの行数、単一SQL文が並列プランを実行する際のメモリ使用量などの条件を評価し、各SQL文がパラレルクエリを実行できるかどうかを判定します。関連パラメータの説明は以下の通りです：
パラメータ | 変数タイプ | スコープ | 既定値 | 値の範囲 | 説明 |
txsql_parallel_cost_threshold | Numeric | Global Session | 50000 | 0 - 9223372036854775807 | 並列実行コスト閾値。実行コストがこの閾値より高いステートメントのみがパラレルクエリを実行します。 |
txsql_parallel_table_record_threshold | Integer | Global Session | 5000 | 0 - 9223372036854775807 | 並列表行数閾値。行数がこの閾値を超えるテーブルのみが並列表として選ばれます。 |
txsql_optimizer_context_max_mem_size | Integer | Global | 8388608 | 0 - 9223372036854775807 | 単一SQL文がパラレルクエリ実行環境に割り当て可能な最大メモリ制限です。 |
txsql_parallel_execution_max_lob_size | Integer | Global Session | 65536 | 128 - 9223372036854775807 | 単一オーバーフローフィールドのメモリ制限。 |
注意：
パラレルクエリを含む全てのパラメータはインスタンスの再起動不要で、設定後即時反映されます。
セッションスコープが指定されたパラメータは、単一SQL文に対して設定が可能であることを示します。
コンソールによるパラレルクエリの有効化と無効化
TDSQL-C for MySQLコンソールからクラスタパラメータ設定ページに移動し、関連パラメータを設定することで機能を有効化または無効化できます。
txsql_max_parallel_worker_threads と txsql_parallel_degree を0以外に設定することは、パラレルクエリ機能を有効にすることを意味します。
txsql_max_parallel_worker_threads と txsql_parallel_degree のいずれか一方を0に設定することは、パラレルクエリ機能を無効化することを意味します。
単一のSQL文に対してヒント文で並列実行を指定できます。
TDSQL-C for MySQL は単一の SQL文 に対して特定の並列実行方式を指定することをサポートしています。単一の SQL文 を設定する場合、hint文を使用する方式で操作を行います。詳細な方法については、hint文の制御を参照してください。
付録：新規追加パラメータの説明
パラメータ | 変数タイプ | スコープ | 既定値 | 値の範囲 | 説明 |
txsql_parallel_partition_verbose | Boolean | Global Session | OFF | ON/OFF | EXPLAIN ANALYZE を有効にすると、より詳細なパーティション情報が出力されます。 |
txsql_parallel_limit_enabled | Boolean | Global Session | ON | ON/OFF | 有効にすると、LIMIT で限定された順序付きデータストリーム（追加のソート不要）の並列処理をサポートします。 |
txsql_parallel_rollup_pushdown_threshold | Integer | Global Session | 4 | 0-100 | ROLL UPプッシュダウンアルゴリズムの有効化閾値。GROUP BYフィールド数がこの閾値を超えた場合、並列計算を実行します。 |
txsql_parallel_force_scan_enabled | Boolean | Global Session | OFF | ON/OFF | フルテーブルスキャンまたはフルインデックススキャンクエリの並列化スイッチ。有効時にこれらの2種類のクエリを並列化できます。 |
txsql_parallel_force_range_enabled | Boolean | Global Session | ON | ON/OFF | インデックス範囲スキャン（RANGE/REF）並列化スイッチです。有効時にこれらの2種類のクエリを並列化できます。 |
txsql_parallel_subselect_cost_threshold | Numeric | Global Session | 50000 | 0 - DBL_MAX | 並列実行コスト閾値。推定実行コストが閾値を超えるサブクエリと導出テーブルのみが並列実行できます。 |
txsql_parallel_partition_threshold | Integer | Global Session | 10000 | 0 - ULONG_MAX | Nested Loop Joinの並列処理される内部テーブルのNDV閾値。接続フィールドのユニーク値の数がこの閾値を超えるテーブルのみが並列表として使用できます。 |
txsql_parallel_force_probe_enabled | Boolean | Global Session | OFF | ON/OFF | Hash Joinのプローブテーブル並列化閾値。ハッシュテーブルがjoin buffer sizeを超えた場合、プローブテーブルの並列化を検討します。 |
txsql_parallel_derived_enabled | Boolean | Global Session | ON | ON/OFF | 有効にすると、派生テーブルの個別並列実行をサポートします。 |
関連ドキュメント
フィードバック