適用対象:
SQL Server
指定したトレースまたはすべての既存のトレースに関する情報を返します。
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに拡張イベントを使用します。
構文
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )
引数
trace_id
トレースの ID です。
trace_id知力です。有効な入力は、トレースのID番号、NULL、0、またはDEFAULTです。 この文脈ではNULL、0、 DEFAULT は同等の値です。 SQL Serverのインスタンスですべてのトレースの情報を返すためにNULL、0、またはDEFAULTを指定する。
返されるテーブル
解説
特定のトレースの ID が渡された場合、fn_trace_getinfo ではそのトレースに関する情報が返されます。 無効な ID が渡された場合、空の行セットが返されます。
fn_trace_getinfo を実行すると、結果セットに含まれるトレース ファイルの名前には .trc 拡張子が付けられます。 トレースの定義については、「 sp_trace_create (Transact-SQL)」を参照してください。 トレース フィルターに関する同様の情報については、「 sys.fn_trace_getfilterinfo (Transact-SQL)」を参照してください。
トレース ストアド プロシージャの使用例については、「 トレースの作成 (Transact-SQL)」を参照してください。
アクセス許可
サーバーに対する ALTER TRACE 権限が必要です。
例
次の例では、すべてのアクティブなトレースに関する情報を返します。
SELECT * FROM sys.fn_trace_getinfo(0) ;
GO
参照
トレースの作成 (Transact-SQL)
sp_trace_create(Transact-SQL)
sp_trace_generateevent （Transact-SQL）
sp_trace_setevent(Transact-SQL)
sp_trace_setfilter(Transact-SQL)
sp_trace_setstatus （Transact-SQL）
sys.fn_trace_getfilterinfo(Transact-SQL)
sys.fn_trace_geteventinfo(Transact-SQL)
sys.fn_trace_gettable(Transact-SQL)