EXPLAIN 和 PROFILE¶
EXPLAIN
语句输出 nGQL 语句的执行计划,但不会执行 nGQL 语句。
PROFILE
语句执行 nGQL 语句,然后输出执行计划和执行概要。用户可以根据执行计划和执行概要优化查询性能。
执行计划¶
执行计划由 NebulaGraph 查询引擎中的执行计划器决定。
执行计划器将解析后的 nGQL 语句处理为action
。action
是最小的执行单元。典型的action
包括获取指定点的所有邻居、获取边的属性、根据条件过滤点或边等。每个action
都被分配给一个operator
。
例如SHOW TAGS
语句分为两个action
,operator
为Start
和ShowTags
。更复杂的GO
语句可能会被处理成 10 个以上的action
。
语法¶
EXPLAIN
EXPLAIN [format= {"row" | "dot"}] <your_nGQL_statement>;
PROFILE
PROFILE [format= {"row" | "dot"}] <your_nGQL_statement>;
输出格式¶
EXPLAIN
或PROFILE
语句的输出有两种格式:row
(默认)和dot
。用户可以使用format
选项修改输出格式。
row
格式¶
row
格式将返回信息输出到一个表格中。
EXPLAIN
nebula> EXPLAIN format="row" SHOW TAGS; Execution succeeded (time spent 327/892 us) Execution Plan -----+----------+--------------+----------------+---------------------------------------------------------------------- | id | name | dependencies | profiling data | operator info | -----+----------+--------------+----------------+---------------------------------------------------------------------- | 1 | ShowTags | 0 | | outputVar: [{"colNames":[],"name":"__ShowTags_1","type":"DATASET"}] | | | | | | inputVar: | -----+----------+--------------+----------------+---------------------------------------------------------------------- | 0 | Start | | | outputVar: [{"colNames":[],"name":"__Start_0","type":"DATASET"}] | -----+----------+--------------+----------------+----------------------------------------------------------------------
PROFILE
nebula> PROFILE format="row" SHOW TAGS; +--------+ | Name | +--------+ | player | | team | +--------+ Got 2 rows (time spent 2038/2728 us) Execution Plan -----+----------+--------------+----------------------------------------------------+---------------------------------------------------------------------- | id | name | dependencies | profiling data | operator info | -----+----------+--------------+----------------------------------------------------+---------------------------------------------------------------------- | 1 | ShowTags | 0 | ver: 0, rows: 1, execTime: 42us, totalTime: 1177us | outputVar: [{"colNames":[],"name":"__ShowTags_1","type":"DATASET"}] | | | | | | inputVar: | -----+----------+--------------+----------------------------------------------------+---------------------------------------------------------------------- | 0 | Start | | ver: 0, rows: 0, execTime: 1us, totalTime: 57us | outputVar: [{"colNames":[],"name":"__Start_0","type":"DATASET"}] | -----+----------+--------------+----------------------------------------------------+----------------------------------------------------------------------
参数 | 说明 |
---|---|
id |
operator 的 ID。 |
name |
operator 的名称。 |
dependencies |
当前operator 所依赖的operator 的 ID。 |
profiling data |
执行概要文件内容。 ver 表示operator 的版本;rows 表示operator 输出结果的行数;execTime 表示执行action 的时间;totalTime 表示执行action 的时间、系统调度时间、排队时间的总和。 |
operator info |
operator 的详细信息。 |
dot
格式¶
dot
格式将返回 DOT 语言的信息,然后用户可以使用 Graphviz 生成计划图。
Note
Graphviz 是一款开源可视化图工具,可以绘制 DOT 语言脚本描述的图。Graphviz 提供一个在线工具,可以预览 DOT 语言文件,并将它们导出为 SVG 或 JSON 等其他格式。详情请参见 Graphviz Online。
nebula> EXPLAIN format="dot" SHOW TAGS;
Execution succeeded (time spent 161/665 us)
Execution Plan
--------------------------------------------------------------------------------------------------------------------------------------------- -------------
plan
--------------------------------------------------------------------------------------------------------------------------------------------- -------------
digraph exec_plan {
rankdir=LR;
"ShowTags_0"[label="ShowTags_0|outputVar: \[\{\"colNames\":\[\],\"name\":\"__ShowTags_0\",\"type\":\"DATASET\"\}\]\l|inputVar:\l", shape=Mrecord];
"Start_2"->"ShowTags_0";
"Start_2"[label="Start_2|outputVar: \[\{\"colNames\":\[\],\"name\":\"__Start_2\",\"type\":\"DATASET\"\}\]\l|inputVar: \l", shape=Mrecord];
}
--------------------------------------------------------------------------------------------------------------------------------------------- -------------
将上述示例的 DOT 语言转换为 Graphviz 图,如下所示。
最后更新:
September 4, 2023