sys.fn_trace_getinfo (Transact-SQL)
适用范围:SQL Server
返回有关指定跟踪或所有现有跟踪的信息。
重要
在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 请改用扩展事件。
语法
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)