• 發行項

fn_trace_gettable (Transact-SQL)

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

主題連結圖示Transact-SQL 語法慣例

語法

fn_trace_gettable ( 'filename' , number_files )

引數

  • 'filename'
    指定要讀取的初始追蹤檔。filename 是 nvarchar(256)，沒有預設值。

  • number_files
    指定要讀取的換用檔案的數目。這個數目包括 filename 中所指定的初始檔案。number_files 是 int。

備註

如果 number_files 指定為 default，fn_trace_gettable 會讀取所有換用檔案，直到到達追蹤結尾為止。fn_trace_gettable 會傳回一份資料表，其中含有對指定之追蹤有效的所有資料行。如需詳細資訊，請參閱＜sp_trace_setevent (Transact-SQL)＞。

請注意，對於名稱以底線加上數值結尾的原始追蹤檔案，當使用 number_files 引數指定此選項時，fn_trace_gettable 函數不會載入換用檔案 (若為檔案換用時自動附加的底線及數值，則不在此列)。為了因應此情況，您可以重新命名追蹤檔案，移除原始檔案名稱中的底線。例如，如果原始檔案名稱是 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 AdventureWorks2008R2;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO

B. 利用 fn_trace_gettable 來傳回含有可載入 SQL Server 資料表之 IDENTITY 資料行的資料表

下列範例會在 SELECT...INTO 陳述式中呼叫這個函數，且會傳回一份含有可載入 temp_trc 資料表之 IDENTITY 資料行的資料表。

USE AdventureWorks2008R2;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO