Query Profiling Statistics

开启查询执行信息收集功能

默认情况下，查询执行信息收集功能处于关闭状态，您可以通过queryprofile.enable参数开启或关闭该功能。

• 查看当前查询执行信息收集状态：

  SHOW queryprofile.enable;

• 会话级别开启查询执行信息收集功能：

  SET queryprofile.enable = ON;

• 会话级别关闭查询执行信息收集功能：

  SET queryprofile.enable = OFF;

• 开启当前库的查询执行信息收集功能：

  ALTER DATABASE <dbname> SET queryprofile.enable = ON;

如果需要实例级别开启或关闭Query Profiling Statistics功能，请提交工单联系技术支持进行修改。

查看查询执行信息

开启查询执行信息收集功能后，您可以通过查询执行信息提供的系统视图查看运行中或历史的查询和执行过程。

查询执行信息视图

• queryprofile.query_exec_history：用于查看历史查询的信息。
• queryprofile.query_exec_status：用于查看正在运行的查询的信息。
• queryprofile.node_exec_history：用于查看历史查询执行过程信息。
• queryprofile.node_exec_status：用于查看正在运行的查询执行过程信息。

queryprofile.query_exec_history和queryprofile.query_exec_status视图结构一致，视图中字段说明如下：

queryprofile.node_exec_history和queryprofile.node_exec_status视图结构一致，视图中字段说明如下：

queryprofile.node_exec_history和queryprofile.node_exec_status视图中每一个查询算子对应一行数据，其中记录了查询执行过程中在该算子阶段的基本执行信息和消耗的资源，您可以根据视图中的信息定位到执行异常的阶段，优化查询执行过程。

查看正在运行的查询执行信息

示例1

查看正在运行的查询，SQL如下：

SELECT * FROM queryprofile.query_exec_status;

示例2

查看正在运行的查询执行过程，SQL如下：

SELECT * FROM queryprofile.node_exec_status;

查看历史的查询执行信息

示例1

查看历史查询，SQL如下：

SELECT * FROM queryprofile.query_exec_history;

示例2

查看历史查询执行过程，SQL如下：

SELECT * FROM queryprofile.node_exec_history;

修改运行中查询执行信息视图的更新频率

AnalyticDB PostgreSQL版提供了queryprofile.refresh_interval参数，用于控制queryprofile.query_exec_status和queryprofile.node_exec_status视图的更新频率，该参数值表示执行过程中执行算子每次更新统计数据所间隔的处理数据行数。

queryprofile.refresh_interval参数的默认值为1000，表示算子每读入1000行数据更新一次统计数据；0表示关闭动态收集查询执行信息功能。

您可以通过如下SQL查看查询执行信息更新频率：

SHOW queryprofile.refresh_interval;

返回示例如下：

 queryprofile.refresh_interval
-------------------------------
 1000
(1 row)

历史查询执行信息回收

AnalyticDB PostgreSQL版提供了queryprofile.max_query_num和queryprofile.query_time_limit两个参数用于控制历史查询信息回收：

• queryprofile.max_query_num：用于控制保留的最大记录数。该参数值默认为10000，即保存最近10000条历史查询信息。您可以通过如下SQL查看保留的最大记录数：

  SHOW queryprofile.max_query_num;

• queryprofile.query_time_limit：用于清除记录中的短查询，总执行时长低于设置阈值的查询在查询信息回收时会被优先回收，单位为秒（s）。该参数值默认为1，即总执行时长小于1秒的查询会优先回收。您可以通过如下SQL查看保留最短查询的时长：

  SHOW queryprofile.query_time_limit;

例如，queryprofile.max_query_num的值为10000，queryprofile.query_time_limit的值为1时，表示查询信息数量超过10000时会触发查询信息回收，查询信息回收会优先回收总执行时长小于1s的查询信息，如果记录中已没有总执行时长小于1s的记录，系统将会从最早的查询信息开始回收。

使用示例

查询执行信息可用于排查与分析查询执行的异常状态。当查询执行信息收集处于打开状态时，系统会收集所有查询的执行过程数据，您可通过执行过程数据获得如下信息：

• 系统中慢SQL或正在执行的查询。
• 查询执行信息中包含的各个算子信息及其输入或输出行数。
• 查询执行过程中耗时多的算子。
• 单一算子执行时占用的资源量，例如内存，磁盘 I/O，网络 I/O。

操作步骤如下：

1. 在当前会话中开启查询执行信息收集功能，SQL如下：

   SET queryprofile.enable = ON;

2. 查看历史查询执行信息，此处以获取最近10条历史查询执行信息为例，SQL示例如下：

   SELECT * FROM queryprofile.query_exec_history ORDER BY starttime DESC limit 10;

   返回示例如下：

   
3. 从以上返回结果中找到需要分析的查询执行信息，使用从queryprofile.query_exec_history视图中获取的queryid字段，在queryprofile.node_exec_history视图中获取该查询的执行过程，SQL示例如下：

   SELECT * FROM queryprofile.node_exec_history WHERE queryid = 6902*********93;

   返回示例如下：

   

   从返回结果中可以看到算子名称、耗时、输入行数、输出行数、占用资源等信息。您可根据表中结果对每一个算子的执行记录进行分析，以定位和解决性能问题。