fn_trace_gettable (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