--- title: "基于 Trace 功能查找上一次 SQL 请求日志 - OceanBase 数据库 V4.1.0 | OceanBase 文档中心" description: 基于 Trace 功能查找上一次 SQL 请求日志 OceanBase 数据库支持基于 Trace 功能快速获取上一次 SQL 请求的完整日志。 为了便于查找目标 SQL 请求日志，您可提前通过设置日志打印级别来减少 SQL 模块之外的日志的打印。有关日志打印级别的相关设置请参见 设置日志打印级别 。 具体操作步骤如… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0 # 基于 Trace 功能查找上一次 SQL 请求日志 更新时间：2024-12-18 17:36:58 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/700.reference/200.administrator-guide/200.basic-database-management/900.manage-logs/400.view-logs/200.query-the-last-sql-request-log-by-using-the-trace.md) OceanBase 数据库支持基于 Trace 功能快速获取上一次 SQL 请求的完整日志。 为了便于查找目标 SQL 请求日志，您可提前通过设置日志打印级别来减少 SQL 模块之外的日志的打印。有关日志打印级别的相关设置请参见 [设置日志打印级别](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001702460)。 具体操作步骤如下： 1. 开启 Trace 功能。 可通过如下两种方式来开启 Trace 功能： - 通过设置 Session 变量 `ob_enable_show_trace` 来开启 Trace 功能。这种方式对本 Session 的后续所有语句生效。 ```sql obclient [test]> SET ob_enable_show_trace=ON; ``` - 通过设置 Hint 中的 `trace_log` 字段来开启 Trace 功能。这种方式只对携带 Hint 的当前语句生效。更多 Hint 语句相关的介绍，请参见 [Optimizer Hint](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001702247)。 ```sql obclient [test]> SELECT /*+trace_log=on*/c1 FROM t1 LIMIT 2; ``` 2. 使用 `SHOW TRACE` 查看 SQL 的执行信息。 开启 Trace 功能并执行 SQL 请求后，通过 `SHOW TRACE` 语句可获取上一次 SQL 语句的详细执行跟踪信息。 ```sql obclient [test]> SHOW TRACE; +-------------------------------------------+----------------------------+------------+ | Operation | StartTime | ElapseTime | +-------------------------------------------+----------------------------+------------+ | com_query_process | 2023-03-22 14:30:27.552259 | 0.405 ms | | └── mpquery_single_stmt | 2023-03-22 14:30:27.552266 | 0.386 ms | | ├── sql_compile | 2023-03-22 14:30:27.552283 | 0.083 ms | | │ └── pc_get_plan | 2023-03-22 14:30:27.552286 | 0.025 ms | | └── sql_execute | 2023-03-22 14:30:27.552379 | 0.242 ms | | ├── open | 2023-03-22 14:30:27.552380 | 0.024 ms | | ├── response_result | 2023-03-22 14:30:27.552417 | 0.140 ms | | │ ├── get_das_id | 2023-03-22 14:30:27.552421 | 0.000 ms | | │ └── do_local_das_task | 2023-03-22 14:30:27.552435 | 0.049 ms | | └── close | 2023-03-22 14:30:27.552570 | 0.039 ms | | ├── close_das_task | 2023-03-22 14:30:27.552571 | 0.012 ms | | └── end_transaction | 2023-03-22 14:30:27.552596 | 0.003 ms | +-------------------------------------------+----------------------------+------------+ 12 rows in set (0.006 sec) ``` `ElapseTime` 字段表示当前该步骤花费的时间，单位是毫秒。例如： `pc_get_plan` 的 `ElapseTime` 字段显示为 `0.025 ms` ，表示 OceanBase 数据库从 Plan Cache 中获取一条执行计划花费了 0.025 ms。 常见相关 Operation 介绍如下，更多 Operation 类型请参见 [全链路追踪流程](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001699651) 中的 **span**。 - com_query_process：查询过程。 - mpquery_single_stmt：单个语句的访问路径。 - sql_compile：编译 SQL。 - pc_get_plan：获取执行计划。 - hard_parse： 硬解析。 - parse：软解析。 - resolve：解析语法树的语义并生成语句。 - rewrite：重写 SQL。 - optimize：进行基于成本的优化并生成执行计划日志。 - code_generate：根据执行计划日志生成物理执行计划。 - pc_add_plan：将生成的执行计划加入 plan cache。 - sql_execute：执行物理执行计划。 - open：打开执行计划。 - response_result：执行计划过程和结果。 - get_das_id：获取 das 任务 ID。 - do_local_das_task：执行本地 das 任务。 - px_schedule：按照 px 划分任务。 - px_task：执行 px 子任务。 - close：关闭执行计划。 - close_das_task：关闭 das 任务。 - end_transaction：结束事务。 - cmd_execute：执行命令。 - cmd_open：开启 cmd 计划。 - ps_prepare：preprocess statement 的预处理。 - ps_execute：preprocess statement 的执行。 - ps_close：关闭 preprocess statement。 - pl_entry：存储过程处理。 - pl_compile：编译存储过程对象。 - pc_get_pl_object：从 plan cache 获取存储过程对象。 - pc_add_pl_object：把存储过程对象存储在 plan cache。 - pl_execute：执行存储过程。 - pl_spi_query：执行存储过程中的 spi 语句。 - pl_spi_prepare：存储过程预处理阶段。 - pl_spi_execute：执行存储过程中的 spi 语句。 - inner_prepare：内部 SQL 的预处理阶段。 - inner_execute：内部 SQL 的执行阶段。 - inner_execute_read：读内部 SQL。 - inner_execute_write：写内部 SQL。 - inner_commit：提交内部 SQL 事务。 - inner_rollback：回滚内部 SQL 事务。 3. 通过 `trace_id` 在日志文件查询上一次 SQL 请求的完整日志。 OceanBase 数据库日志打印时均会携带 `trace_id` ，通过在日志文件（ `observer.log`、`election.log` 和 `rootservice.log` ）中搜索对应的 `trace_id` ，可以获取上一次 SQL 请求的完整日志。 1. 通过 `last_trace_id()` 获取 `trace_id`。 ```sql obclient [test]> SELECT last_trace_id() FROM DUAL; +-----------------------------------+ | last_trace_id() | +-----------------------------------+ | YB42AC1E87CC-0005F6BFDB3E2199-0-0 | +-----------------------------------+ 1 row in set (0.000 sec) ``` 2. 登录对应 OBServer 节点，进入到日志文件所在目录。 ```shell cd /home/admin/oceanbase/log ``` 3. 获取 `trace_id` 所对应的日志，执行 `grep $trace_id observer.log` 命令，例如：获取 `trace_id` 为 `YB42AC1E87CC-0005F6BFDB3E2199-0-0` 的日志。 ```shell grep YB42AC1E87CC-0005F6BFDB3E2199-0-0 observer.log [2023-03-22 14:30:33.124342] [38419][T1_L0_G0][T1][YB42AC1E87CC-0005F6BFDB3E2199-0-0] {"trace_id":"0005f777-4c14-595f-508c-6681b3dac7c9","name":"pc_get_plan","id":"0005f777-4c14-59f1-5c54-a90e3ff82e85","start_ts":1679466633124337,"end_ts":1679466633124340,"parent_id":"0005f777-4c14-59ef-de27-961b48ecfdfd","is_follow":false} ``` 上一篇 下一篇 ![有帮助](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) 咨询热线