次の方法で共有

トレースの作成 (Transact-SQL)

このトピックでは、ストアド プロシージャを使用してトレースを作成する方法について説明します。

トレースを作成するには

  1. 新しいトレースを作成するために必要なパラメーターを指定して sp_trace_create を実行します。 新しいトレースは停止状態になります (状態 は 0)。

  2. sp_trace_seteventを必要なパラメーターを指定して実行し、トレースするイベントと列を選択してください。

  3. 必要に応じて、 sp_trace_setfilter を実行して、フィルターの任意または組み合わせを設定します。

    sp_trace_setevent と sp_trace_setfilter は、停止されている既存のトレースでのみ実行できます。

    重要

    通常のストアド プロシージャとは異なり、すべての SQL Server Profiler ストアド プロシージャ (sp_trace_xx) のパラメーターは厳密に型指定されており、自動データ型変換はサポートされていません。 引数の説明で指定されているように、これらのパラメーターが正しい入力パラメーター データ型で呼び出されない場合、ストアド プロシージャはエラーを返します。

例

次のコードは、Transact-SQL を使用してトレースを作成する方法を示しています。 これは、トレースの作成、トレース ファイルの設定、トレースの停止の 3 つのセクションにあります。 トレースするイベントを追加して、トレースをカスタマイズします。 イベントと列の一覧については、「 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

例

トレースが作成され、開始されたので、次のコードを実行して、トレースにアクティビティを設定します。

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

例

トレース ファイルを調べるには、SQL Server Profiler を使用して SampleTrace.trc ファイルを開きます。

こちらもご覧ください

SQL Server Profiler のストアド プロシージャ (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)

  • Last updated on