前提条件

DRDS版本为2.8.8_P5后的版本（含新版本号5.1.20.0.0及以后的版本），才提供Session级别的Query Profiling功能。您可以通过udal show version();命令查看DRDS版本号。

快速入门

1. 执行如下命令，开启诊断模式

   udal set trace=1;  

2. 执行如下命令，标记关键业务查询。

   /*!hint({"source":{"traceid":"payment_analysis"}})*/  SELECT * FROM orders WHERE create_time > '2023-06-01';

3. 执行如下命令，获取诊断报告。

   udal show trace where traceid="payment_analysis";  

主要参数说明

• 开启或关闭Profile功能。

  udal set trace = {0|1};

  参数说明如下：

  • 1：开启

  • 0：关闭

• 设置保留历史Proflie记录最大条数。

  udal set trace maxsize = N

  参数说明如下：

  • N：历史记录最大值。默认保留100条历史语句的记录，取值范围为1-10000，超过最大值后，将覆盖最早的历史记录。

    注意

    相关诊断报告保存在内存中，重启节点等操作将会导致清空历史数据。

• 查看Profile功能状态。

  udal show trace status;

  输出字段说明如下：

  • Enabled：功能是否开启。

  • MaxSize：保存历史记录最大值。

• 查看支持的历史语句记录。

  udal show traces;

• 查看执行语句Profile记录。

  udal show trace [where {id|traceid} = ?];

  参数说明如下：

  • 不带where，查看上一条语句的Profile记录。

  • 带where：

    • id = ?：历史记录序号，可通过udal show traces获取。

    • traceid = ?：历史记录traceid标识，可通过udal show traces获取。

• 设置执行语句的traceid。

  /*!hint({"source":{"traceid":"traceid_value"}})*/select * from t1;

  参数说明如下：

  • source：系统标记关键字，不可修改。

  • traceid：系统标记关键字，不可修改。

  • traceid_value：traceid_value为traceid实际值，由用户自行定义设置。

    注意

    traceid_value没有格式和长度要求，如果用户多条语句使用了同样的traceid_value，使用该traceid_value查看Profile信息时，将显示为最近执行的语句记录。

诊断报告解析

字段说明

Operation字段说明

示例报告