sys.fn_trace_getinfo (Transact-SQL)

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

重要事項
未來的 Microsoft 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= 追蹤選項。 如需詳細資訊，請參閱＜sp_trace_create (Transact-SQL)＞中的 @options。 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)