大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:Explain Analyze

· 52CE 我爱测

本文档解释了如何在StarRocks中获取和分析基于文本的Query Profiles。它将帮助您理解查询性能,并找到优化SQL查询的方法。

Explain Analyze

本文档解释了如何在StarRocks中获取和分析基于文本的Query Profiles。它将帮助您理解查询性能,并找到优化SQL查询的方法。

使用ANALYZE PROFILE分析现有查询的Profiles

要分析集群中现有(历史或正在运行)查询的基于文本的Profile,您首先需要使用SHOW PROFILELIST语句获取查询的摘要。此命令列出了所有已成功完成、因错误失败以及仍在运行(超过10秒且尚未完成)的查询。通过此语句,您可以获取用于后续分析的相应Query ID。语法如下:

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 WHERE ...  |
+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+

一旦您获得了Query ID,就可以使用ANALYZE PROFILE语句进行Query Profile分析。语法如下:

ANALYZE PROFILE FROM '<Query_ID>' [, <Node_ID> [, ...] ]
  • Query_ID:通过SHOW PROFILELIST语句获得的查询对应的ID。
  • Node_ID:Profile节点ID。对于指定ID的节点,StarRocks返回这些节点的详细度量信息。对于未指定ID的节点,StarRocks仅返回摘要信息。

Profile包括以下部分:

  • Summary:Profile的摘要信息。
    • QueryID
    • 版本信息
    • 查询状态,包括Finished、Error和Running。
    • 总查询时间。
    • 内存使用情况
    • CPU使用率最高的前10个节点。
    • 内存使用率最高的前10个节点。
    • 与默认值不同的会话变量。
  • Fragments:显示每个Fragment中每个节点的度量。
    • 每个节点的时间、内存使用、成本估算信息和输出行数。
    • 时间使用百分比超过30%的节点以红色突出显示。
    • 时间使用百分比超过15%且小于30%的节点以粉色突出显示。

示例1:查询不指定节点ID的Query Profile。

[图示请参阅官方原文]

示例2:查询指定节点ID为0的Query Profile。StarRocks返回节点ID 0的所有详细度量,并突出显示高使用率的度量以便于问题识别。

[图示请参阅官方原文]

此外,上述方法还支持运行时Query Profile的显示和分析,即为正在运行的查询生成的Profile。当启用Query Profile功能时,您可以使用此方法获取运行超过10秒的查询的Profile。

与已完成查询的相比,正在运行查询的基于文本的Query Profile包含以下信息:

  • Operator状态:

    • ⏳:尚未启动的Operators。这些Operators可能由于依赖关系尚未开始执行。
    • 🚀:正在运行的Operators。
    • ✅:已完成执行的Operators。
  • 总体进度:基于已完成执行的Operators数量/总Operators数量计算。由于缺乏数据行的详细信息,此值可能略有失真。

  • Operator进度:基于已处理行数/总行数计算。如果无法计算总行数,进度显示为?。

示例:

[图示请参阅官方原文]

使用EXPLAIN ANALYZE模拟查询进行Profile分析

StarRocks提供了EXPLAIN ANALYZE语句,允许您直接模拟和分析查询的Profile。语法如下:

EXPLAIN ANALYZE <sql_statement>

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

目前,EXPLAIN ANALYZE支持两种类型的SQL语句:SELECT语句和INSERT INTO语句。您只能在StarRocks的default catalog中的内部表上模拟和分析INSERT INTO语句的Query Profile。请注意,在模拟和分析INSERT INTO语句的Query Profile时,不会实际加载数据。默认情况下,导入事务将被中止,以确保在分析过程中不会对数据进行意外更改。

示例1:模拟和分析SELECT语句。查询结果将被丢弃。

[图示请参阅官方原文]

示例2:模拟和分析INSERT INTO语句。加载事务将被中止。

[图示请参阅官方原文]

限制

  • EXPLAIN ANALYZE INSERT INTO语句仅支持default catalog中的表。
  • 为了获得更好的视觉效果,输出文本包含ANSI字符以提供颜色、高亮和其他功能。建议使用MyCLI客户端。对于不支持ANSI功能的客户端,如MySQL客户端,可能会有一些轻微的显示错乱。通常,它们不会影响使用。例如:

[图示请参阅官方原文]

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。