Nyomkövetés létrehozása (Transact-SQL)

A következőkre vonatkozik:SQL Server

Ez a témakör azt ismerteti, hogyan hozhat létre nyomkövetést tárolt eljárásokkal.

Nyomkövetés létrehozása

1. Új nyomkövetés létrehozásához hajtsa végre a sp_trace_create a szükséges paraméterekkel. Az új nyomvonal leállt állapotban lesz (állapot0).

2. Hajtsa végre a sp_trace_setevent parancsot a követendő események és oszlopok kiválasztásához szükséges paraméterekkel.

3. Opcionálisan futtassa a sp_trace_setfilter parancsot a szűrők bármelyikének vagy kombinációjának beállításához.

   sp_trace_setevent és sp_trace_setfilter csak meglévő, leállított nyomkövetéseken hajthatók végre.

   Fontos

   A hagyományos tárolt eljárásokkal ellentétben az SQL Server Profiler által tárolt összes eljárás paraméterei (sp_trace_xx) szigorúan be vannak állítva, és nem támogatják az automatikus adattípus-átalakítást. Ha ezek a paraméterek nem a megfelelő bemeneti paraméter adattípusokkal vannak meghívva, az argumentum leírásában megadottak szerint a tárolt eljárás hibát ad vissza.

Példák

Az alábbi kód bemutatja, hogyan hozhat létre nyomkövetést a Transact-SQL használatával. Ez három szakaszból áll: a nyomkövetés létrehozása, a nyomkövetési fájl feltöltése és a nyomkövetés leállítása. A nyomkövetés testreszabásához adja hozzá a nyomon követni kívánt eseményeket. Az események és oszlopok listájáért lásd: sp_trace_setevent (Transact-SQL).

Egy. Nyomkövetés létrehozása

A következő kód létrehoz egy nyomkövetést, eseményeket ad hozzá a nyomkövetéshez, majd elindítja a nyomkövetést:

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. A nyomkövetési fájl feltöltése

A nyomkövetés létrehozása és elindítása után hajtsa végre a következő kódot a nyomkövetés tevékenységgel való feltöltéséhez.

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

C. A nyomkövetés leállítása

A nyomkövetés bármikor leállítható és újraindítható. Ebben a példában hajtsa végre a következő kódot a nyomkövetés leállításához, a nyomkövetés bezárásához és a nyomkövetés definíciójának törléséhez.

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. A nyomkövetési fájl vizsgálata

A nyomkövetési fájl vizsgálatához nyissa meg a SampleTrace.trc fájlt az SQL Server Profilerrel.

Lásd még:

SQL Server Profiler tárolt eljárásai (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)