sql trace

“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

这个包属于   SYS   用户，而且并未授权其它用户使用。建议仅仅当你作为SYSDBA登录的时候使用。 
  
  你可以先这样看看究竟有没有： 
  
  sqlplus   /nolog 
  conn   /   as   sysdba 
  desc   sys.dbms_system 
  
  如果还是没有，那就手工运行脚本来创建 
  @$ORACLE_HOME\rdbms\admin\DBMSUTIL.SQL 
  @$ORACLE_HOME\rdbms\admin\prvtutil.plb  

通过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        VARCHAR2       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“诊断事件”概念的介绍