共用方式為


建立追蹤 (Transact-SQL)

適用於:SQL Server

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

若要建立追蹤

  1. 執行 sp_trace_create 並加上必要的參數,以建立新的追蹤。 新的追蹤會處於停止狀態 (status0)。

  2. 執行 sp_trace_setevent 並加上必要的參數,以選取要追蹤的事件和資料行。

  3. (選擇性) 執行 sp_trace_setfilter 以設定任何篩選或篩選組合。

    sp_trace_seteventsp_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)