sp_trace_setevent (Transact-SQL)

適用対象:SQL Server (サポートされているすべてのバージョン)

トレースに対して、イベントまたはイベント列を追加または削除します。 sp_trace_setevent は、停止している既存のトレースでのみ実行できます (状態0)。 存在しないトレースまたは 状態0 でないトレースでこのストアド プロシージャが実行されると、エラーが返されます。

重要

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

Topic link iconTransact-SQL 構文表記規則

構文

  
sp_trace_setevent [ @traceid = ] trace_id   
          , [ @eventid = ] event_id  
          , [ @columnid = ] column_id  
          , [ @on = ] on  

引数

[ @traceid = ] trace_id 変更するトレースの ID です。 trace_idint で、既定値はありません。 ユーザーはこの trace_id 値を使用して、トレースを識別、変更、および制御します。

[ @eventid = ] event_id 有効にするイベントの ID です。 event_idint で、既定値はありません。

次の表は、トレースに対して追加または削除できるイベントの一覧です。

イベント番号 イベント名 説明
0-9 予約済み 予約済み
10 RPC:Completed リモート プロシージャ コール (RPC) が完了したときに発生します。
11 RPC:Starting RPC が開始したときに発生します。
12 SQL:BatchCompleted Transact-SQL バッチが完了したときに発生します。
13 SQL:BatchStarting Transact-SQL バッチが開始されたときに発生します。
14 Audit Login ユーザーが正常にSQL Serverにログインしたときに発生します。
15 Audit Logout ユーザーがSQL Serverからログアウトしたときに発生します。
16 Attention クライアント割り込み要求や切断されたクライアント接続などのアテンション イベントが発生したときに発生します。
17 ExistingConnection トレースが開始される前に、SQL Serverに接続されているユーザーによるすべてのアクティビティを検出します。
18 Audit Server Starts and Stops SQL Server サービスの状態が変更されたときに発生します。
19 DTCTransaction 2 つ以上のデータベース間で Microsoft 分散トランザクション コーディネーター (MS DTC) によって調整されたトランザクションを追跡します。
20 ログインの監査に失敗しました クライアントからのSQL Serverへのログイン試行が失敗したことを示します。
21 EventLog イベントが Windows アプリケーション ログに記録されたことを示します。
22 ErrorLog エラー イベントが SQL Server エラー ログに記録されたことを示します。
23 Lock:Released ページなどのリソースのロックが解除されたことを示します。
24 Lock:Acquired データ ページなどのリソースのロックが取得されたことを示します。
25 Lock:Deadlock 他のトランザクションが所有するリソースに対して互換性のないロックを取得しようとして、2 つの同時トランザクションが互いにデッドロックしたことを示します。
26 Lock:Cancel リソースに対するロックの取得が取り消されたことを示します (デッドロックが原因など)。
27 Lock:Timeout ページなどのリソースのロックが要求されたが、他のトランザクションによってそのリソースのブロッキング ロックが保持されているため、要求がタイムアウトになったことを示します。 タイムアウトは@@LOCK_TIMEOUT関数によって決定され、SET LOCK_TIMEOUT ステートメントで設定できます。
28 Degree of Parallelism Event (7.0 Insert) SELECT、INSERT、または UPDATE ステートメントが実行される前に発生します。
29-31 予約されています。 代わりにイベント 28 を使用してください。
32 予約済み 予約済み
33 例外 SQL Serverで例外が発生したことを示します。
34 SP:CacheMiss ストアド プロシージャがプロシージャ キャッシュに見つからない場合を示します。
35 SP:CacheInsert 項目がプロシージャ キャッシュに挿入されるタイミングを示します。
36 SP:CacheRemove プロシージャ キャッシュからアイテムが削除されたことを示します。
37 SP:再コンパイル ストアド プロシージャが再コンパイルされたことを示します。
38 SP:CacheHit ストアド プロシージャがプロシージャ キャッシュ内にあることを示します。
39 非推奨 非推奨
40 SQL:StmtStarting Transact-SQL ステートメントが開始されたときに発生します。
41 SQL:StmtCompleted Transact-SQL ステートメントが完了したときに発生します。
42 SP:Starting ストアド プロシージャがいつ開始されたかを示します。
43 SP:Completed ストアド プロシージャが完了したことを示します。
44 SP:StmtStarting ストアド プロシージャ内の Transact-SQL ステートメントの実行が開始されたことを示します。
45 SP:StmtCompleted ストアド プロシージャ内の Transact-SQL ステートメントの実行が完了したことを示します。
46 オブジェクト:作成済み CREATE INDEX、CREATE TABLE、CREATE DATABASE ステートメントなど、オブジェクトが作成されたことを示します。
47 Object:Deleted DROP INDEX や DROP TABLE などのステートメントで、オブジェクトが削除されたことを示します。
48 予約されています。
49 予約されています。
50 SQL トランザクション Transact-SQL BEGIN、COMMIT、SAVE、ROLLBACK TRANSACTION ステートメントを追跡します。
51 スキャン:開始 テーブル スキャンまたはインデックス スキャンが開始されたことを示します。
52 スキャン:停止 テーブル スキャンまたはインデックス スキャンが停止したことを示します。
53 CursorOpen ODBC、OLE DB、または DB ライブラリによって Transact-SQL ステートメントでカーソルを開くタイミングを示します。
54 TransactionLog トランザクションがいつトランザクション ログに書き込まれるかを追跡します。
55 ハッシュの警告 バッファー パーティション上で処理されていないハッシュ演算 (ハッシュ結合、ハッシュ集計、ハッシュ ユニオン、ハッシュ識別など) が代替プランに変更されたことを示します。 これは、再帰の深さ、データ スキュー、トレース フラグ、またはビットカウントが原因で発生する可能性があります。
56-57 予約されています。
58 Auto Stats インデックス統計の自動更新が実行されたことを示します。
59 Lock:Deadlock Chain デッドロックに至る各イベントに対して生成されます。
60 Lock:Escalation ページ ロックが TABLE ロックまたは HoBT ロックにエスカレートまたは変換された場合など、細かい単位のロックが大きな単位のロックに変換されたことを示します。
61 OLE DB Errors OLE DB エラーが発生したことを示します。
62-66 予約されています。
67 Execution Warnings SQL Server ステートメントまたはストアド プロシージャの実行中に発生した警告を示します。
68 Showplan Text (Unencoded) 実行された Transact-SQL ステートメントのプラン ツリーを表示します。
69 Sort Warnings メモリに収まらない並べ替え操作を示します。 インデックスの作成に関連する並べ替え操作は対象になりません。SELECT ステートメントで使用される ORDER BY 句など、クエリ内の並べ替え操作のみが対象になります。
70 CursorPrepare Transact-SQL ステートメント上のカーソルが、ODBC、OLE DB、または DB ライブラリで使用するために準備されるタイミングを示します。
71 Prepare SQL ODBC、OLE DB、またはDB-Libraryでは、使用する Transact-SQL ステートメントまたはステートメントが準備されています。
72 Exec Prepared SQL ODBC、OLE DB、またはDB-Libraryは、準備された Transact-SQL ステートメントまたはステートメントを実行しました。
73 SQL の準備を解除する ODBC、OLE DB、またはDB-Libraryに、準備済みの Transact-SQL ステートメントまたはステートメントが準備されていない (削除された) 場合。
74 CursorExecute ODBC、OLE DB、またはDB-Libraryによって Transact-SQL ステートメントに対して事前に準備されたカーソルが実行されます。
75 CursorRecompile ODBC またはDB-Libraryによって Transact-SQL ステートメントで開かれたカーソルが、直接またはスキーマの変更により再コンパイルされました。

ANSI カーソルと非 ANSI カーソルに対してトリガーされます。
76 CursorImplicitConversion Transact-SQL ステートメント上のカーソルは、ある型から別の型にSQL Serverによって変換されます。

ANSI カーソルと非 ANSI カーソルに対してトリガーされます。
77 CursorUnprepare Transact-SQL ステートメントの準備済みカーソルは、ODBC、OLE DB、または DB ライブラリによって準備されていません (削除)。
78 CursorClose ODBC、OLE DB、またはDB-Libraryによって Transact-SQL ステートメントで以前に開いたカーソルが閉じられます。
79 列の統計が見つからない オプティマイザーに有効な列の統計が利用できません。
80 Missing Join Predicate 結合述語を持たないクエリが実行されています。 クエリの終了に時間がかかる可能性があります。
81 Server Memory Change SQL Serverメモリ使用量が、最大サーバー メモリの 1 MB または最大サーバー メモリの 5% のいずれか大きい方で増減しました。
82-91 ユーザー構成可能 (0 から 9) ユーザーによって定義されたイベント データ。
92 データ ファイルの自動拡張 データ ファイルがサーバーによって自動的に拡張されたことを示します。
93 Log File Auto Grow ログ ファイルがサーバーによって自動的に拡張されたことを示します。
94 Data File Auto Shrink データ ファイルがサーバーによって自動的に圧縮されたことを示します。
95 ログ ファイルの自動圧縮 ログ ファイルがサーバーによって自動的に圧縮されたことを示します。
96 Showplan Text クエリ オプティマイザーの SQL ステートメントのクエリ プラン ツリーを表示します。 TextData 列には、このイベントのプラン表示が含まれていないことに注意してください。
97 Showplan All 実行された SQL ステートメントのコンパイル時の完全な詳細を含むクエリ プランを表示します。 TextData 列には、このイベントのプラン表示が含まれていないことに注意してください。
98 Showplan Statistics Profile 実行された SQL ステートメントの完全な実行時の詳細を含むクエリ プランを表示します。 TextData 列には、このイベントのプラン表示が含まれていないことに注意してください。
99 予約されています。
100 RPC Output Parameter 各 RPC に対して、パラメーターの出力値を生成します。
101 予約されています。
102 データベース スコープ GDR の監査 データベースに対するアクセス許可の付与など、データベースのみのアクションに対して、SQL Serverのすべてのユーザーがステートメントアクセス許可の GRANT、DENY、REVOKE を発行するたびに発生します。
103 Audit Object GDR イベント オブジェクト権限の GRANT、DENY、REVOKE がSQL Serverのすべてのユーザーによって発行されるたびに発生します。
104 AddLogin イベントの監査 SQL Server ログインが追加または削除されたときに発生します。sp_addloginsp_droplogin
105 Audit Login GDR Event Windows ログイン権限が追加または削除されたときに発生します。 sp_grantloginsp_revokeloginおよびsp_denylogin
106 Audit Login Change Property Event パスワードを除くログインのプロパティが変更されたときに発生します。 sp_defaultdbsp_defaultlanguage
107 ログイン変更パスワード イベントの監査 SQL Server ログイン パスワードが変更されたときに発生します。

パスワードは記録されません。
108 Audit Add Login to Server Role Event 固定サーバー ロールにログインが追加または削除されたときに発生します。 sp_addsrvrolememberおよびsp_dropsrvrolemember
109 Audit Add DB User Event sp_grantdbaccess、sp_revokedbaccess、sp_adduser、およびsp_dropuserの場合に、データベース ユーザー (Windows またはSQL Server) としてデータベースにログインが追加または削除されたときに発生します。
110 監査 : DB ロールへのメンバーの追加イベント ログインがデータベース ユーザー (固定またはユーザー定義) としてデータベースに追加または削除されたときに発生します。 sp_addrolemembersp_droprolememberおよびsp_changegroup
111 ロールの追加イベントの監査 ログインがデータベース ユーザーとしてデータベースに追加または削除されたときに発生します。 sp_addrolesp_droprole
112 Audit App Role Change Password Event アプリケーション ロールのパスワードが変更されたときに発生します。
113 Audit Statement Permission Event CREATE TABLE などのステートメント権限が使用されたときに発生します。
114 Audit Schema Object Access Event SELECT などのオブジェクト権限が使用されたときに、それが成功したかどうかに関係なく発生します。
115 バックアップ/復元イベントの監査 BACKUP または RESTORE コマンドが実行されたときに発生します。
116 Audit DBCC Event DBCC コマンドが発行されたときに発生します。
117 Audit Change Audit Event 監査トレースが変更されたときに発生します。
118 Audit Object Derived Permission Event CREATE、ALTER、DROP オブジェクトのコマンドが発行されたときに発生します。
119 OLEDB 呼び出しイベント 分散クエリとリモート ストアド プロシージャに対して、OLE DB プロバイダー呼び出しが行われたときに発生します。
120 OLEDB QueryInterface Event 分散クエリとリモート ストアド プロシージャに対して OLE DB QueryInterface 呼び出しが行われるときに発生します。
121 OLEDB DataRead Event OLE DB プロバイダーに対して、データ要求の呼び出しが行われたときに発生します。
122 Showplan XML SQL ステートメントの実行時に発生します。 プラン表示演算子を識別するには、このイベントを含めます。 各イベントは、整形式の XML ドキュメントに格納されます。 このイベントの バイナリ 列には、エンコードされたプラン表示が含まれていることに注意してください。 SQL Server Profilerを使用してトレースを開き、プラン表示を表示します。
123 SQL:FullTextQuery フルテキスト クエリが実行されたときに発生します。
124 Broker:Conversation Service Broker の会話の進行状況を報告します。
125 非推奨のお知らせ 将来のバージョンのSQL Serverから削除される機能を使用すると発生します。
126 Deprecation Final Support SQL Serverの次のメジャー リリースから削除される機能を使用すると発生します。
127 Exchange Spill イベント 並列クエリ プランの通信バッファーが tempdb データベースに一時的に書き込まれたときに発生します。
128 Audit Database Management イベント データベースが作成、変更、または削除されたときに発生します。
129 Audit Database Object Management イベント スキーマなどのデータベース オブジェクトに対して CREATE、ALTER、DROP ステートメントが実行されるときに発生します。
130 Audit Database Principal Management Event ユーザーなどのプリンシパルがデータベースから作成、変更、または削除されたときに発生します。
131 Audit Schema Object Management イベント サーバー オブジェクトが作成、変更、または削除されたときに発生します。
132 Audit Server Principal Impersonation Event サーバー スコープ内で、EXECUTE AS LOGIN などの権限借用があるときに発生します。
133 Audit Database Principal Impersonation Event EXECUTE AS USER や SETUSER など、データベース スコープ内で偽装が発生したときに発生します。
134 Audit Server Object Take Ownership イベント サーバー スコープ内のオブジェクトの所有者が変更されたときに発生します。
135 Audit Database Object Take Ownership イベント データベース スコープ内のオブジェクトの所有者の変更が発生したときに発生します。
136 Broker:Conversation Group Service Broker が新しい会話グループを作成するか、既存の会話グループを削除したときに発生します。
137 Blocked Process Report 指定した時間を超える時間、プロセスがブロックされた場合に発生します。 システム プロセスや、デッドロックを検出できないリソースで待機しているプロセスはこの対象外です。 sp_configureを使用して、レポートが生成されるしきい値と頻度を構成します。
138 Broker:Connection Service Broker によって管理されるトランスポート接続の状態を報告します。
139 Broker:Forwarded Message Sent Service Broker がメッセージを転送するときに発生します。
140 Broker:Forwarded Message Dropped Service Broker が転送対象のメッセージを削除したときに発生します。
141 Broker:Message Classify Service Broker がメッセージのルーティングを決定したときに発生します。
142 Broker:Transmission Service Broker トランスポート層でエラーが発生したことを示します。 エラー番号と状態の値で、エラーの原因を確認できます。
143 Broker:Queue Disabled Service Broker キューに 5 回連続してトランザクションロールバックが発生したため、有害メッセージが検出されたことを示します。 イベントには、有害メッセージを含むキューのデータベース ID とキュー ID が含まれます。
144-145 予約されています。
146 Showplan XML Statistics Profile SQL ステートメントの実行時に発生します。 プラン表示演算子を識別し、コンパイル時の完全なデータを表示します。 このイベントの バイナリ 列には、エンコードされたプラン表示が含まれていることに注意してください。 SQL Server Profilerを使用してトレースを開き、プラン表示を表示します。
148 Deadlock Graph ロックの取得試行がデッドロックの一部であり、デッドロックの対象として選択されたために取り消されたときに発生します。 デッドロックについての XML の説明が提供されます。
149 Broker:Remote Message Acknowledgement Service Broker がメッセージの受信確認を送受信するときに発生します。
150 トレース ファイルを閉じる トレース ファイルのロールオーバー中にトレース ファイルが閉じるときに発生します。
151 予約されています。
152 Audit Change Database Owner ALTER AUTHORIZATION を使用してデータベースの所有者を変更し、アクセス許可を確認したときに発生します。
153 Audit Schema Object Take Ownership イベント ALTER AUTHORIZATION を使用してオブジェクトに所有者を割り当て、それを行うためのアクセス許可がチェックされるときに発生します。
154 予約されています。
155 FT:クロールの開始 フルテキストのクロール (カタログ作成) が開始したときに発生します。 クロール要求がワーカー タスクによって取得されているかどうかを確認するために使用します。
156 FT:Crawl Stopped フルテキストのクロール (カタログ作成) が停止したときに発生します。 クロールが正常に完了したとき、または致命的なエラーが発生したときに停止が発生します。
157 FT:Crawl Aborted フルテキスト クロール中に例外が発生したときに発生します。 通常、これによってフルテキストのクロールは停止します。
158 Audit Broker Conversation Service Broker ダイアログ セキュリティに関する監査メッセージを報告します。
159 Audit Broker Login Service Broker トランスポート セキュリティに関する監査メッセージを報告します。
160 Broker:Message Undeliverable Service Broker が、サービスに配信する必要がある受信メッセージを保持できない場合に発生します。
161 Broker:Corrupted Message Service Broker が破損したメッセージを受信したときに発生します。
162 User Error Message エラーや例外が発生したときにユーザーに表示されるエラー メッセージを表示します。
163 Broker:Activation キュー モニターによって、アクティブ化ストアド プロシージャの開始や QUEUE_ACTIVATION 通知の送信が行われたときに発生します。またはキュー モニターが終了してアクティブ化ストアド プロシージャが開始したときに発生します。
164 Object:Altered データベース オブジェクトが変更されたときに発生します。
165 Performance statistics コンパイルされたクエリ プランが初めてキャッシュされた場合、再コンパイルされたとき、またはプラン キャッシュから削除されたときに発生します。
166 SQL:StmtRecompile ステートメント レベルの再コンパイルが発生したときに発生します。
167 データベース ミラーリングの状態の変更 ミラー化データベースの状態が変更されたときに発生します。
168 Showplan XML For Query Compile SQL ステートメントがコンパイルされるときに発生します。 コンパイル時の完全なデータを表示します。 このイベントの バイナリ 列には、エンコードされたプラン表示が含まれていることに注意してください。 SQL Server Profilerを使用してトレースを開き、プラン表示を表示します。
169 Showplan All For Query Compile SQL ステートメントがコンパイルされるときに発生します。 完全なコンパイル時データを表示します。 プラン表示演算子を識別するために使用します。
170 監査サーバー スコープ GDR イベント ログインの作成など、サーバー スコープ内のアクセス許可の許可、拒否、または取り消しイベントが発生したことを示します。
171 Audit Server Object GDR イベント テーブルや関数などのスキーマ オブジェクトの許可、拒否、または取り消しイベントが発生したことを示します。
172 Audit Database Object GDR Event アセンブリやスキーマなどのデータベース オブジェクトに対して、付与、拒否、または取り消しのイベントが発生したことを示します。
173 サーバー操作イベントの監査 設定、リソース、外部アクセス、承認の変更などのセキュリティ監査操作が使用されるときに発生します。
175 監査サーバーの変更トレース イベント ステートメントが ALTER TRACE 権限をチェックするときに発生します。
176 Audit Server Object Management イベント サーバー オブジェクトが作成、変更、または削除されたときに発生します。
177 サーバー プリンシパル管理イベントの監査 サーバー プリンシパルが作成、変更、または削除されたときに発生します。
178 データベース操作の監査イベント チェックポイントやクエリ通知のサブスクライブなど、データベース操作が行われたときに発生します。
180 Audit Database Object Access Event スキーマなどのデータベース オブジェクトにアクセスするときに発生します。
181 TM: Begin Tran starting BEGIN TRANSACTION 要求が開始されたときに発生します。
182 TM: Begin Tran completed BEGIN TRANSACTION 要求が完了したときに発生します。
183 TM: Tran の開始を昇格させる PROMOTE TRANSACTION 要求が開始されたときに発生します。
184 TM: Tran の昇格が完了しました PROMOTE TRANSACTION 要求が完了したときに発生します。
185 TM: Commit Tran starting COMMIT TRANSACTION 要求の開始時に発生します。
186 TM: Commit Tran completed COMMIT TRANSACTION 要求が完了したときに発生します。
187 TM: Rollback Tran starting ROLLBACK TRANSACTION 要求が開始されたときに発生します。
188 TM: Tran のロールバックが完了しました ROLLBACK TRANSACTION 要求が完了したときに発生します。
189 Lock:Timeout (timeout > 0) ページなどのリソースに対するロックの要求がタイムアウトしたときに発生します。
190 進行状況レポート: オンライン インデックス操作 ビルド プロセスの実行中のオンライン インデックス ビルド操作の進行状況を報告します。
191 TM: Save Tran starting SAVE TRANSACTION 要求が開始されたときに発生します。
192 TM: Save Tran completed SAVE TRANSACTION 要求が完了したときに発生します。
193 バックグラウンド ジョブ エラー バックグラウンド ジョブが異常終了したときに発生します。
194 OLEDB Provider Information 分散クエリが実行され、プロバイダー接続に対応する情報が収集されるときに発生します。
195 Mount Tape テープ マウント要求を受け取ったときに発生します。
196 Assembly Load CLR アセンブリを読み込む要求が発生したときに発生します。
197 予約されています。
198 XQuery Static Type XQuery 式が実行されるときに発生します。 このイベント クラスでは静的な XQuery 式が提供されます。
199 QN: サブスクリプション クエリ登録をサブスクライブできない場合に発生します。 TextData 列には、イベントに関する情報が含まれています。
200 QN: パラメーター テーブル アクティブなサブスクリプションに関する情報は、内部パラメーター テーブルに格納されます。 このイベント クラスは、パラメーター テーブルが作成または削除されたときに発生します。 通常これらのテーブルは、データベースを再起動したときに作成または削除されます。 TextData 列には、イベントに関する情報が含まれています。
201 QN: template クエリ テンプレートによって、サブスクリプション クエリのクラスが表されます。 通常、同じクラスにあるクエリは、パラメーター値を除いてすべて同じになります。 このイベント クラスは、新しいサブスクリプション要求が、既存のクラス (一致したクラス)、新しいクラス (作成)、または削除するクラスに分類されたときに発生します。これは、アクティブなサブスクリプションが含まれていないクエリ クラスのテンプレートをクリーンアップすることを示します。 TextData 列には、イベントに関する情報が含まれています。
202 QN: dynamics クエリ通知の内部アクティビティを追跡します。 TextData 列には、イベントに関する情報が含まれています。
212 ビットマップの警告 クエリでビットマップ フィルターが無効になっているタイミングを示します。
213 Database Suspect Data Page msdbsuspect_pages テーブルにページが追加されるタイミングを示します。
214 CPU Threshold Exceeded クエリが CPU しきい値 (REQUEST_MAX_CPU_TIME_SEC) を超えた場合にResource Governorが検出されたことを示します。
215 PreConnect:Starting LOGON トリガーまたはResource Governor分類子関数が実行を開始するタイミングを示します。
216 PreConnect:Completed LOGON トリガーまたはResource Governor分類子関数が実行を完了するタイミングを示します。
217 Plan Guide Successful SQL Server でプラン ガイドを含むクエリまたはバッチの実行プランが正常に生成されたことを示します。
218 Plan Guide Unsuccessful SQL Server でプラン ガイドを含むクエリまたはバッチの実行プランを生成できなかったことを示します。 SQL Serverプラン ガイドを適用せずに、このクエリまたはバッチの実行プランを生成しようとしました。 無効なプラン ガイドがこの問題の原因である可能性があります。 プラン ガイドは、sys.fn_validate_plan_guide システム関数を使用して検証できます。
235 Audit Fulltext

[ @columnid = ] column_id イベントに追加する列の ID です。 column_idint で、既定値はありません。

次の表に、イベントに追加できる列を示します。

列番号 列名 説明
1 TextData トレースでキャプチャされるイベント クラスに依存するテキスト値。
2 BinaryData トレースでキャプチャされたイベント クラスに依存するバイナリ値。
3 DatabaseID USE データベース ステートメントで指定されたデータベースの ID、または特定の接続に対して USE データベース ステートメントが発行されていない場合は既定 のデータベース

データベースの値は、DB_ID関数を使用して決定できます。
4 TransactionID システムによって割り当てられたトランザクション ID。
5 LineNumber エラーを含む行の番号が格納されます。 SP:StmtStarting などの Transact-SQL ステートメントを含むイベントの場合、LineNumber にはストアド プロシージャまたはバッチ内のステートメントの行番号が含まれます。
6 NTUserName Microsoft Windows ユーザー名。
7 NTDomainName ユーザーが所属する Windows ドメイン。
8 HostName 要求を生成したクライアント コンピューターの名前。
9 ClientProcessID クライアント アプリケーションが実行されているプロセスにクライアント コンピューターによって割り当てられた ID。
10 ApplicationName SQL Serverのインスタンスへの接続を作成したクライアント アプリケーションの名前。 この列には、プログラムの表示名ではなく、アプリケーションによって渡された値が格納されます。
11 LoginName クライアントのログイン名をSQL Serverします。
12 SPID クライアントに関連付けられているプロセスにSQL Serverによって割り当てられたサーバー プロセス ID。
13 Duration イベントによって取得された経過時間 (マイクロ秒単位)。 このデータ列は、ハッシュ警告イベントによって設定されません。
14 StartTime イベントの開始時刻 (取得できた場合)。
15 EndTime イベントの終了時刻。 SQL:BatchStartingSP:Startingなどの開始イベント クラスについては、この列に値が格納されません。 ハッシュ 警告 イベントによっても設定されません。
16 Reads イベントの代わりにサーバーによって実行される、論理ディスク読み取り回数。 この列は 、Lock:Released イベントによって設定されません。
17 Writes イベントの代わりにサーバーによって実行される、物理ディスクの書き込み回数。
18 CPU イベントに使用された CPU 時間 (ミリ秒単位)。
19 アクセス許可 アクセス許可のビットマップを表します。セキュリティ監査で使用されます。
20 Severity 例外の重要度レベルです。
21 EventSubClass イベント サブクラスの種類。 すべてのイベント クラスに対して、このデータ列が作成されるわけではありません。
22 Exchange Spill システムによって割り当てられたオブジェクト ID。
23 Success アクセス許可の使用試行の成功。監査に使用されます。

1 = 成功0 = 失敗
24 IndexID イベントの影響を受けるオブジェクトに付けられたインデックス用の ID。 オブジェクトのインデックス ID を調べるには、 sysindexes システム テーブルの indid 列を使用します。
25 IntegerData トレースでキャプチャされたイベント クラスに依存する整数値。
26 ServerName トレースされるSQL Serverのインスタンスの名前 (サーバー名または servername\instancename)。
27 EventClass 記録されるイベント クラスの種類。
28 ObjectType オブジェクトの型 (テーブル、関数、ストアド プロシージャなど)。
29 NestLevel このストアド プロシージャが実行されている入れ子レベル。 「@@NESTLEVEL (Transact-SQL)」を参照してください。
30 State エラーが発生した場合のサーバーの状態。
31 Error エラー番号。
32 モード 取得したロックのロック モード。 この列は、 Lock:Released イベントによって設定されません。
33 Handle イベントで参照されているオブジェクトのハンドル。
34 ObjectName アクセスされるオブジェクトの名前。
35 DatabaseName USE データベース ステートメントで指定された データベース の名前。
36 FileName 変更されたファイル名の論理名。
37 OwnerName 参照先オブジェクトの所有者名。
38 RoleName ステートメントの対象となっているデータベースまたはサーバー全体のロールの名前。
39 TargetUserName アクションのターゲットのユーザー名。
40 DBUserName クライアントのデータベース ユーザー名をSQL Serverします。
41 LoginSid ログインしたユーザーのセキュリティ識別子 (SID)。
42 TargetLoginName アクションの対象となるログイン名。
43 TargetLoginSid アクションの対象となるログインの SID。
44 ColumnPermissions 列レベルのアクセス許可の状態。セキュリティ監査で使用されます。
45 LinkedServerName リンク サーバーの名前
46 ProviderName OLE DB プロバイダーの名前です。
47 MethodName OLE DB メソッドの名前。
48 RowCounts バッチに含まれる行数。
49 RequestID ステートメントが含まれている要求の ID。
50 XactSequence 現在のトランザクションを記述するトークン。
51 EventSequence このイベントのシーケンス番号。
52 BigintData1 bigint 値。これはトレースでキャプチャされたイベント クラスに依存します。
53 BigintData2 bigint 値。これはトレースでキャプチャされたイベント クラスに依存します。
54 GUID トレースでキャプチャされたイベント クラスに依存する GUID 値。
55 IntegerData2 トレースでキャプチャされたイベント クラスに依存する整数値。
56 ObjectID2 関連するオブジェクトまたはエンティティの ID (使用可能な場合)。
57 Type トレースでキャプチャされたイベント クラスに依存する整数値。
58 OwnerID ロックを所有するオブジェクトの型。 ロック イベントの場合にのみ該当します。
59 ParentName オブジェクトが存在するスキーマの名前。
60 IsSystem イベントがシステム プロセスとユーザー プロセスのどちらで発生したか。

1 = システム

0 = ユーザー。
61 Offset ストアド プロシージャ内またはバッチ内のステートメントの開始オフセット。
62 SourceDatabaseID オブジェクトのソースが存在するデータベースの ID。
63 SqlHandle 64 ビット ハッシュ。アドホック クエリやデータベースのテキスト、および SQL オブジェクトのオブジェクト ID に基づいています。 この値を sys.dm_exec_sql_text() に渡して、関連付けられている SQL テキストを取得できます。
64 SessionLoginName セッションを開始したユーザーのログイン名。 たとえば、 SQL Server に Login1 を使用して接続し、 Login2としてステートメントを実行した場合、 SessionLoginName には Login1が表示され、 LoginName には Login2が表示されます。 このデータ列には、 SQL Server ログインと Windows ログインの両方が表示されます。

[ @on=]on
このイベントを ON (1) にするか OFF (0) にするかを指定します。 onビットであり、既定値はありません。

on1 に設定され、column_idが NULL の場合、イベントは ON に設定され、すべての列がクリアされます。 column_idが null でない場合、そのイベントの列は ON に設定されます。

on0 に設定され、column_idが NULL の場合、イベントはオフになり、すべての列がクリアされます。 column_idが null でない場合、列はオフになります。

次の表は、 @on@columnidの間の相互作用を示しています。

@on @columnid 結果
ON (1) NULL イベントは ON になります。

すべての列がクリアされます。
NOT NULL 指定したイベントに対して列がオンになります。
OFF (0) NULL イベントがオフになっています。

すべての列がクリアされます。
NOT NULL 指定されたイベントに対して列は OFF になります。

リターン コードの値

次の表は、このストアド プロシージャの完了時に返されるコード値を示しています。

リターン コード 説明
0 エラーなし。
1 不明なエラー。
2 トレースは現在実行中です。 この時点でトレースを変更すると、エラーが発生します。
3 指定されたイベントが無効です。 イベントが存在しないか、ストア プロシージャに適していない可能性があります。
4 指定した列は無効です。
9 指定されたトレース ハンドルが無効です。
11 指定した列は内部的に使用され、削除できません。
13 メモリが不足しています。 指定したアクションを実行するのに十分なメモリがない場合に返されます。
16 このトレースでは、この関数は無効です。

注釈

sp_trace_seteventは、以前のバージョンのSQL Serverで使用できる拡張ストアド プロシージャによって以前に実行されたアクションの多くを実行します。 次の代わりに sp_trace_setevent を使用します。

  • xp_trace_addnewqueue

  • xp_trace_eventclassrequired

  • xp_trace_seteventclassrequired

ユーザーは、イベントごとに追加された列ごとに sp_trace_setevent を実行する必要があります。 各実行中に 、@on1 に設定されている場合、指定したイベント sp_trace_setevent トレースのイベントの一覧に追加されます。 @on0 に設定されている場合、sp_trace_seteventは指定したイベントをリストから削除します。

すべての SQL トレース ストアド プロシージャ (sp_trace_xx) のパラメーターは厳密に型指定されます。 これらのパラメーターを、引数の説明で指定されている正しいデータ型で指定しないと、このストアド プロシージャではエラーが返されます。

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

アクセス許可

ユーザーは ALTER TRACE 権限を持っている必要があります。

参照

sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_getinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
SQL Server イベント クラスの参照
SQL トレース (SQL Trace)