次の方法で共有


sys.fn_trace_getinfo (Transact-SQL)

適用対象: SQL サーバー

指定したトレースまたはすべての既存のトレースに関する情報を返します。

重要

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

Transact-SQL 構文表記規則

構文

  
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )  

引数

trace_id
トレースの ID です。 trace_idint です。有効な入力は、トレース、NULL、0、または DEFAULT の ID 番号です。 NULL、0、DEFAULT は、このコンテキストで同等の値です。 SQL Server のインスタンス内のすべてのトレースの情報を返すには、NULL、0、または DEFAULT を指定します。

返されるテーブル

列名 データ型 説明
traceid int トレースの ID。
property int トレースのプロパティ。

1 = トレース オプション。 詳細については、「sp_trace_create (Transact-SQL)の@optionsを参照してください。

2 = ファイル名

3 = 最大サイズ

4 = 停止時刻。

5 = 現在のトレースの状態。 0 = 停止しました。 1 = 実行中。
sql_variant 指定されたトレースのプロパティに関する情報。

解説

特定のトレースの 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)