fn_trace_getinfo (Transact-SQL)

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

トピック リンク アイコンTransact-SQL 構文表記規則

構文

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

引数

  • trace_id
    トレースの ID を指定します。trace_id のデータ型は int です。有効な入力値は、トレースの ID 番号、NULL、0、または DEFAULT です。このコンテキストでは、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 = 実行中。

value

sql_variant

指定したトレースのプロパティに関する情報。

説明

特定のトレースの ID が渡された場合、fn_trace_getinfo ではそのトレースに関する情報が返されます。無効な ID が渡された場合、空の行セットが返されます。

fn_trace_getinfo を実行すると、結果セットに含まれるトレース ファイルの名前には .trc 拡張子が付けられます。トレースの定義の詳細については、「sp_trace_create (Transact-SQL)」を参照してください。トレース フィルタの同様の情報については、「fn_trace_getfilterinfo (Transact-SQL)」を参照してください。

トレース ストアド プロシージャを使用した完全な例については、「トレースを作成する方法 (Transact-SQL)」を参照してください。

権限

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

次の例では、すべてのアクティブなトレースに関する情報を返します。

SELECT * FROM sys.fn_trace_getinfo(0) ;
GO