Vytvořit trasování (Transact-SQL)

Článek
03/05/2025

platí pro:SQL Server

Toto téma popisuje, jak vytvořit trasování pomocí uložených procedur.

Vytvoření trasování

Spusťte sp_trace_create s požadovanými parametry pro vytvoření nového trasování. Nová sledovací sekvence bude v zastaveném stavu (stav je 0).
Spusťte sp_trace_setevent s požadovanými parametry pro výběr událostí a sloupců, které se mají trasovat.
Volitelně můžete spustit sp_trace_setfilter a nastavit libovolný filtr nebo kombinaci filtrů.

sp_trace_setevent a sp_trace_setfilter lze spustit pouze u existujících sledovacích záznamů, které jsou zastaveny.

Důležitý

Na rozdíl od běžných uložených procedur jsou parametry všech uložených procedur SQL Server Profileru (sp_trace_xx) přísně zadané a nepodporují automatický převod datového typu. Pokud tyto parametry nejsou volána se správnými datovými typy vstupních parametrů, jak je uvedeno v popisu argumentu, uložená procedura vrátí chybu.

Příklady

Následující kód ukazuje vytvoření trasování pomocí jazyka Transact-SQL. Je ve třech částech: vytvoření trasování, naplnění trasovacího souboru a zastavení trasování. Přizpůsobte trasování přidáním událostí, které chcete trasovat. Seznam událostí a sloupců najdete v tématu sp_trace_setevent (Transact-SQL).

A. Vytvořte trasu

Následující kód vytvoří trasování, přidá události do trasování a pak spustí trasování:

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. Naplnit trasovací soubor

Teď, když je trasování vytvořené a spuštěné, spusťte následující kód, který trasování naplní aktivitou.

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

C. Zastav trasování

Trasování je možné kdykoli zastavit a restartovat. V tomto příkladu spusťte následující kód, který zastaví trasování, zavře trasování a odstraní definici trasování.

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. Prozkoumání trasovacího souboru

Chcete-li prozkoumat trasovací soubor, otevřete soubor SampleTrace.trc pomocí SQL Server Profiler.

Viz také

Uložené procedury SQL Server Profiler (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)

Sdílet prostřednictvím