sys.fn_trace_gettable （Transact-SQL）
適用於：
SQL Server
以表格式格式傳回一或多個追蹤檔案的內容。
重要
SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 請改用擴充事件。
語法
fn_trace_gettable ( 'filename' , number_files )
引數
'filename'
指定要讀取的初始追蹤檔案。 filename 是 nvarchar（256），沒有預設值。
number_files
指定要讀取的變換檔案數目。 此數位包含檔名中指定的初始檔案。 number_files是 int。
備註
如果 number_files 指定為 預設值， fn_trace_gettable 會讀取所有變換檔案，直到到達追蹤結尾為止。 fn_trace_gettable傳回具有指定追蹤之所有數據行的數據表。 如需詳細資訊，請參閱 sp_trace_setevent （Transact-SQL） 。
請注意，fn_trace_gettable函式不會載入換用檔案（使用 number_files 自變數指定此選項時），原始追蹤檔名以底線和數值結尾。 （這不適用於檔案變換時自動附加的底線和數位。因應措施是，您可以重新命名追蹤檔案，以移除源檔名稱中的底線。 例如，如果源檔名為 Trace_Oct_5.trc，而換用檔案名為 Trace_Oct_5_1.trc，您可以將檔案重新命名為 TraceOct5.trc 和 TraceOct5_1.trc。
此函式可以讀取仍在執行其實例上的追蹤。
權限
需要伺服器上的 ALTER TRACE 許可權。
範例
A. 使用fn_trace_gettable從追蹤檔案匯入數據列
下列範例會在 語句的 SELECT...INTO 子句內FROM呼叫 fn_trace_gettable 。
USE AdventureWorks2022;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO
B. 使用fn_trace_gettable傳回可載入 SQL Server 數據表的 IDENTITY 資料行數據表
下列範例會呼叫 函式做為 語句的一 SELECT...INTO 部分，並傳回具有 IDENTITY 可載入至數據表 的數據行的數據表 temp_trc。
USE AdventureWorks2022;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO
另請參閱
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)