建立追蹤 (Transact-SQL)

發行項
08/23/2023

適用於：SQL Server

此主題描述如何使用預存程序來建立追蹤。

若要建立追蹤

執行 sp_trace_create 並加上必要的參數，以建立新的追蹤。新的追蹤會處於停止狀態 (status 為 0)。
執行 sp_trace_setevent 並加上必要的參數，以選取要追蹤的事件和資料行。
(選擇性) 執行 sp_trace_setfilter 以設定任何篩選或篩選組合。

sp_trace_setevent 和 sp_trace_setfilter 只能在已停止的現有追蹤上執行。

重要

與一般的預存程序不同，所有 SQL Server Profiler 預存程序 (sp_trace_xx) 的參數均嚴格區分類型，且不支援自動資料類型轉換。如果沒有依照引數描述所指定，以正確的輸入參數資料類型來呼叫這些參數，預存程序會傳回錯誤。

範例

下列程式碼將示範如何使用 Transact-SQL 建立追蹤。這個程式碼含有三個區段：建立追蹤、擴展追蹤檔案以及停止追蹤。您可以透過加入想要追蹤的事件，自訂追蹤。如需事件和資料行的清單，請參閱 sp_trace_setevent (Transact-SQL)來建立追蹤。

A. 建立追蹤

下列程式碼會建立追蹤、將事件加入至追蹤，然後啟動追蹤：

DECLARE @RC int, @TraceID int, @on BIT  
EXEC @rc = sp_trace_create @TraceID output, 0, N'C:\SampleTrace'  
  
-- Select the return code to see if the trace creation was successful.  
SELECT RC = @RC, TraceID = @TraceID  
  
-- Set the events and data columns you need to capture.  
SELECT @on = 1  
  
-- 10 is RPC:Completed event. 1 is TextData column.   
EXEC sp_trace_setevent @TraceID, 10, 1, @on   
-- 13 is SQL:BatchStarting, 11 is LoginName  
EXEC sp_trace_setevent @TraceID, 13, 11, @on   
-- 13 is SQL:BatchStarting, 14 is StartTime  
EXEC sp_trace_setevent @TraceID, 13, 14, @on   
-- 12 is SQL:BatchCompleted, 15 is EndTime  
EXEC sp_trace_setevent @TraceID, 12, 15, @on   
-- 13 is SQL:BatchStarting, 1 is TextData  
EXEC sp_trace_setevent @TraceID, 13, 1, @on   
  
-- Set any filter. Not provided in this example  
--EXEC sp_trace_setfilter 1, 10, 0, 6, N'%Profiler%'  
  
-- Start Trace (status 1 = start)  
EXEC @RC = sp_trace_setstatus @TraceID, 1  
GO

B. 填入追蹤檔案

此時您已經建立並啟動追蹤，請執行下列程式碼，使用活動來擴展追蹤。

SELECT * FROM master.sys.databases  
GO  
SELECT * FROM ::fn_trace_getinfo(default)  
GO

C. 停止追蹤

您可以隨時停止並重新啟動追蹤。在這個範例中，請執行下列程式碼來停止追蹤、關閉追蹤，然後刪除追蹤定義。

DECLARE @TraceID int  
-- Populate a variable with the trace_id of the current trace  
SELECT  @TraceID = TraceID FROM ::fn_trace_getinfo(default) WHERE VALUE = N'C:\SampleTrace.trc'  
  
-- First stop the trace.   
EXEC sp_trace_setstatus @TraceID, 0  
  
-- Close and then delete its definition from SQL Server.   
EXEC sp_trace_setstatus @TraceID, 2

D. 檢查追蹤檔案

若要檢查追蹤檔案，請使用 SQL Server Profiler 開啟 SampleTrace.trc 檔案。

另請參閱

SQL Server Profiler 預存程序 (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)