版本：3.3

文本可视化 Query Profile

本文介绍了如何通过 MySQL 客户端获取并分析 Query Profile。

使用 ANALYZE PROFILE 分析已有查询

首先，您需要通过 SHOW PROFILELIST 语句来获取查询的概要信息，该命令会列出所有正常结束、异常结束，以及仍在运行（运行 10 秒以上且仍未结束）的查询。通过这个语句，您可以获取到对应的 Query ID，方便进行后续的 Query Profile 分析。语法如下：

SHOW PROFILELIST [LIMIT <num>];

示例如下：

SHOW PROFILELIST;
SHOW PROFILELIST LIMIT 5;

+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+
| QueryId                              | StartTime           | Time  | State    | Statement                                                                                                                         |
+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+
| a40456b2-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:18 | 21ms  | Finished | SELECT ROUTINE_NAME FROM INFORMATION_SCHEMA.ROUTINES\n    WHERE ROUTINE_TYPE="FUNCTION" AND ROUTINE_SCHEMA = "None"               |
| a3fc4060-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:17 | 39ms  | Finished | select TABLE_NAME, COLUMN_NAME from information_schema.columns\n                                    where table_schema = 'Non ... |
| a3f7d38d-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:17 | 15ms  | Finished | select connection_id()                                                                                                            |
| a3efbd3b-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:17 | 16ms  | Finished | select connection_id()                                                                                                            |
| a26ec286-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:15 | 269ms | Error    | EXPLAIN ANALYZE  SELECT c_nation, s_nation, year(lo_orderdate) AS year , SUM(lo_revenue) AS revenue FROM lineorder_flat WHER ...  |
+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+

在取得 Query ID 后，您可以通过 ANALYZE PROFILE 语句对 Query Profile 进行下一步的分析，其语法如下：

ANALYZE PROFILE FROM '<Query_ID>' [, <Node_ID> [, ...] ]

Query_ID：查询对应的 ID。您可以通过 SHOW PROFILELIST 语句获取。
Node_ID：Profile 节点 ID。对于指定了 ID 的节点，StarRocks 会输出该节点的所有指标信息。对于未指定 ID 的节点，StarRocks 仅输出该节点的概要信息。

其输出内容包含如下几个部分：

Summary：Profile 概要信息。
- QueryID
- 版本信息
- 查询状态，包括：Finished、Error 以及 Running。
- 查询总耗时。
- 内存使用情况
- CPU 使用占比最高的 10 个节点。
- 内存使用占比最高的 10 个节点。
- 与默认值不同的 Session Variable。
Fragments：以 Fragment 为单位，依次展示每个 Fragment 中各个节点的指标。
- 每个节点的耗时、内存占用、Cost 估算信息，输出行数等。
- 当节点的耗时占比超过 30%，该节点会用红色加粗标出。
- 当节点的耗时占比超过 15% 且小于 30%，该节点会用粉红色加粗标出。

示例一：查询 Query Profile，不指定节点 ID。

示例二：查询 Query Profile，并指定节点 ID 为 0。StarRocks 会返回 Node ID 为 0 的节点的所有详细指标，并且高亮显示使用占比较高的指标，便于定位问题。

此外，以上方法也支持 Runtime Query Profile 的展示分析。对于开启了 Query Profile 功能，且运行超过 10 秒仍未结束的查询，您可以通过该方法获取 Profile。

相对于已结束的查询，正在运行的查询的文本可视化 Query Profile 包含以下信息：

算子状态：
- ⏳：未启动的算子。这些算子可能由于依赖关系而尚未开始执行。
- 🚀：运行中的算子。
- ✅：已结束执行的算子。
整体进度展示：根据 已结束执行的算子数量/所有算子数量 计算得到。由于没有考虑到行数信息，这个进度可能有点失真。
算子进度展示：根据 已经处理的行数/总行数 计算得到，若无法计算总行数，则该进度显示为 ?。

示例：

使用 EXPLAIN ANALYZE 语句模拟分析查询

StarRocks 提供了 EXPLAIN ANALYZE 语句，方便您对查询直接进行模拟并分析其 Profile，语法如下：

EXPLAIN ANALYZE <sql_statement>

执行 EXPLAIN ANALYZE 时，StarRocks 默认会为当前会话开启 Query Profile 功能。

目前，EXPLAIN ANALYZE 支持两种类型的 SQL 语句：查询（SELECT）语句和 INSERT INTO 语句。您只能在 StarRocks 内表上模拟 INSERT INTO 语句并分析其 Query Profile。请注意，当您模拟并分析 INSERT INTO 语句的 Query Profile 时，实际上不会导入任何数据。默认情况下，导入事务会被中止，以确保在分析过程中不会对数据进行意外更改。

示例一：模拟分析 SELECT 语句，查询返回结果会被丢弃。

示例二：模拟分析 INSERT INTO 语句。完成后，导入事务会被中止，数据不会被实际导入。

限制

EXPLAIN ANALYZE INSERT INTO 语句仅支持内表。
为了获得更好的视觉效果，输出文本中包含了 ANSI 字符，以提供颜色、高亮等功能。推荐使用 MyCLI 客户端。对于不兼容 ANSI 功能的客户端，比如 MySQL 客户端，可能会出现右侧边界未对齐的现象，但并不影响使用。例如：

使用 ANALYZE PROFILE 分析已有查询​

使用 EXPLAIN ANALYZE 语句模拟分析查询​

限制​

使用 ANALYZE PROFILE 分析已有查询

使用 EXPLAIN ANALYZE 语句模拟分析查询

限制