Utwórz ślad (Transact-SQL)

Dotyczy:programu SQL Server

W tym temacie opisano, jak używać procedur składowanych do tworzenia śladu.

Aby utworzyć ślad

1. Wykonaj sp_trace_create z wymaganymi parametrami, aby utworzyć nowy ślad. Nowy ślad będzie w stanie zatrzymanym (stan to 0).

2. Wykonaj sp_trace_setevent z wymaganymi parametrami, aby wybrać zdarzenia i kolumny do śledzenia.

3. Opcjonalnie wykonaj sp_trace_setfilter, aby ustawić dowolną lub kombinację filtrów.

   sp_trace_setevent i sp_trace_setfilter można wykonywać tylko na istniejących śladach, które zostały zatrzymane.

   Ważny

   W przeciwieństwie do zwykłych procedur składowanych parametry wszystkich procedur składowanych programu SQL Server Profiler (sp_trace_xx) są ściśle typizowane i nie obsługują automatycznej konwersji typów danych. Jeśli te parametry nie są wywoływane z poprawnymi typami danych parametrów wejściowych, jak określono w opisie argumentu, procedura składowana zwraca błąd.

Przykłady

Poniższy kod przedstawia tworzenie śledzenia przy użyciu języka Transact-SQL. Znajduje się on w trzech sekcjach: tworzenie śladu, wypełnianie pliku śledzenia i zatrzymywanie śladu. Dostosuj ślad, dodając zdarzenia, które chcesz śledzić. Aby uzyskać listę zdarzeń i kolumn, zobacz sp_trace_setevent (Transact-SQL).

A. Tworzenie śladu

Poniższy kod tworzy ślad, dodaje zdarzenia do śledzenia, a następnie uruchamia ślad:

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. Uzupełnij plik śledzenia

Teraz, po utworzeniu i uruchomieniu śledzenia, wykonaj następujący kod, aby wypełnić śledzenie aktywnością.

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

C. Zatrzymaj śledzenie

Śledzenie można zatrzymać i uruchomić ponownie w dowolnym momencie. W tym przykładzie wykonaj następujący kod, aby zatrzymać ślad, zamknąć ślad i usunąć definicję ś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  
  

D. Sprawdź plik śledzenia

Aby sprawdzić plik śledzenia, otwórz plik SampleTrace.trc przy użyciu programu SQL Server Profiler.

Zobacz też

Profiler procedur składowanych programu SQL Server (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)