sys.fn_trace_getinfo (Transact-SQL)

適用於:SQL Server

傳回所指定追蹤或所有現有追蹤的資訊。

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 請改用擴充事件。

Transact-SQL 語法慣例

語法

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

引數

trace_id
這是追蹤的標識碼。 trace_id為 int。有效的輸入是追蹤、NULL、0 或 DEFAULT 的標識碼。 NULL、0 和 DEFAULT 在此內容中是相等的值。 指定 NULL、0 或 DEFAULT,以傳回 SQL Server 實例中所有追蹤的資訊。

傳回的數據表

資料行名稱 資料類型 描述
traceid int 追蹤的標識碼。
property int 追蹤的屬性:

1= 追蹤選項。 如需詳細資訊,請參閱 @options sp_trace_create (Transact-SQL) 中的

2 = 檔名

3 = 大小上限

4 = 停止時間

5 = 目前的追蹤狀態。 0 = 已停止。 1 = 執行中。
value sql_variant 指定之追蹤屬性的相關信息。

備註

傳遞特定追蹤的標識碼時,fn_trace_getinfo傳回該追蹤的相關信息。 傳遞無效的識別碼時,此函式會傳回空的數據列集。

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)