Share via

sys.fn_trace_getinfo (Transact-SQL)

  • 项目

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

重要说明重要提示

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

主题链接图标 Transact-SQL 语法约定

语法

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

参数

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

返回的表

列名

数据类型

说明

traceid

int

跟踪的 ID。

property

int

跟踪的属性：

1= 跟踪选项。 有关详细信息，请参阅 sp_trace_create (Transact-SQL) 中的 @options。

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)