sys.fn_trace_getinfo (Transact-SQL)
適用於:SQL Server
傳回所指定追蹤或所有現有追蹤的資訊。
重要
SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 請改用擴充事件。
語法
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)