启用 Oracle 10046 调试事件

程序员文章站 2024-02-03 15:48:52

...

Oracle 10046是一个Oracle内部事件。最常用的是在Session级别设置sql_trace(alter session set sql_trace=true)即是开启了级别为

Oracle 10046是一个Oracle内部事件。最常用的是在Session级别设置sql_trace(alter session set sql_trace=true)即是开启了级别为1的10046调试事件。当设置了10046事件之后，Oracle 将产生一个dump文件。通过得到的dump文件进行进一步分析，可以得到Oracle 内部执行系统解析、调用、等待、绑定变量等详细的trace信息，对于分析系统的性能有着举足轻重的作用。

一、10046事件的相关参数
该事件需要设置一些参数以控制dump文件的输出：
TIMED_STATISTICS
用于控制计时信息，可以设定为true和false。当设定为true时，计时信息将会被添加到trace文件中。

MAX_DUMP_FILE_SIZE
用于控制trace文件的最大尺寸。当使用10046事件时，建议将该参数设定为unlimited。

USER_DUMP_DEST
用于设定trace文件写入到哪个文件目录

STATISTICS_LEVEL
用于控制统计信息的收集度。此参数有3个选择，baisc，typical，all。
basic:仅收集满足trace所需的最基本的信息，，象Timed statistics，Object level statistics，以及一些advisory会被忽略。
typical:此为缺省值。此设置将在basic的基础上增加一些额外的统计信息，象操作系统耗用时间的统计信息，执行计划的统计信息都会被收集
all:当设置为all时，所有与该session相关的信息全部会被收集。

TRACEFILE_IDENTIFIER
用于设置识别Trace文件的字符串，便于更快捷的找到生成的Trace文件。

以上参数可以基于系统级别以及会话级别进行修改。
ALTER SESSION/SYSTEM SET timed_statistics=true
ALTER SESSION/SYSTEM SET max_dump_file_size=unlimited
ALTER SESSION SET tracefile_identifier='trace_sql_example' -->仅session级别

为特定的session动态设定trace相关参数，借助DBMS_SYSTEM包
sys.DBMS_SYSTEM.set_bool_param_in_session( &sid
, &serial
, 'timed_statistics'
, TRUE );
sys.DBMS_SYSTEM.set_int_param_in_session( &sid
, &serial
, 'max_dump_file_size'
, 2147483647 );

二、10046调试事件的等级
10046调试事件可以分为多个不同的等级，不同的等级输出不同的trace信息。
等级作用
0 禁止调试事件
1 调试事件处于激活状态。针对每个被处理的数据库调用，输出SQL语句,APPNAME（应用程序名）,PARSING IN CURSOR,PARSE ERROR（SQL解析）
,EXEC（执行）,FETCH（获取数据）,UNMAP,SORT UNMAP（排序，临时段）,ERROR,STAT（执行计划）,XCTEND（事务）等行。
4 包括等级1的输出，加上BIND行（绑定变量信息）
8 包括等级1的输出，加上WAIT行（等待事件信息）。对于处理过程中的每个等待，提供如下信息：等待时间的名字，持续时间，以及一些额外
的参数，可表明所等待的资源。
12 输出等级4以及等级8的所有信息