SQL Server Profiler T-SQL跟踪

最新推荐文章于 2024-03-11 11:03:40 发布

转载最新推荐文章于 2024-03-11 11:03:40 发布 · 1.4k 阅读

文章标签：

#sql server #profiler #file #服务器 #microsoft #null

SQL SERVER 专栏收录该内容

41 篇文章

订阅专栏

本文介绍了如何使用sp_trace_create创建SQL Server跟踪，包括设置跟踪选项、添加事件及筛选条件等，并提供了实用示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

sp_trace_create
创建跟踪定义。新的跟踪将处于停止状态。

语法：

sp_trace_create [ @traceid = ] trace_id OUTPUT
          , [ @options = ] option_value
          , [ @tracefile = ] 'trace_file'
     [ , [ @maxfilesize = ] max_file_size ]
     [ , [ @stoptime = ] 'stop_time' ]
     [ , [ @filecount = ] 'max_rollover_files' ]

参数：

@traceid
跟踪的编号。数据类型为 int，默认为 NULL。用户使用 trace_id 值标识、修改和控制此存储过程定义的跟踪。

@options
指定为跟踪设置的选项。option_value 的数据类型为 int，无默认设置。

选项名值说明
TRACE_FILE_ROLLOVER 2 指定当达到 max_file_size ，将关闭当前跟踪文件并创建新文件。常用的使用这个值。
SHUTDOWN_ON_ERROR 4 指定无论任何原因，如果不能将跟踪写入文件，则 SQL Server 将关闭。
TRACE_PRODUCE_BLACKBOX 6 同时启用上面两个选项，2和4
TRACE_PRODUCE_BLACKBOX 8 指定服务器产生的最后 5MB 跟踪信息记录将由服务器保存。

@tracefile
指定跟踪将写入的位置和文件名。trace_file 的数据类型为 nvarchar(245)，没有默认设置。trace_file 可以是本地目录，也可以是到共享或路径。

@maxfilesize
指定跟踪文件可以增长到的最大文件大小 (MB)。max_file_size 的数据类型为 bigint，默认设置为 5。

@stoptime
指定停止跟踪的日期和时间，stop_time 的数据类型为 datetime，默认值为 NULL。如果为 NULL，该跟踪将一直运行，直到它被手动停止或服务器关闭。

@filecount
指定使用同一基准文件名维护的最大跟踪文件数。max_rollover_files 的数据类型为 int，其值大于 1。这个选项通常不用设置，当然要保证有足够的磁盘空间，否则磁盘空间填满的时候跟踪会自动停止。

返回值：

返回代码说明
0 没有错误。
1 未知错误
10 无效选项。指定的选项不兼容时返回此代码。
12 文件未创建。
13 内存不足。在没有足够内存执行指定的操作时返回此代码。
14 无效停止时间。在指定的停止时间已发生时返回此代码。
15 参数无效。在用户已提供不兼容的参数时返回此代码。

sp_trace_setevent
在跟踪中添加或删除事件或事件列。只能对已停止的现有跟踪（status 为 0）执行 sp_trace_setevent。如果对不存在的或其 status 值不为 0 的跟踪执行此存储过程，则将返回错误。

语法：

sp_trace_setevent [ @traceid = ] trace_id
          , [ @eventid = ] event_id
          , [ @columnid = ] column_id
          , [ @on = ] on

参数：

@traceid
要修改的跟踪的 ID。

@eventid
要打开的事件的 ID。event_id 的数据类型为 int，无默认值。可以跟踪的事件有几百个，这里只列出较常用的几个，其他的MSDN上有完整的介绍。

事件号事件名称说明
10 RPC:Completed 在完成了远程过程调用 (RPC) 时发生。
12 SQL:BatchCompleted 在完成了 Transact-SQL 批处理时发生。
14 Audit Login 在用户成功登录到 Microsoft SQL Server 时发生。
17 ExistingConnection 在检测所有用户在启动跟踪前连接到 SQL Server 的活动。
25 Lock:Deadlocktd> 指示两个并发事务由于试图获得对方事务拥有的资源的不兼容锁而发生了相互死锁。
59 Lock:Deadlock Chain 为导致死锁的每个事件而生成。

@columnid
要为该事件添加的列的 ID。column_id 的数据类型为 int，无默认值。这里也只列常用的。

列号列名说明
1 TextData 与跟踪内捕获的事件类相关的文本值。
8 HostName 发起请求的客户端计算机的名称。
10 ApplicationName 创建与 SQL Server 实例的连接的客户端应用程序的名称。此列由应用程序传递的值填充，而不是由所显示的程序名填充。
11 LoginName 客户端的 SQL Server 登录名。
12 SPID SQL Server 分配给与客户端关联的进程的服务器进程 ID。
13 Duration 事件所花费的实耗时间（毫秒）。Hash Warning 事件不填充该数据列。
14 StartTime 事件开始的时间（如果可用）。
27 EventClass 被记录的事件类的类型。
35 DatabaseName USE database 语句中指定的数据库名称。

@on
指定将事件设置为 ON (1) 还是 OFF (0)。on 的数据类型为 bit，无默认值。

sp_trace_setfilter
将筛选应用于跟踪。只能对已停止的现有跟踪（status 的值为 0）执行 sp_trace_setfilter。如果对不存在的跟踪或其 status 值不为 0 的跟踪执行此存储过程，则 SQL Server 将返回错误。

语法：

sp_trace_setfilter [ @traceid = ] trace_id
          , [ @columnid = ] column_id
          , [ @logical_operator = ] logical_operator
          , [ @comparison_operator = ] comparison_operator
          , [ @value = ] value

@traceid
要为其设置筛选器的跟踪的 ID。

@columnid
应用筛选器的列的 ID。

@logical_operator
指定将应用 AND (0) 运算符还是应用 OR (1) 运算符。logical_operator 的数据类型为 int，无默认值。

@comparison_operator
指定要执行的比较的类型。comparison_operator 的数据类型为 int，无默认值。

值比较运算符
0 =（等于）
1 <>（不等于）
2 >（大于）
3 <（小于）
4 >=（大于或等于）
5 <=（小于或等于）
6 LIKE
7 NOT LIKE

@value
指定要在其上进行筛选的值。

sp_trace_setstatus
修改指定跟踪的当前状态。

语法：

sp_trace_setstatus [ @traceid = ] trace_id
, [ @status = ] status

@traceid
trace_id要修改的跟踪的 ID。

@status
指定要在跟踪上实现的操作。status 的数据类型为 int，无默认值。

状态说明
0 停止指定的跟踪。
1 启动指定的跟踪。
2 关闭指定的跟踪并从服务器中删除其定义。