• Artykuł

How to: Create a Trace (Transact-SQL)

W tym temacie opisano sposób tworzenia śledzenia przy użyciu procedur przechowywanych.

Aby utworzyć śledzenie

  1. wykonać sp_trace_create z wymaganych parametrów, aby utworzyć nowe śledzenie.Nowe śledzenia będzie (stanie zatrzymaniastatus jest 0).

  2. wykonać sp_trace_setevent z wymaganych parametrów, aby wybrać zdarzenia i kolumny do śledzenia.

  3. Opcjonalnie można uruchomić sp_trace_setfilter ustawić wszystkie lub kombinacji filtrów.

    sp_trace_setevent and sp_trace_setfilter mogą być wykonywane tylko w odniesieniu do istniejących ślady, które mają być zatrzymane.

    Important noteImportant Note:

    W odróżnieniu od zwykłych procedur przechowywanych parametry wszystkich programu SQL Server Profiler przechowywane procedury)sp_trace_xx ) wpisywane są ściśle, które nie obsługują konwersja typu danych automatyczne.Jeśli te parametry nie są nazywane z typami danych prawidłowego parametru wejściowego, jak określono w opisie argumentu procedura przechowywana zwraca błąd.

Example

Poniższy kod demonstruje, tworzenie za pomocą śledzenia Transact-SQL. Występuje w trzy sekcje: Tworzenie śledzenia, podczas wypełniania plik śledzenia i zatrzymywanie śledzenia. Dodawanie do śledzenia zdarzeń, które mają dostosować śledzenie.Aby listę zdarzeń i kolumn zobacz sp_trace_setevent (Transact-SQL).

Następujący kod tworzy śledzenia, dodaje do śledzenia zdarzeń, a następnie rozpoczyna śledzenie:

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

Teraz, śledzenie zostały utworzone i uruchomione, należy wykonać poniższy kod do wypełniania śledzenia z działania.

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

Śledzenie może być zatrzymane i ponownie uruchomiony w dowolnym czas.W tym przykładzie należy wykonać poniższy kod, Zatrzymaj śledzenie, zamknij śledzenia i usuwanie definicji śledzenia.

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

Aby w plik śledzenia otworzyć używając pliku SampleTrace.trc SQL Server Profiler.