SQL トレース (SQL Trace)

適用対象:SQL Server

SQL トレースでは、トレース定義に一覧表示されているイベント クラスのインスタンスであるイベントが収集されます。 このようなイベントは、フィルターによってトレースから除外したり、対象のキューに登録したりすることができます。 目的地はファイルまたは SQL Server 管理オブジェクト (SMO) にすることができ、SQL Server を管理するアプリケーションで情報をトレースすることができます。

重要

SQL トレースと SQL Server プロファイラー は、非推奨です。 Microsoft SQL Server の Trace や Replay オブジェクトを含む Microsoft.SqlServer.Management.Trace 名前空間も非推奨とされます。

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

代わりに拡張イベントを使用します。 拡張イベントについて詳しくは、「クイック スタート:SQL Server 拡張イベント」および SSMS XEvent Profiler に関するページをご覧ください。

SQL トレースの利点

Microsoft SQL Server は、SQL Server データベースエンジンのインスタンス上にトレースを作成するための Transact-SQL システムストアドプロシージャを提供しています。 これらのシステム ストアド プロシージャは、SQL Server Profiler を使用する代わりに、アプリケーションから手動でトレースを作成するために使用できます。 これにより、企業のニーズに合わせたカスタム アプリケーションを作成できます。

SQL トレース アーキテクチャ

イベント ソースには、Transact-SQLバッチやデッドロックなどのSQL Serverイベントなど、トレース イベントを生成するソースを指定できます。 イベントの詳細については、「 SQL Server イベント クラスの参照」を参照してください。 イベントの発生後、イベント クラスがトレース定義に含まれている場合は、トレースによってイベント情報が収集されます。 トレース定義に含まれているイベント クラスに対してフィルターが定義されている場合は、フィルターが適用され、トレース イベント情報がキューに渡されます。 キューに登録されたトレース情報は、ファイルに書き込まれるか、またはSQL Server Profilerなどのアプリケーションで SMO によって使用されます。 次の図は、トレース中に SQL トレースによってどのようにイベントが収集されるかを示しています。

Database Engine event tracing process

SQL トレースの用語

次の用語は SQL トレースの主要な概念を示したものです。

イベント
Microsoft SQL Server データベース エンジンのインスタンス内で発生するアクション。

データ列
イベントの属性。

イベント クラス
トレースできるイベントの種類。 イベント クラスには、イベントから報告できるすべてのデータ列が含まれています。

イベント カテゴリ
関連するイベント クラスのグループ。

トレース (名詞)
データベース エンジンによって返されるイベントやデータのコレクション。

トレース (動詞)
SQL Serverのインスタンス内のイベントを収集し監視する。

Tracedefinition
イベント クラス、データ列、およびトレース中に収集されるイベントの種類を識別するフィルターのコレクション。

Assert
トレースで収集されるイベントを限定する条件。

トレース ファイル
トレースの保存時に作成されるファイル。

[テンプレート]
SQL Server Profilerで、トレースで収集されるイベント クラスやデータ列を定義するファイル。

トレース テーブル
SQL Server Profilerで、トレースがテーブルに保存されるときに作成されるテーブル。

データ列による返されたイベントの説明

SQL トレースでは、トレース出力のデータ列を使用して、トレースの実行時に返されたイベントが説明されます。 次の表は、SQL Server Profiler のデータ列について説明したもので、SQL Trace で使用されるデータ列と同じものです。また、これは既定で選択されているデータ列を示しています。

データ列 Column number 説明
* ApplicationName 10 SQL Serverのインスタンスへの接続を作成したクライアント アプリケーションの名前。 この列には、プログラム名ではなくアプリケーションによって渡された値が格納されます。
BigintData1 52 トレースで指定されているイベント クラスに依存する値 (bigint データ型)。
BigintData2 53 トレースで指定されているイベント クラスに依存する値 (bigint データ型)。
* Binary Data 2 トレースにキャプチャされるイベント クラスに依存するバイナリ値。
* ClientProcessID 9 クライアント アプリケーションが実行されているプロセスに対し、ホスト コンピューターによって割り当てられた ID。 クライアントでクライアント プロセス ID が指定されると、このデータ列が作成されます。
ColumnPermissions 44 列権限が設定されていたかどうかを示します。 ステートメントのテキストを解析して、どの権限がどの列に適用されていたかを判断できます。
* CPU 18 イベントで使用された CPU 時間 (ミリ秒)。
データベース ID 3 USE database_name ステートメントで指定されたデータベースの ID、または特定のインスタンスについて USE database_nameステートメントが実行されていない場合は既定のデータベースの ID となります。 SQL Server Profiler では、 ServerName データ列がトレースにキャプチャされ、そのサーバーが利用可能な場合、データベースの名前が表示されます。 データベースに対応する値は、DB_ID 関数を使用して特定します。
DatabaseName 35 ユーザーのステートメントが実行されているデータベースの名前。
DBUserName 40 クライアントの SQL Server ユーザー名。
* 期間 13 イベントの期間 (ミリ秒)。

サーバーはマイクロ秒 (100 万分の 1 (10-6) 秒) 単位でのイベント期間、およびイベントにより使用されるミリ秒 (10-3秒) 単位での CPU 時間をレポートします。 SQL Server プロファイラー のグラフィカル ユーザー インターフェイスに、既定ではミリ秒単位で Duration 列が表示されますが、トレースがファイルまたはデータベース テーブルに保存されると、 Duration 列の値はマイクロ秒単位で記述されます。
* EndTime 15 イベントが終了した時刻。 SQL:BatchStartingSP:Startingなどのイベントの開始を示すイベント クラスには、このデータ列は作成されません。
エラー 31 特定のイベントのエラー番号。 これは多くの場合、 sysmessagesに格納されたエラー番号です。
* EventClass 27 キャプチャされるイベント クラスの種類。
EventSequence 51 このイベントのシーケンス番号。
EventSubClass 21 イベント サブクラスの種類。各イベント クラスに関するより詳細な情報を提供します。 たとえば、 Execution Warning イベント クラスのイベント サブクラス値は、以下のような実行の警告の種類を表します。

1 = クエリの待機。 クエリを実行するには、メモリなど、そのためのリソースが確保されるまで待機しなければなりません。

2 = クエリ タイムアウト。必要なリソースの実行を待っている間にクエリがタイムアウトした。 すべてのイベント クラスに対して、このデータ列が作成されるわけではありません。
GUID 54 トレースで指定されているイベント クラスに依存する GUID 値。
ファイル名 36 変更されるファイルの論理名。
Handle 33 サーバーとの間で実行を調整するときに ODBC、OLE DB、または DB-Library によって使用される整数。
HostName 8 クライアントが実行しているコンピューターの名前。 このデータ列には、クライアントがホスト名を指定している場合にデータが格納されます。 ホスト名を指定するには、 HOST_NAME 関数を使用します。
IndexID 24 イベントの影響を受けるオブジェクトに付けられたインデックス用の ID。 オブジェクトのインデックス ID を調べるには、 sysindexes システム テーブルの indid 列を使用します。
IntegerData 25 トレースにキャプチャされるイベント クラスに依存する整数値。
IntegerData2 55 トレースにキャプチャされるイベント クラスに依存する整数値。
IsSystem 60 システム プロセスまたはユーザー プロセスのどちらでイベントが発生したのかを示します。

1 = システム

0 = ユーザー
LineNumber 5 エラーを含む行の番号が格納されます。 SP:StmtStartingのように Transact-SQL ステートメントを含むイベントの場合、LineNumberにはストアド プロシージャまたはバッチ内のステートメントの行番号が含まれます。
LinkedServerName 45 リンク サーバーの名前
* LoginName 11 ユーザーのログイン名 (SQL Server セキュリティ ログインまたは DOMAIN\Username の形式の Windows ログイン資格情報)。
LoginSid 41 ログイン ユーザーのセキュリティ ID (SID)。 この情報は、 master データベースの sys.server_principals ビューで参照できます。 サーバーへの各ログインには一意の ID が付けられています。
MethodName 47 OLEDB メソッドの名前。
Mode 32 各種のイベントで要求している状態、または受け取った状態を説明するときに使用される整数。
NestLevel 29 @@NESTLEVEL から返されるデータを表す整数。
NTDomainName 7 ユーザーが所属する Microsoft Windows ドメイン。
* NTUserName 6 Windows のユーザー名。
Exchange Spill 22 オブジェクトに対してシステムが割り当てた ID。
ObjectID2 56 関連するオブジェクトまたはエンティティの ID (使用可能な場合)。
ObjectName 34 参照されているオブジェクトの名前。
**ObjectType 28 イベントに関係するオブジェクトの種類を表す値。 この値は sysobjectstype列に対応します。
Offset 61 ストアド プロシージャまたはバッチ内のステートメントの開始オフセット。
OwnerID 58 ロック イベントの場合にのみ該当します。 ロックを所有するオブジェクトの種類。
OwnerName 37 オブジェクト所有者のデータベース ユーザー名。
ParentName 59 オブジェクトが存在するスキーマ名。
アクセス許可 19 チェックされた権限の種類を表す整数値。 値は次のとおりです。

1 = SELECT ALL

2 = UPDATE ALL

4 = REFERENCES ALL

8 = INSERT

16 = DELETE

32 = EXECUTE (プロシージャのみ)

4096 = SELECT ANY (1 列以上)

8192 = UPDATE ANY

16384 = REFERENCES ANY
ProviderName 46 OLEDB プロバイダーの名前。
* Reads 16 論理ディスク上の読み取り操作の回数。この操作は、イベントの代わりにサーバーによって実行されます。 これらの読み取り操作には、ステートメントの実行中に行われるテーブルやバッファーからのすべての読み取り操作が含まれます。
RequestID 49 ステートメントを含んでいる要求の ID。
RoleName 38 有効になっているアプリケーション ロールの名前。
RowCounts 48 バッチ内の行数。
ServerName 26 トレースしている SQL Serverの インスタンスの名前。
SessionLoginName 64 セッションを開始したユーザーのログイン名。 たとえば、Login1 を使用して SQL Server に接続し、Login2 としてステートメントを実行した場合、SessionLoginName には Login1 が表示され、LoginName には Login2 が表示されます。 このデータ列には、SQL Server ログインと Windows ログインの両方が表示されます。
重大度 20 例外イベントの重大度レベル。
SourceDatabaseID 62 オブジェクトのソースが存在するデータベースの ID。
* SPID 12 SQL Serverによって割り当てられているサーバー プロセス ID (SPID)。この ID はクライアントに関連付けられています。
SqlHandle 63 64 ビット ハッシュ。アドホック クエリやデータベースのテキスト、および SQL オブジェクトのオブジェクト ID に基づいています。 この値を sys.dm_exec_sql_text() に渡して、関連付けられている SQL テキストを取得できます。
* StartTime 14 イベントの開始時刻 (取得できた場合)。
State 30 エラー状態コード。
成功 23 イベントが正常に終了したかどうかを表します。 次の値が含まれます。

1 = 成功。

0 = 失敗。

たとえば、 1 は、権限チェックの成功を表し、 0 は失敗を表します。
TargetLoginName 42 ログインを対象とする操作 (新規ログインの追加など) の場合の対象ログインの名前。
TargetLoginSid 43 ログインを対象とする操作 (新規ログインの追加など) の場合の対象ログインの SID。
TargetUserName 39 データベース ユーザーを対象とした操作 (ユーザーへの権限の許可など) を行う場合の対象となるユーザーの名前。
* TextData 1 トレースにキャプチャされるイベント クラスに依存するテキスト値。 ただし、パラメーター化クエリをトレースする場合は、変数は TextData 列のデータ値と共には表示されません。
トランザクション ID 4 トランザクションに対してシステムが割り当てた ID。
Type 57 トレースにキャプチャされるイベント クラスに依存する整数値。
* Writes 17 イベントの代わりにサーバーによって実行される物理ディスクの書き込み操作回数。
XactSequence 50 現在のトランザクションを記述するトークン。

*これらのデータ列は、既定ですべてのイベントについて作成されます。

**ObjectType データ列の詳細については、「 ObjectType トレース イベント列」を参照してください。

SQL トレースのタスク

タスクの説明 トピック
Transact-SQL ストアド プロシージャを使用してトレースを作成および実行する方法について説明します。 Transact-SQL ストアド プロシージャを使用したトレースの作成と実行
SQL Server データベースエンジンのインスタンスに対するストアド プロシージャを使用して手動トレースを作成する方法について説明します。 ストアド プロシージャを使用した手動トレースの作成
トレース結果が書き込まれるファイルにトレース結果を保存する方法について説明します。 トレース結果のファイルへの保存
temp ディレクトリの空き領域の使用によってトレース データへのアクセスを向上させる方法について説明します。 トレース データへのアクセスを向上させる
ストアド プロシージャを使用してトレースを作成する方法について説明します。 トレースの作成 (Transact-SQL)
ストアド プロシージャを使用して、トレース中のイベントに関して必要な情報のみを取得するフィルターを作成する方法について説明します。 トレース フィルターの設定 (Transact-SQL)
ストアド プロシージャを使用して既存のトレースを変更する方法について説明します。 既存のトレースの変更 (Transact-SQL)
組み込み関数を使用して、保存されているトレースを表示する方法について説明します。 保存されているトレースの表示 (Transact-SQL)
組み込み関数を使用してトレース フィルター情報を表示する方法について説明します。 フィルター情報の表示 (Transact-SQL)
ストアド プロシージャを使用してトレースを削除する方法について説明します。 トレースの削除 (Transact-SQL)
トレースによって発生するパフォーマンス コストを最小限に抑える方法について説明します。 SQL トレースの最適化
トレース中に発生するオーバーヘッドを最小限にするためにトレースをフィルター処理する方法について説明します。 トレースへのフィルターの適用
トレースで収集されるデータ量を最小限にする方法について説明します。 トレース ファイルとテーブル サイズの制限
Microsoft SQL Serverでトレースのスケジュールを設定するための 2 つの方法について説明します。 トレースのスケジュール設定

参照

SQL Server プロファイラーのテンプレートとアクセス許可
SQL Server 管理オブジェクト (SMO) プログラミング ガイド