Создание трассировки (Transact-SQL)

Статья
08/23/2023

Область применения: SQL Server

В этом подразделе описано, как использовать хранимые процедуры для создания трассировки.

Создание трассировки

Выполните хранимую процедуру sp_trace_create с необходимыми аргументами для создания новой трассировки. Новая трассировка будет находиться в остановленном состоянии (status имеет значение 0).
Выполните хранимую процедуру sp_trace_setevent с необходимыми аргументами, чтобы выбрать события и столбцы для трассировки.
Дополнительно выполните хранимую процедуру sp_trace_setfilter , чтобы установить любой фильтр или комбинацию фильтров.

Хранимые процедурыsp_trace_setevent и sp_trace_setfilter могут быть выполнены только для существующих остановленных трассировок.

Внимание

В отличие от обычных хранимых процедур, параметры всех хранимых процедур приложения SQL Server Profiler (sp_trace_xx) жестко типизированы и не поддерживают автоматическое преобразование типов данных. Если эти параметры не вызываются вместе с правильными типами данных входных параметров, как указано в описании аргумента, хранимая процедура возвращает ошибку.

Примеры

В следующем коде показано создание трассировки с помощью Transact-SQL. Он состоит из трех разделов: создание трассировки, заполнение файла трассировки и остановка трассировки. Настройте трассировку, добавив события, которые необходимо отслеживать. Список событий и столбцов см. в sp_trace_setevent (Transact-SQL).

А. Создание трассировки

Следующий код создает трассировку, добавляет в нее события и затем запускает ее:

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

В. Остановка трассировки

Трассировку можно в любое время остановить и перезапустить. В этом примере выполнение следующего кода позволит остановить трассировку, закрыть ее и удалить ее определение.

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. Изучение файла трассировки

Чтобы проверить файл трассировки, откройте файл SampleTrace.trc с помощью SQL Server Profiler.

См. также

Хранимые процедуры SQL Server Profiler (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)

Поделиться через