sys.fn_trace_gettable （Transact-SQL）

適用於：SQL Server

以表格式格式傳回一或多個追蹤檔案的內容。

重要

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

Transact-SQL 語法慣例

語法

  
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)