sys.fn_trace_getinfo (Transact-SQL)

适用于SQL Server

返回有关指定跟踪或所有现有跟踪的信息。

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 请改用扩展事件。

Transact-SQL 语法约定

语法

  
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )  

参数

trace_id
跟踪的 ID。 trace_id为 int。有效输入是跟踪、NULL、0 或 DEFAULT 的 ID 号。 在此上下文中,NULL、0 和 DEFAULT 是等效值。 指定 NULL、0 或 DEFAULT 可返回 SQL Server 实例中所有跟踪的信息。

返回的表

列名称 数据类型 描述
traceid int 跟踪的 ID。
property int 跟踪的属性:

1= 跟踪选项。 有关详细信息,请参阅@optionssp_trace_create(Transact-SQL)。

2 = 文件名

3 = 最大大小

4 = 停止时间

5 = 当前跟踪状态。 0 = 停止。 1 = 正在运行。
value sql_variant 有关指定跟踪的属性的信息。

注解

当传递特定跟踪的 ID 时,fn_trace_getinfo 将返回有关该跟踪的信息。 传递无效 ID 时,此函数将返回空行集。

fn_trace_getinfo 会将 .trc 扩展名附加到其结果集中包含的所有跟踪文件名。 有关定义跟踪的信息,请参阅sp_trace_create(Transact-SQL)。 有关跟踪筛选器的类似信息,请参阅sys.fn_trace_getfilterinfo(Transact-SQL)。

有关使用跟踪存储过程的完整示例,请参阅“创建跟踪”(Transact-SQL)。

权限

要求对服务器具有 ALTER TRACE 权限。

示例

以下示例返回有关所有活动跟踪的信息。

SELECT * FROM sys.fn_trace_getinfo(0) ;  
GO  

另请参阅

创建跟踪 (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL)
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_gettable (Transact-SQL)