指定したトレースまたは既存のトレースの情報を返します。

構文

fn_trace_getinfo( [ @traceid = ] trace_id )

引数

[ @traceid = ] trace_id

トレースの ID で、整数値です。すべてのトレースに関する情報を返すには、このパラメータの既定値を指定します。それには、次のようにキーワード 'default' を使用する必要があります。

SELECT * FROM :: fn_trace_getinfo(default)

値 0 を明示的に指定すると、キーワード 'default' で呼び出した場合と同様に、すべてのトレースが返されます。ユーザーは、この trace_id 値を使用してトレースの識別、変更、および制御を行います。

戻りテーブル

trace_id を指定すると、fn_trace_getinfo は指定したトレースの情報を含むテーブルを返します。trace_id を指定しない場合、この関数は、すべてのアクティブなトレースの情報を返します。

解説

fn_trace_getinfo は、Microsoft® SQL Server™ 2000 の組み込み関数で、以前のバージョンの SQL Server で利用可能な拡張ストアド プロシージャによって実行されていた多くの操作を実行します。fn_trace_getinfo は次のプロシージャの代わりに使用します。

• xp_trace_getqueuecreateinfo
  
  
• xp_trace_getqueuedestination
  
  
• xp_trace_getqueueproperties

以前 xp_trace_getqueueproperties によって返されていた情報を取得するには、たとえば、次の形式でクエリを実行します。

SELECT *
FROM ::fn_trace_getinfo(trace_id)
WHERE Property=4

関連項目