EXPLAIN
EXPLAIN
ステートメントは、クエリを実行せずにクエリの実行プランを示します。クエリを実行するEXPLAIN ANALYZE
によって補完されます。 EXPLAIN
の出力が期待される結果と一致しない場合は、クエリ内の各テーブルでANALYZE TABLE
を実行することを検討してください。
ステートメントDESC
とDESCRIBE
は、このステートメントの別名です。 EXPLAIN <tableName>
の代替使用法はSHOW [FULL] COLUMNS FROM
の下に文書化されています。
TiDB はEXPLAIN [options] FOR CONNECTION connection_id
ステートメントをサポートしています。ただし、このステートメントは MySQL のEXPLAIN FOR
ステートメントとは異なります。詳細については、 EXPLAIN FOR CONNECTION
を参照してください。
あらすじ
- ExplainSym
- ExplainStmt
- ExplainableStmt
ExplainSym ::=
'EXPLAIN'
| 'DESCRIBE'
| 'DESC'
ExplainStmt ::=
ExplainSym ( TableName ColumnName? | 'ANALYZE'? ExplainableStmt | 'FOR' 'CONNECTION' NUM | 'FORMAT' '=' ( stringLit | ExplainFormatType ) ( 'FOR' 'CONNECTION' NUM | ExplainableStmt ) )
ExplainableStmt ::=
SelectStmt
| DeleteFromStmt
| UpdateStmt
| InsertIntoStmt
| ReplaceIntoStmt
| UnionStmt
EXPLAIN
出力フォーマット
ノート:
MySQL クライアントを使用して TiDB に接続する場合、出力結果を改行なしでより明確に読み取るには、
pager less -S
コマンドを使用できます。次に、EXPLAIN
の結果が出力されたら、キーボードの右矢印→ボタンを押して、出力を水平方向にスクロールできます。
ノート:
返される実行計画では、
IndexJoin
およびApply
演算子のすべてのプローブ側の子ノードについて、v6.4.0 以降のestRows
の意味は v6.4.0 より前のものとは異なります。詳細はTiDB クエリ実行計画の概要を参照してください。
現在、TiDB のEXPLAIN
はid
、 estRows
、 task
、 access object
、 operator info
の 5 つの列を出力します。実行計画の各演算子はこれらの属性によって記述され、 EXPLAIN
の出力の各行は演算子を記述します。各属性の説明は次のとおりです。
属性名 | 説明 |
---|---|
ID | オペレーター ID は、実行計画全体におけるオペレーターの固有 ID です。 TiDB 2.1 では、ID はオペレーターのツリー構造を表示するようにフォーマットされます。子ノードから親ノードにデータが流れます。オペレーターごとに 1 つだけの親ノード。 |
estRows | オペレーターが出力すると予想される行数。この数は、統計とオペレーターのロジックに従って推定されます。 estRows は、以前のバージョンの TiDB 4.0 ではcount と呼ばれていました。 |
タスク | オペレーターが属するタスクのタイプ。現在、実行計画は 2 つのタスクに分割されています。ルートタスクは tidb-server で実行され、 copタスクは TiKV またはTiFlashで並行して実行されます。タスク レベルでの実行計画のトポロジは、ルート タスクの後に多数の警官タスクが続くというものです。 root タスクは、cop タスクの出力を入力として使用します。 cop タスクは、TiDB が TiKV またはTiFlashにプッシュするタスクを指します。各警官タスクは TiKV クラスターまたはTiFlashクラスターに分散され、複数のプロセスによって実行されます。 |
アクセス オブジェクト | オペレーターがアクセスしたデータ項目情報。この情報には、 table 、 partition 、およびindex (存在する場合) が含まれます。データに直接アクセスするオペレーターだけがそのような情報を持っています。 |
オペレーター情報 | オペレーターに関するその他の情報。各オペレーターのoperator info は異なります。以下の例を参照できます。 |
例
EXPLAIN SELECT 1;
+-------------------+---------+------+---------------+---------------+
| id | estRows | task | access object | operator info |
+-------------------+---------+------+---------------+---------------+
| Projection_3 | 1.00 | root | | 1->Column#1 |
| └─TableDual_4 | 1.00 | root | | rows:1 |
+-------------------+---------+------+---------------+---------------+
2 rows in set (0.00 sec)
CREATE TABLE t1 (id INT NOT NULL PRIMARY KEY AUTO_INCREMENT, c1 INT NOT NULL);
Query OK, 0 rows affected (0.10 sec)
INSERT INTO t1 (c1) VALUES (1), (2), (3);
Query OK, 3 rows affected (0.02 sec)
Records: 3 Duplicates: 0 Warnings: 0
EXPLAIN SELECT * FROM t1 WHERE id = 1;
+-------------+---------+------+---------------+---------------+
| id | estRows | task | access object | operator info |
+-------------+---------+------+---------------+---------------+
| Point_Get_1 | 1.00 | root | table:t1 | handle:1 |
+-------------+---------+------+---------------+---------------+
1 row in set (0.00 sec)
DESC SELECT * FROM t1 WHERE id = 1;
+-------------+---------+------+---------------+---------------+
| id | estRows | task | access object | operator info |
+-------------+---------+------+---------------+---------------+
| Point_Get_1 | 1.00 | root | table:t1 | handle:1 |
+-------------+---------+------+---------------+---------------+
1 row in set (0.00 sec)
DESCRIBE SELECT * FROM t1 WHERE id = 1;
+-------------+---------+------+---------------+---------------+
| id | estRows | task | access object | operator info |
+-------------+---------+------+---------------+---------------+
| Point_Get_1 | 1.00 | root | table:t1 | handle:1 |
+-------------+---------+------+---------------+---------------+
1 row in set (0.00 sec)
EXPLAIN INSERT INTO t1 (c1) VALUES (4);
+----------+---------+------+---------------+---------------+
| id | estRows | task | access object | operator info |
+----------+---------+------+---------------+---------------+
| Insert_1 | N/A | root | | N/A |
+----------+---------+------+---------------+---------------+
1 row in set (0.00 sec)
EXPLAIN UPDATE t1 SET c1=5 WHERE c1=3;
+---------------------------+---------+-----------+---------------+--------------------------------+
| id | estRows | task | access object | operator info |
+---------------------------+---------+-----------+---------------+--------------------------------+
| Update_4 | N/A | root | | N/A |
| └─TableReader_8 | 0.00 | root | | data:Selection_7 |
| └─Selection_7 | 0.00 | cop[tikv] | | eq(test.t1.c1, 3) |
| └─TableFullScan_6 | 3.00 | cop[tikv] | table:t1 | keep order:false, stats:pseudo |
+---------------------------+---------+-----------+---------------+--------------------------------+
4 rows in set (0.00 sec)
EXPLAIN DELETE FROM t1 WHERE c1=3;
+---------------------------+---------+-----------+---------------+--------------------------------+
| id | estRows | task | access object | operator info |
+---------------------------+---------+-----------+---------------+--------------------------------+
| Delete_4 | N/A | root | | N/A |
| └─TableReader_8 | 0.00 | root | | data:Selection_7 |
| └─Selection_7 | 0.00 | cop[tikv] | | eq(test.t1.c1, 3) |
| └─TableFullScan_6 | 3.00 | cop[tikv] | table:t1 | keep order:false, stats:pseudo |
+---------------------------+---------+-----------+---------------+--------------------------------+
4 rows in set (0.01 sec)
EXPLAIN
出力の形式を指定するには、 FORMAT = xxx
構文を使用できます。現在、TiDB は次の形式をサポートしています。
フォーマット | 説明 |
---|---|
指定されていない | フォーマットが指定されていない場合、 EXPLAIN デフォルトのフォーマットrow を使用します。 |
row | EXPLAIN ステートメントは結果を表形式で出力します。詳細については、 クエリ実行計画を理解する参照してください。 |
brief | EXPLAIN ステートメントの出力のオペレーター ID は、 FORMAT 指定されていない場合に比べて単純化されています。 |
dot | EXPLAIN ステートメントは DOT 実行プランを出力します。これは、 dot プログラム ( graphviz パッケージ内) を介して PNG ファイルを生成するために使用できます。 |
tidb_json | EXPLAIN ステートメントは、実行計画を JSON で出力し、オペレーター情報を JSON 配列に格納します。 |
- brief
- DotGraph
- JSON
以下は、 FORMAT
が"brief"
in EXPLAIN
の場合の例です。
EXPLAIN FORMAT = "brief" DELETE FROM t1 WHERE c1 = 3;
+-------------------------+---------+-----------+---------------+--------------------------------+
| id | estRows | task | access object | operator info |
+-------------------------+---------+-----------+---------------+--------------------------------+
| Delete | N/A | root | | N/A |
| └─TableReader | 0.00 | root | | data:Selection |
| └─Selection | 0.00 | cop[tikv] | | eq(test.t1.c1, 3) |
| └─TableFullScan | 3.00 | cop[tikv] | table:t1 | keep order:false, stats:pseudo |
+-------------------------+---------+-----------+---------------+--------------------------------+
4 rows in set (0.001 sec)
MySQL 標準の結果形式に加えて、TiDB は DotGraph もサポートしており、次の例のようにFORMAT = "dot"
を指定する必要があります。
CREATE TABLE t(a bigint, b bigint);
EXPLAIN format = "dot" SELECT A.a, B.b FROM t A JOIN t B ON A.a > B.b WHERE A.a < 10;
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| dot contents |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
digraph Projection_8 {
subgraph cluster8{
node [style=filled, color=lightgrey]
color=black
label = "root"
"Projection_8" -> "HashJoin_9"
"HashJoin_9" -> "TableReader_13"
"HashJoin_9" -> "Selection_14"
"Selection_14" -> "TableReader_17"
}
subgraph cluster12{
node [style=filled, color=lightgrey]
color=black
label = "cop"
"Selection_12" -> "TableFullScan_11"
}
subgraph cluster16{
node [style=filled, color=lightgrey]
color=black
label = "cop"
"Selection_16" -> "TableFullScan_15"
}
"TableReader_13" -> "Selection_12"
"TableReader_17" -> "Selection_16"
}
|
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)
コンピュータにdot
プログラムがある場合、次の方法を使用して PNG ファイルを生成できます。
dot xx.dot -T png -O
The xx.dot is the result returned by the above statement.
コンピューターにdot
プログラムがない場合は、結果をこのウェブサイトにコピーしてツリー図を取得します。
JSON で出力を取得するには、 EXPLAIN
ステートメントでFORMAT = "tidb_json"
を指定します。次に例を示します。
CREATE TABLE t(id int primary key, a int, b int, key(a));
EXPLAIN FORMAT = "tidb_json" SELECT id FROM t WHERE a = 1;
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| TiDB_JSON |
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| [
{
"id": "Projection_4",
"estRows": "10.00",
"taskType": "root",
"operatorInfo": "test.t.id",
"subOperators": [
{
"id": "IndexReader_6",
"estRows": "10.00",
"taskType": "root",
"operatorInfo": "index:IndexRangeScan_5",
"subOperators": [
{
"id": "IndexRangeScan_5",
"estRows": "10.00",
"taskType": "cop[tikv]",
"accessObject": "table:t, index:a(a)",
"operatorInfo": "range:[1,1], keep order:false, stats:pseudo"
}
]
}
]
}
]
|
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.01 sec)
出力では、 id
、 estRows
、 taskType
、 accessObject
、およびoperatorInfo
は、デフォルト形式の列と同じ意味を持ちます。 subOperators
サブノードを格納する配列である。サブノードのフィールドと意味は、親ノードと同じです。フィールドが欠落している場合、それはフィールドが空であることを意味します。
MySQL の互換性
EXPLAIN
の形式と TiDB での潜在的な実行計画の両方が、MySQL とはかなり異なります。- TiDB は
FORMAT=JSON
またはFORMAT=TREE
オプションをサポートしていません。 - TiDB の
FORMAT=tidb_json
は、デフォルトのEXPLAIN
結果の JSON 形式の出力です。形式とフィールドは、MySQL のFORMAT=JSON
の出力とは異なります。
EXPLAIN FOR CONNECTION
EXPLAIN FOR CONNECTION
、接続で現在実行されている SQL クエリまたは最後に実行された SQL クエリの実行計画を取得するために使用されます。出力形式はEXPLAIN
と同じです。ただし、TiDB でのEXPLAIN FOR CONNECTION
の実装は、MySQL での実装とは異なります。それらの違い (出力形式を除く) は次のとおりです。
- 接続がスリープ状態の場合、MySQL は空の結果を返しますが、TiDB は最後に実行されたクエリ プランを返します。
- 現在のセッションの実行計画を取得しようとすると、MySQL はエラーを返しますが、TiDB は正常に結果を返します。
- MySQL では、ログイン ユーザーがクエリ対象の接続と同じである必要があります。そうでない場合、ログイン ユーザーは
PROCESS
権限を持っています。一方、TiDB では、ログイン ユーザーがクエリ対象の接続と同じである必要があります。そうでない場合、ログイン ユーザーはSUPER
権限を持っています。