sys.fn_trace_getfilterinfo (Transact-SQL)

適用対象:SQL Server

指定したトレースに適用されたフィルターに関する情報を返します。

重要

この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに拡張イベントを使用します。

Transact-SQL 構文表記規則

構文

  
fn_trace_getfilterinfo ( trace_id )  

引数

trace_id
トレースの ID です。 trace_idは int で、既定値はありません。

返されるテーブル

次の情報を返します。 列の詳細については、「sp_trace_setfilter (Transact-SQL)」を参照してください。

列名	データ型	説明
columnid	int	フィルターが適用される列の ID。
logical_operator	int	AND 演算子と OR 演算子のどちらを適用するかを指定します。
comparison_operator	int	比較の種類を指定します。 0 = 等しい 1 = 等しくない 2 = より大きい 3 = より小さい 4 = 以上 5 = 以下 6 = 一致 7 = 一致しない
value	sql_variant	フィルターを適用するときに使用する値を示します。

解説

ユーザーは、トレースtrace_id識別、変更、および制御する値を設定します。 特定のトレースの ID を渡すと、 fn_trace_getfilterinfo はそのトレースのフィルターに関する情報を返します。 指定されたトレースにフィルターがない場合、空の行セットが返されます。 無効な ID が渡された場合、空の行セットが返されます。 トレースに関する同様の情報については、「sys.fn_trace_getinfo (Transact-SQL)」を参照してください。

アクセス許可

サーバーに対する ALTER TRACE 権限が必要です。

例

次の例では、トレース番号 2 のすべてのフィルターに関する情報を返します。

SELECT * FROM fn_trace_getfilterinfo(2) ;  
GO  
  

参照

トレースの作成 (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_generateevent （Transact-SQL）
sp_trace_setevent (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_getinfo (Transact-SQL)
sys.fn_trace_gettable (Transact-SQL)