SQL の未準備実行プラン キャッシュ
TiDB は、 ステートメントのPrepare / Executeと同様、一部の非PREPAREステートメントの実行プラン キャッシュをサポートします。この機能により、これらのステートメントは最適化フェーズをスキップし、パフォーマンスを向上させることができます。
原理
準備されていないプラン キャッシュは、 準備されたプランのキャッシュとキャッシュを共有するセッション レベルの機能です。準備されていないプラン キャッシュの基本原理は次のとおりです。
- 未準備プラン キャッシュを有効にすると、TiDB はまず抽象構文ツリー (AST) に基づいてクエリをパラメータ化します。たとえば、
SELECT * FROM t WHERE b < 10 AND a = 1はSELECT * FROM t WHERE b < ? and a = ?としてパラメータ化されます。 - 次に、TiDB はパラメーター化されたクエリを使用してプラン キャッシュを検索します。
- 再利用可能なプランが見つかった場合は、それが直接使用され、最適化フェーズはスキップされます。
- それ以外の場合、オプティマイザは新しいプランを生成し、後続のクエリで再利用できるようにそれをキャッシュに再度追加します。
使用法
準備されていないプラン キャッシュを有効または無効にするには、 tidb_enable_non_prepared_plan_cacheシステム変数を設定します。 tidb_session_plan_cache_sizeシステム変数を使用して、準備されていないプラン キャッシュのサイズを制御することもできます。キャッシュされたプランの数がtidb_session_plan_cache_sizeを超えると、TiDB は最も最近使用されていない (LRU) 戦略を使用してプランを削除します。
v7.1.0 以降、システム変数tidb_plan_cache_max_plan_sizeを使用してキャッシュできるプランの最大サイズを制御できます。デフォルト値は 2 MB です。プランのサイズがこの値を超える場合、プランはキャッシュされません。
注記：
tidb_session_plan_cache_sizeで指定されたメモリは、準備済みプラン キャッシュと準備されていないプラン キャッシュ間で共有されます。現在のクラスターで準備済みプラン キャッシュを有効にしている場合、準備されていないプラン キャッシュを有効にすると、元の準備済みプラン キャッシュのヒット率が低下する可能性があります。
例
次の例は、準備されていないプラン キャッシュの使用方法を示しています。
テスト用にテーブル
tを作成します。CREATE TABLE t (a INT, b INT, KEY(b));準備されていないプラン キャッシュを有効にします。
SET tidb_enable_non_prepared_plan_cache = ON;次の 2 つのクエリを実行します。
SELECT * FROM t WHERE b < 10 AND a = 1; SELECT * FROM t WHERE b < 5 AND a = 2;2 番目のクエリがキャッシュにヒットするかどうかを確認します。
SELECT @@last_plan_from_cache;出力の
last_plan_from_cacheの値が1の場合、2 番目のクエリの実行プランがキャッシュから取得されたことを意味します。+------------------------+ | @@last_plan_from_cache | +------------------------+ | 1 | +------------------------+ 1 row in set (0.00 sec)
制限
次善のプランをキャッシュする
TiDB は、パラメーター化されたクエリに対して 1 つのプランのみをキャッシュします。たとえば、クエリSELECT * FROM t WHERE a < 1とSELECT * FROM t WHERE a < 100000は同じパラメータ化された形式SELECT * FROM t WHERE a < ?を共有するため、同じプランを共有します。
これによりパフォーマンスの問題が発生する場合は、 ignore_plan_cache()ヒントを使用してキャッシュ内のプランを無視し、オプティマイザーが毎回 SQL の新しい実行プランを生成するようにすることができます。 SQL を変更できない場合は、バインディングを作成して問題を解決できます。たとえば、 CREATE BINDING FOR SELECT ... USING SELECT /*+ ignore_plan_cache() */ ... 。
使用制限
前述のリスクと、実行プラン キャッシュは単純なクエリに対してのみ大きな利点を提供するという事実 (クエリが複雑で実行に時間がかかる場合、実行プラン キャッシュの使用はあまり役に立たない可能性があります) により、TiDB には厳しい制限があります。準備されていないプラン キャッシュの範囲について。制限事項は次のとおりです。
- 準備されたプランのキャッシュでサポートされていないクエリまたはプランは、準備されていないプラン キャッシュでもサポートされません。
WindowやHavingなどの複雑な演算子を含むクエリはサポートされていません。- 3 つ以上の
Joinテーブルまたはサブクエリを含むクエリはサポートされていません。 ORDER BY 1やGROUP BY a+1など、ORDER BYまたはGROUP BY直後に数値または式を含むクエリはサポートされていません。ORDER BY column_nameとGROUP BY column_nameのみがサポートされます。JSON、ENUM、SET、またはBITタイプの列でフィルター処理するクエリ (SELECT * FROM t WHERE json_col = '{}'など) はサポートされていません。SELECT * FROM t WHERE a is NULLなど、NULLの値でフィルタリングするクエリはサポートされていません。- パラメータ化後のパラメータが 200 を超えるクエリ (
SELECT * FROM t WHERE a in (1, 2, 3, ... 201)など) は、デフォルトではサポートされていません。 v7.1.1 以降、tidb_opt_fix_controlシステム変数を使用してこの制限を変更できます。 - パーティション化されたテーブル、仮想列、一時テーブル、ビュー、またはメモリテーブルにアクセスするクエリ (
SELECT * FROM INFORMATION_SCHEMA.COLUMNSなど) はサポートされていません。ここで、COLUMNSは TiDBメモリテーブルです。 - ヒントまたはバインディングを含むクエリはサポートされていません。
- DML ステートメントまたは
FOR UPDATE句を含むSELECTステートメントは、デフォルトではサポートされていません。この制限を解除するには、SET tidb_enable_non_prepared_plan_cache_for_dml = ONを実行します。
この機能を有効にすると、オプティマイザーはクエリを迅速に評価します。準備されていないプラン キャッシュのサポート条件を満たさない場合、クエリは通常の最適化プロセスに戻ります。
パフォーマンス上の利点
内部テストでは、準備されていないプラン キャッシュ機能を有効にすると、ほとんどの TP シナリオでパフォーマンスが大幅に向上します。ただし、クエリがサポートされているかどうかの判断やクエリのパラメータ化など、追加のパフォーマンス オーバーヘッドも発生します。この機能がワークロード内のクエリの大部分をサポートできない場合、この機能を有効にすると実際にパフォーマンスに悪影響を及ぼす可能性があります。
この場合、Grafana の[プラン キャッシュ OPS を使用したクエリ]パネルのnon-preparedメトリックと、 [プラン キャッシュ ミス OPS]パネルのnon-prepared-unsupportedメトリックを観察する必要があります。ほとんどのクエリがサポートされておらず、プラン キャッシュにヒットできるクエリが少数しかない場合は、この機能を無効にすることができます。
診断
準備されていないプラン キャッシュを有効にした後、 EXPLAIN FORMAT='plan_cache' SELECT ...ステートメントを実行して、クエリがキャッシュにヒットできるかどうかを確認できます。キャッシュにヒットできないクエリの場合、システムは警告としてその理由を返します。
FORMAT='plan_cache'を追加しない場合、 EXPLAINステートメントはキャッシュにヒットしないことに注意してください。
クエリがキャッシュにヒットするかどうかを確認するには、次のEXPLAIN FORMAT='plan_cache'ステートメントを実行します。
EXPLAIN FORMAT='plan_cache' SELECT * FROM (SELECT a+1 FROM t) t;
出力は次のとおりです。
3 rows in set, 1 warning (0.00 sec)
キャッシュにヒットできないクエリを表示するには、 SHOW warnings;を実行します。
SHOW warnings;
出力は次のとおりです。
+---------+------+-------------------------------------------------------------------------------+
| Level | Code | Message |
+---------+------+-------------------------------------------------------------------------------+
| Warning | 1105 | skip non-prepared plan-cache: queries that have sub-queries are not supported |
+---------+------+-------------------------------------------------------------------------------+
1 row in set (0.00 sec)
前の例では、準備されていないプラン キャッシュが+操作をサポートしていないため、クエリはキャッシュにヒットできません。
監視
未準備プラン キャッシュを有効にすると、次のペインでメモリ使用量、キャッシュ内のプラン数、キャッシュ ヒット率を監視できます。
statements_summaryテーブルのキャッシュ ヒット率やスロー クエリ ログも監視できます。以下に、 statements_summaryの表でキャッシュ ヒット率を表示する方法を示します。
テーブル
tを作成します。CREATE TABLE t (a int);準備されていないプラン キャッシュを有効にします。
SET @@tidb_enable_non_prepared_plan_cache=ON;次の 3 つのクエリを実行します。
SELECT * FROM t WHERE a<1; SELECT * FROM t WHERE a<2; SELECT * FROM t WHERE a<3;statements_summaryテーブルをクエリして、キャッシュ ヒット率を表示します。SELECT digest_text, query_sample_text, exec_count, plan_in_cache, plan_cache_hits FROM INFORMATION_SCHEMA.STATEMENTS_SUMMARY WHERE query_sample_text LIKE '%SELECT * FROM %';出力は次のとおりです。
+---------------------------------+------------------------------------------+------------+---------------+-----------------+ | digest_text | query_sample_text | exec_count | plan_in_cache | plan_cache_hits | +---------------------------------+------------------------------------------+------------+---------------+-----------------+ | SELECT * FROM `t` WHERE `a` < ? | SELECT * FROM t WHERE a<1 | 3 | 1 | 2 | +---------------------------------+------------------------------------------+------------+---------------+-----------------+ 1 row in set (0.01 sec)出力から、クエリが 3 回実行され、キャッシュに 2 回ヒットしたことがわかります。