oracle“SQL Trace”简介

“SQL TRACE”是Oracle提供的用于进行SQL跟踪的手段，是强有力的辅助诊断工具。在日常的数据库问题诊断和解决中，“SQL TRACE”是非常常用的方法。

一般，一次跟踪可以分为以下几步：

1、界定需要跟踪的目标范围，并使用适当的命令启用所需跟踪。

2、经过一段时间后，停止跟踪。此时应该产生了一个跟踪结果文件。

3、找到跟踪文件，并对其进行格式化，然后阅读或分析。

 

oracle“SQL Trace”简介

oracle“SQL Trace”简介... 1

一、概述... 1

二、“SQL TRACE”的启用。... 1

(A)SQL_TRACE说明... 1

(B) 10046事件说明... 3

(C)对启用方法的一些总结。... 4

三、读取当前已经设置的参数... 4

四、获取跟踪文件... 5

五、参考... 6

一、概述

“SQL TRACE”是Oracle提供的用于进行SQL跟踪的手段，是强有力的辅助诊断工具。在日常的数据库问题诊断和解决中，“SQL TRACE”是非常常用的方法。

一般，一次跟踪可以分为以下几步：

1、界定需要跟踪的目标范围，并使用适当的命令启用所需跟踪。

2、经过一段时间后，停止跟踪。此时应该产生了一个跟踪结果文件。

3、找到跟踪文件，并对其进行格式化，然后阅读或分析。

本文就“SQL TRACE”的这些使用作简单探讨，并通过具体案例对SQL_TRACE的使用进行说明。

二、“SQL TRACE”的启用。

(A)SQL_TRACE说明

SQL_TRACE可以作为初始化参数在全局启用，也可以通过命令行方式在具体session启用。

1． 在全局启用

在参数文件(pfile/spfile)中指定: SQL_TRACE = true

    在全局启用SQL_TRACE会导致所有进程的活动被跟踪，包括后台进程及所有用户进程，这通常会导致比较严重的性能问题，所以在生产环境中要谨慎使用。

提示: 通过在全局启用SQL_TRACE，我们可以跟踪到所有后台进程的活动，很多在文档中的抽象说明，通过跟踪文件的实时变化，我们可以清晰的看到各个进程之间的紧密协调。

2． 在当前session级设置

大多数时候我们使用SQL_TRACE跟踪当前会话的进程。通过跟踪当前进程可以发现当前操作的后台数据库递归活动(这在研究数据库新特性时尤其有效)，研究SQL执行，发现后台错误等。

在session级启用和停止SQL_TRACE方式如下:

启用当前session的跟踪:

SQL> alter session set SQL_TRACE=true;

Session altered.

此时的SQL操作将被跟踪:

SQL> select count(*) from dba_users;

 COUNT(*)

----------

        34

结束跟踪:

SQL> alter session set SQL_TRACE=false;

Session altered.

3． 跟踪其它用户进程

    在很多时候我们需要跟踪其他用户的进程，而不是当前用户，这可以通过Oracle提供的系统包DBMS_SYSTEM.SET_SQL_TRACE_IN_SESSION来完成

SET_SQL_TRACE_IN_SESSION过程序要提供三个参数:

SQL> desc DBMS_SYSTEM.SET_SQL_TRACE_IN_SESSION;

Parameter Type    Mode Default?

--------- ------- ---- --------

SID       NUMBER IN           

SERIAL#   NUMBER IN           

SQL_TRACE BOOLEAN IN

通过v$session我们可以获得sid、serial#等信息:

获得进程信息，选择需要跟踪的进程:

SQL> select sid,serial#,username from v$session

 2 where username is not null;

       SID    SERIAL# USERNAME

---------- ---------- ------------------------------

         8       2041 SYS

         9        437 EYGLE

设置跟着:

SQL> exec dbms_system.set_SQL_TRACE_in_session(9,437,true)

PL/SQL procedure successfully completed.

….

可以等候片刻，跟踪session执行任务,捕获sql操作…

….

停止跟踪:

SQL> exec dbms_system.set_SQL_TRACE_in_session(9,437,false)

PL/SQL procedure successfully completed.

(B) 10046事件说明

10046事件是Oracle提供的内部事件，是对SQL_TRACE的增强.

10046事件可以设置以下四个级别:

1 - 启用标准的SQL_TRACE功能,等价于SQL_TRACE。

4 - Level 1 加上绑定值(bind values)

8 - Level 1 + 等待事件跟踪

12 - Level 1 + Level 4 + Level 8

类似SQL_TRACE方法，10046事件可以在全局设置，也可以在session级设置。

对于10046事件的设置，涉及到了oracle的“诊断事件”的概念。

可以参考以下链接了解详情。http://www.itpub.net/323537,1.html

1． 在全局设置

在参数文件中增加:

EVENT="10046 trace name context forever,level 12"

此设置对所有用户的所有进程生效、包括后台进程.

2． 对当前session设置

通过alter session的方式修改，需要alter session的系统权限:

SQL> alter session set events '10046 trace name context forever';

Session altered.

SQL> alter session set events '10046 trace name context forever, level 8';

Session altered.

SQL> alter session set events '10046 trace name context off';

Session altered.

3． 对其他用户session设置

通过DBMS_SYSTEM.SET_EV系统包来实现:

SQL> desc DBMS_SYSTEM.SET_EV;

Parameter Type           Mode Default?

--------- -------------- ---- --------

SI        BINARY_INTEGER IN           

SE        BINARY_INTEGER IN           

EV        BINARY_INTEGER IN           

LE        BINARY_INTEGER IN           

NM        VARCHAR 2       IN  

其中的参数SI、SE来自v$session视图:

查询获得需要跟踪的session信息:

SQL> select sid,serial#,username from v$session where username is not null;

SID SERIAL# USERNAME

---------- ---------- ------------------------------

8 2041 SYS

9 437 EYGLE

执行跟踪:

SQL> exec dbms_system.set_ev(9,437,10046,8,'eygle');

PL/SQL procedure successfully completed.

结束跟踪:

SQL> exec dbms_system.set_ev(9,437,10046,0,'eygle');

PL/SQL procedure successfully completed.

(C)对启用方法的一些总结。

因为trace的目标范围不同，导致必须使用不同的方法。

作用于数据库全局的，就改初始化参数。

只作用于本session的，就用alter session 命令。

作用于其它session的，就用DBMS_SYSTEM包。

再加上10046诊断事件，是SQL_TRACE的增强，又多了一套方法。

三、读取当前已经设置的参数

对于全局的SQL_TRACE参数的设置，可以通过show parameter命令获得。

当我们通过alter session的方式设置了SQL_TRACE,这个设置是不能通过show parameter的方式得到的,我们需要通过dbms_system.read_ev来获取：

SQL> set feedback off

SQL> set serveroutput on

SQL> declare

2 event_level number;

3 begin

4 for event_number in 10000..10999 loop

5 sys.dbms_system.read_ev(event_number, event_level);

6 if (event_level > 0) then

7 sys.dbms_output.put_line(

8 'Event ' ||

9 to_char(event_number) ||

10 ' is set at level ' ||

11 to_char(event_level)

12 );

13 end if;

14 end loop;

15 end;

16 /

Event 10046 is set at level 1

四、获取跟踪文件

以上生成的跟踪文件位于“user_dump_dest”参数所指定的目录中，位置及文件名可以通过以下SQL查询获得:

SELECT d.value||'/'||lower(rtrim(i.instance, chr(0)))||'_ora_'||p.spid||'.trc' trace_file_name 

from 

    ( select p.spid 

      from sys.v$mystat m,sys.v$session s,sys.v$process p 

      where m.statistic# = 1 and s.sid = m.sid and p.addr = s.paddr) p, 

    ( select t.instance from sys.v$thread t,sys.v$parameter v 

      where v.name = 'thread' and (v.value = 0 or t.thread# = to_number(v.value))) i, 

    ( select value from sys.v$parameter where name = 'user_dump_dest') d

;

TRACE_FILE_NAME

-------------------------------------------------------------------------------

/opt/oracle/admin/hsjf/udump/hsjf_ora_1026.trc

五、格式化跟踪文件。

原始的跟踪文件是很难读懂的。需要使用oracle自带的tkprof命令行工具格式化一下。

tkprof hsjf_ora_1026.trc hsjf_ora_1026.txt

这个就可以方便的阅读了。可以在hsjf_ora_1026.txt文件中看到所有的sql语句执行次数,CPU使用时间等数据。

tkprof命令还有许多选项，没有仔细研究过。

五、参考

此文并不是原创，参考了以下文章。

1．http://www.eygle.com/case/Use.SQL_TRACE.to.Diagnose.database.htm

SQL TRACE基础介绍。看了这篇文章，就明白为什么有那么多种产生trace文件的方法了。

2．http://www.itpub.net/323537,1.html

ORACLE“诊断事件”概念的介绍