オプティマイザー修正コントロール
製品が継続的に進化するにつれて、TiDBオプティマイザーの動作が変化し、より合理的な実行プランが生成されるようになります。しかし、特定のシナリオでは、新しい動作が予期しない結果につながる可能性があります。例えば、
- 一部の動作の効果は特定のシナリオに依存します。ほとんどのシナリオで改善をもたらす変更が、他のシナリオでは後退を引き起こす可能性があります。
- 場合によっては、行動の詳細の変化とその結果の関係が非常に複雑になることがあります。特定の行動の改善が、全体的な退行を引き起こす可能性があります。
そのため、TiDBは、複数の修正値を設定することでTiDBオプティマイザの動作をきめ細かく制御できるオプティマイザ修正制御機能を提供しています。このドキュメントでは、オプティマイザ修正制御機能とその使用方法について説明し、TiDBが現在オプティマイザ修正制御でサポートしているすべての修正値を一覧表示します。
tidb_opt_fix_control
の紹介
v6.5.3 および v7.1.0 以降、TiDB は、オプティマイザーの動作をより細かく制御するためのtidb_opt_fix_control
システム変数を提供します。
各修正は、特定の目的のためにTiDBオプティマイザーの動作を調整するための制御項目です。修正には、動作変更の技術的な詳細を含むGitHub Issueに対応する番号が付けられています。例えば、修正44262
場合、その制御内容は問題44262で確認できます。
システム変数tidb_opt_fix_control
、複数の修正をカンマ区切りで 1 つの値として指定します ( ,
)。形式は"<#issue1>:<value1>,<#issue2>:<value2>,...,<#issueN>:<valueN>"
で、 <#issueN>
修正番号です。例:
SET SESSION tidb_opt_fix_control = '44262:ON,44389:ON';
オプティマイザー修正コントロールリファレンス
33031
バージョン8.0.0の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
- この変数は、パーティションテーブルのプランキャッシュを許可するかどうかを制御します
ON
に設定されている場合、 パーティションテーブルでは準備されたステートメントプランキャッシュと非プリペアドステートメントプランキャッシュどちらも有効になりません。
44262
v6.5.3 および v7.2.0 の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
- この変数は、 グローバルスタッツが欠落している場合に、 動的プルーニングモード使用してパーティションテーブルにアクセスできるようにするかどうかを制御します。
44389
バージョン6.5.3およびバージョン7.2.0の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
c = 10 and (a = 'xx' or (a = 'kk' and b = 1))
などのフィルターの場合、この変数はIndexRangeScan
より包括的なスキャン範囲を構築するかどうかを制御します。
44823
バージョン7.3.0の新機能
- デフォルト値:
200
- 可能な値:
[0, 2147483647]
- メモリを節約するために、プラン キャッシュでは、この変数で指定された数を超えるパラメータを持つクエリはキャッシュされません。
0
制限がないことを意味します。
44830
v6.5.7 および v7.3.0 の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
- この変数は、物理的な最適化中に生成された
PointGet
演算子を使用して実行プランをプラン キャッシュがキャッシュできるかどうかを制御します。
44855
バージョン6.5.4およびバージョン7.3.0の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
- 一部のシナリオでは、
IndexJoin
演算子のProbe
側にSelection
演算子が含まれている場合、TiDB は行数をIndexScan
と過大評価します。その結果、IndexJoin
ではなく、最適ではないクエリプランが選択される場合があります。 - この問題を軽減するために、TiDB では改善が導入されました。ただし、クエリプランのフォールバックリスクが発生する可能性があるため、この改善はデフォルトで無効になっています。
- この変数は、前述の改善を有効にするかどうかを制御します。
45132
バージョン7.4.0の新機能
- デフォルト値:
1000
- 可能な値:
[0, 2147483647]
- この変数は、オプティマイザがアクセスパスを選択する際のヒューリスティック戦略の閾値を設定します。あるアクセスパスの推定行数(例えば
Index_A
)が他のアクセスパスの推定行数(デフォルトは1000
倍)よりも大幅に少ない場合、オプティマイザはコスト比較をスキップし、直接Index_A
選択します。 0
、このヒューリスティック戦略を無効にすることを意味します。
45798
バージョン7.5.0の新機能
- デフォルト値:
ON
- 可能
OFF
値:ON
- この変数は、プラン キャッシュが生成された列アクセスする実行プランをキャッシュできるかどうかを制御します。
46177
v6.5.6、v7.1.3、v7.5.0 の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
- この変数は、強制されていないプランを見つけた後、クエリの最適化中にオプティマイザーが強制されているプランを探索するかどうかを制御します。
52869
バージョン8.1.0の新機能
- デフォルト値:
OFF
- 可能
OFF
値:ON
- インデックスマージを使用したステートメントの説明の注に記載されているように、オプティマイザがクエリ プランに対して単一インデックス スキャン方式 (フル テーブル スキャン以外) を選択できる場合、オプティマイザはインデックス マージを自動的に使用しません。
- この制限は、この修正制御を有効にすることで解除できます。この制限を解除すると、オプティマイザはより多くのクエリでインデックスマージを自動的に選択できるようになりますが、最適な実行プランを無視してしまう可能性があります。したがって、この制限を解除する前に、実際のユースケースで十分なテストを実施し、パフォーマンスの低下が発生しないことを確認することをお勧めします。
56318
注記:
これはTiDB Cloud Serverlessのみ利用可能です。
- デフォルト値:
ON
- 可能
OFF
値:ON
- この変数は
ORDER BY
ステートメントで使用される重い式を 2 回計算することを回避するかどうかを制御します。