---
title: 使用 sql_plan_monitor 与 monitor dump 诊断正确性问题-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 使用 sql_plan_monitor 与 monitor dump 诊断正确性问题相关的常见问题和使用技巧，帮助您快速解决 使用 sql_plan_monitor 与 monitor dump 诊断正确性问题的难题。
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

划线反馈

# 使用 sql_plan_monitor 与 monitor dump 诊断正确性问题

更新时间：2024-04-11 06:06

适用版本： V2.1.x、V2.2.x、V3.1.x、V3.2.x 内容类型：Troubleshoot  

并行执行返回结果不正确，有关复杂执行计划正确性问题，其并行、串行执行结果集不一致。本文总结一下排查过程中的有效操作。

## 诊断流程

同一个 SQL，并行执行结果和串行执行结果不一致。当计划特别复杂时，缩小问题排查范围很重要。

### 步骤一：通过 sql_audit 与 sql_plan_monitor 获取 SQL 的 TRACE ID 值

分别对串行 SQL、并行 SQL 执行如下操作。

1. 确认 `sql_plan_monitor` 是否已开启。

   ```shell
   show parameters like 'enable_sql_audit';

   ```

   ```shell
   ## 如果 enable_sql_audit = False 则将其开启。

   alter system enable_sql_audit = true;

   ```
 2. 获取 SQL 执行计划。

   ```shell
   explain xxxxxx;

   ```
 3. 执行 SQL。
 4. 临时关闭 monitor 数据，防止刷掉。

      1. 确认 `enable_sql_audit` 是否已开启。

        ```
      2. 如果 enable_sql_audit = Ture 则将其关闭。

        ```shell
        alter system enable_sql_audit = False;

        ```
 5. 获取 SQL 的 TRACE ID（Yxxxxxxxxx）获取每个算子的吐行信息。

      - MySQL 租户。

       ```shell
       select plan_line_id, plan_operation, sum(output_rows), sum(STARTS) rescan, min(first_refresh_time) open_time, max(last_refresh_time) close_time, min(first_change_time) first_row_time, max(last_change_time) last_row_eof_time, count(1) from oceanbase.gv$sql_plan_monitor where trace_id = 'Yxxxxxxxxx' group by  plan_line_id, plan_operation order by plan_line_id;

       ```
      - Oracle 租户。

       ```shell
       select plan_line_id, plan_operation, sum(output_rows), sum(STARTS) rescan, min(first_refresh_time) open_time, max(last_refresh_time) close_time, min(first_change_time) first_row_time, max(last_change_time) last_row_eof_time, count(1) from sys.gv$sql_plan_monitor where trace_id = 'Yxxxxxxxxx' group by  plan_line_id, plan_operation order by plan_line_id;

       ```
 6. 恢复 sql_audit。

   ```shell
   alter system enable_sql_audit = true;

   ```

### 步骤二：分析

完成上述诊断流程后，将 explain 结果、`sql_plan_monitor` 结果打包发回分析。结合计划，逐个算子对比 `sql_plan_monitor` 中的数据，查看行数从哪里起不一致。串行、并行计划中有很多干扰算子，可以用下面的命令处理一下。

```shell
grep -v "EXCHANGE" monitor_result.txt | grep -v MATERIAL | grep -v "PX " | grep -v "SUBPLAN SCAN" | grep -v "TRANSMIT" | grep -v "RECEIVE" | sed '/^[ ]*$/d'

```

![image001.png](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/20240325sqlplanmior001.png)

找到不一致的点后，增加 monitor dump 来监控不一致算子的输入有什么不同。对比并行串行结果可知，`NESTED-LOOP CONNECT BY`吐出的行数不一致。

并行计划中，该算子的两个 child 的 算子 ID 为 28,135：

![image002.png](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/20240325sqlplanmior002.png)

串行计划中，该算子的两个 child 的 算子 ID 为 15,55：

![image003.png](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/20240325sqlplanmior003.png)

使用 tracing() hint 来获取数据。

### 步骤三：获取串行与并行执行计划

1. 如果需要 tracing 的行数很多，需要临时关闭日志限流。

      1. 在系统租户 SYS 中查看系统日志限流 `syslog_io_bandwidth_limit` 参数值。

        ```shell
        show parameters like 'syslog_io_bandwidth_limit';

        ```
      2. 设置系统日志所能占用的磁盘 IO 带宽上限值，关闭日志限流。

        ```shell
        alter system set syslog_io_bandwidth_limit= '10000MB';

        ```
 2. 分别对串行 SQL、并行 SQL 执行下述操作。

      - 串行计划。

            1. explain 带 /*+ tracing(15,55) */ hint 的 SQL，把计划保存下来（用来确认 hint 加对地方没有）。
            2. 执行带 /*+ tracing(15,55) */ hint 的 SQL，获取 trace_id 的值为 Yxxxxx-yyyy。
            3. 通过步骤 2 获取的 trace_id 值，在所有机器上查找相应的日志信息。

              ```shell
              grep ob_monitoring_dump.*Yxxxxx-yyyy  observer.log.xxxx

              ```
      - 并行计划

            1. explain 带 /*+ tracing(28,135) parallel(31) */ hint 的 SQL，把计划保存下来（用来确认 hint 加对地方没有 ）。
            2. 执行带 /*+ tracing(28,135) parallel(31) */ hint 的 SQL，获取 trace_id 值为 Yxxxxx-yyyy。
            3. 通过步骤 2 获取的 trace_id 值，在所有机器上查找相应的日志信息。

              ```  

       #### 注意

            1. 串行计划、并行计划的 hint 不一样，操作时请注意。
            2. 获取日志时，要去所有机器上获取。
 3. 恢复日志限流。

      1. 恢复设置系统日志所能占用的磁盘 IO 带宽上限值默认值 30MB，开启日志限流。

        ```shell
        alter system set syslog_io_bandwidth_limit= '30MB';

        ```
      2. 在系统租户 SYS 中查看系统日志限流 `syslog_io_bandwidth_limit` 参数值。

        ```

### 四、总结

- 分析获取的行数据，如果串行、并行计划里的 projector 不一样，需要根据 projector 信息对数据做一些重排。然后对数据排序，vimdiff 看排序后的结果，查找不一致的点。
 - 如果完全一致，就不要排序，怀疑软件缺陷和数据输入顺序有关。

## 使用版本

OceanBase 数据库所有版本。

上一篇

[执行 set ob_enable_trace_log = 1 不生效](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000262231)

下一篇

[开启表并行后，limit 失效，没有选择最优索引](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000245507) ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线