次の方法で共有

sp_trace_setevent (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server

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

重要

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

Transact-SQL 構文表記規則

構文

sp_trace_setevent
    [ @traceid = ] traceid
    , [ @eventid = ] eventid
    , [ @columnid = ] columnid
    , [ @on = ] on
[ ; ]

引数

[ @traceid = ] traceid

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

[ @eventid = ] eventid

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

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

イベント番号 イベント名 説明
0 ～ 9 Reserved 予約済み
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 Audit Login Failed クライアントから 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 SELECT、INSERT、または UPDATE ステートメントが実行される前に発生します。
29 ～ 31 Reserved 代わりにイベント 28 を使用してください。
32 Reserved 予約済み
33 Exception SQL Server で例外が発生したことを示します。
34 SP:CacheMiss ストアド プロシージャがプロシージャ キャッシュに見つからない場合を示します。
35 SP:CacheInsert 項目がプロシージャ キャッシュに挿入されるタイミングを示します。
36 SP:CacheRemove プロシージャ キャッシュからアイテムが削除されたことを示します。
37 SP:Recompile ストアド プロシージャが再コンパイルされたことを示します。
38 SP:CacheHit ストアド プロシージャがプロシージャ キャッシュ内にあることを示します。
39 Deprecated 非推奨
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 Object:Created CREATE INDEX、CREATE TABLE、CREATE DATABASE ステートメントなど、オブジェクトが作成されたことを示します。
47 Object:Deleted DROP INDEX や DROP TABLE などのステートメントで、オブジェクトが削除されたことを示します。
48 Reserved
49 Reserved
50 SQL Transaction Transact-SQL BEGIN、COMMIT、SAVE、ROLLBACK TRANSACTION ステートメントを追跡します。
51 Scan:Started テーブル スキャンまたはインデックス スキャンが開始されたことを示します。
52 Scan:Stopped テーブル スキャンまたはインデックス スキャンが停止したことを示します。
53 CursorOpen ODBC、OLE DB、または DB-Library によって Transact-SQL ステートメントでカーソルが開かれるタイミングを示します。
54 TransactionLog トランザクションがいつトランザクション ログに書き込まれるかを追跡します。
55 Hash Warning バッファー パーティションで処理されていないハッシュ操作 (ハッシュ結合、ハッシュ集計、ハッシュ共用体、ハッシュ個別など) が代替プランに戻されたことを示します。 これは、再帰の深さ、データ スキュー、トレース フラグ、またはビットカウントが原因で発生する可能性があります。
56 ～ 57 Reserved
58 Auto Stats インデックス統計の自動更新が実行されたことを示します。
59 Lock:Deadlock Chain デッドロックに至るまでの各イベントに対して生成されます。
60 Lock:Escalation ページ ロックが TABLE ロックまたは HoBT ロックにエスカレートまたは変換された場合など、細かい単位のロックが大きな単位のロックに変換されたことを示します。
61 OLE DB Errors OLE DB エラーが発生したことを示します。
62 ～ 66 Reserved
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-Library で使用するために準備されるタイミングを示します。
71 Prepare SQL ODBC、OLE DB、または DB-Library では、Transact-SQL ステートメントまたは使用するステートメントを準備しました。
72 Exec Prepared SQL ODBC、OLE DB、または DB-Library で、準備された Transact-SQL ステートメントまたはステートメントが実行されました。
73 Unprepare SQL ODBC、OLE DB、または DB-Library には、準備済みの Transact-SQL ステートメントまたはステートメントが準備されていません (削除済み)。
74 CursorExecute ODBC、OLE DB、または DB ライブラリによって Transact-SQL ステートメントに対して以前に準備されたカーソルが実行されます。
75 CursorRecompile ODBC または DB-Library によって Transact-SQL ステートメントで開かれたカーソルが、直接またはスキーマの変更により再コンパイルされました。

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

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

パスワードは記録されません。
108 Audit Add Login to Server Role Event ログインが固定サーバー ロールに追加または削除されたときに発生します。 sp_addsrvrolemember、および sp_dropsrvrolemember。
109 Audit Add DB User Event ログインがデータベース ユーザー (Windows または SQL Server) としてデータベースに追加または削除されたときに発生します。 sp_grantdbaccess、 sp_revokedbaccess、 sp_adduser、および sp_dropuser。
110 Audit Add Member to DB Role Event ログインがデータベース ユーザー (固定またはユーザー定義) としてデータベースに追加または削除されたときに発生します。 sp_addrolemember、 sp_droprolemember、および sp_changegroup。
111 Audit Add Role Event ログインがデータベース ユーザーとしてデータベースに追加または削除されたときに発生します。 sp_addrole と sp_droprole。
112 Audit App Role Change Password Event アプリケーション ロールのパスワードが変更されたときに発生します。
113 Audit Statement Permission Event CREATE TABLE などのステートメント権限が使用されたときに発生します。
114 Audit Schema Object Access Event SELECT などのオブジェクト権限が使用されたときに、それが成功したかどうかに関係なく発生します。
115 Audit Backup/Restore Event BACKUP または RESTORE コマンドが実行されたときに発生します。
116 Audit DBCC Event DBCC コマンドが発行されたときに発生します。
117 Audit Change Audit Event 監査トレースが変更されたときに発生します。
118 Audit Object Derived Permission Event CREATE、ALTER、DROP オブジェクトのコマンドが発行されたときに発生します。
119 OLEDB Call Event 分散クエリとリモート ストアド プロシージャに対して、OLE DB プロバイダー呼び出しが行われたときに発生します。
120 OLEDB QueryInterface Event 分散クエリとリモート ストアド プロシージャに対して OLE DB QueryInterface 呼び出しが行われるときに発生します。
121 OLEDB DataRead Event OLE DB プロバイダーに対して、データ要求の呼び出しが行われたときに発生します。
122 Showplan XML SQL ステートメントの実行時に発生します。 プラン表示演算子を識別するには、このイベントを含めます。 各イベントは、整形式の XML ドキュメントに格納されます。 このイベントの Binary 列には、エンコードされた Showplan が含まれています。 SQL Server プロファイラーを使用してトレースを開き、プラン表示を表示します。
123 SQL:FullTextQuery フルテキスト クエリが実行されたときに発生します。
124 Broker:Conversation Service Broker の会話の進行状況を報告します。
125 Deprecation Announcement 将来のバージョンの SQL Server から削除される機能を使用すると発生します。
126 Deprecation Final Support SQL Server の次のメジャー リリースから削除される機能を使用すると発生します。
127 Exchange Spill Event 並列クエリ プランの通信バッファーが tempdb データベースに一時的に書き込まれたときに発生します。
128 Audit Database Management Event データベースが作成、変更、または削除されたときに発生します。
129 Audit Database Object Management Event スキーマなどのデータベース オブジェクトに対して CREATE、ALTER、または DROP ステートメントが実行されるときに発生します。
130 Audit Database Principal Management Event ユーザーなどのプリンシパルがデータベースから作成、変更、または削除されたときに発生します。
131 Audit Schema Object Management Event サーバー オブジェクトが作成、変更、または削除されたときに発生します。
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 Event サーバー スコープ内のオブジェクトの所有者が変更されたときに発生します。
135 Audit Database Object Take Ownership Event データベース スコープ内のオブジェクトの所有者の変更が発生したときに発生します。
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 Reserved
146 Showplan XML Statistics Profile SQL ステートメントの実行時に発生します。 プラン表示演算子を識別し、コンパイル時の完全なデータを表示します。 このイベントの Binary 列には、エンコードされた Showplan が含まれています。 SQL Server プロファイラーを使用してトレースを開き、プラン表示を表示します。
148 Deadlock Graph 試行がデッドロックの一部であり、デッドロックの対象として選択されたために、ロックの取得が取り消されたときに発生します。 デッドロックについての XML の説明が提供されます。
149 Broker:Remote Message Acknowledgement Service Broker がメッセージ受信確認を送受信するときに発生します。
150 Trace File Close トレース ファイルのロールオーバー中にトレース ファイルが閉じるときに発生します。
151 Reserved
152 Audit Change Database Owner ALTER AUTHORIZATION を使用してデータベースの所有者を変更し、それを行うために権限がチェックされるときに発生します。
153 Audit Schema Object Take Ownership Event ALTER AUTHORIZATION を使用して所有者をオブジェクトに割り当て、アクセス許可がチェックされたときに発生します。
154 Reserved
155 FT:Crawl Started フルテキストのクロール (カタログ作成) が開始したときに発生します。 クロール要求がワーカー タスクによって取得されるかどうかを確認するために使用します。
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 Database Mirroring State Change ミラー化データベースの状態が変更されたときに発生します。
168 Showplan XML For Query Compile SQL ステートメントがコンパイルされるときに発生します。 コンパイル時の完全なデータを表示します。 このイベントの Binary 列には、エンコードされた Showplan が含まれています。 SQL Server プロファイラーを使用してトレースを開き、プラン表示を表示します。
169 Showplan All For Query Compile SQL ステートメントがコンパイルされるときに発生します。 完全なコンパイル時データを表示します。 プラン表示演算子を識別するために使用します。
170 Audit Server Scope GDR Event ログインの作成など、サーバー スコープ内のアクセス許可の許可、拒否、または取り消しイベントが発生したことを示します。
171 Audit Server Object GDR Event テーブルや関数などのスキーマ オブジェクトの許可、拒否、または取り消しイベントが発生したことを示します。
172 Audit Database Object GDR Event アセンブリやスキーマなどのデータベース オブジェクトに対して、付与、拒否、または取り消しのイベントが発生したことを示します。
173 Audit Server Operation Event 設定、リソース、外部アクセス、承認の変更などのセキュリティ監査操作が使用されるときに発生します。
175 Audit Server Alter Trace Event ステートメントが ALTER TRACE 権限をチェックするときに発生します。
176 Audit Server Object Management Event サーバー オブジェクトが作成、変更、または削除されたときに発生します。
177 Audit Server Principal Management Event サーバー プリンシパルが作成、変更、または削除されたときに発生します。
178 Audit Database Operation Event チェックポイントやクエリ通知のサブスクライブなど、データベース操作が行われたときに発生します。
180 Audit Database Object Access Event スキーマなどのデータベース オブジェクトにアクセスするときに発生します。
181 TM: Begin Tran starting BEGIN TRANSACTION要求が開始されたときに発生します。
182 TM: Begin Tran completed BEGIN TRANSACTION要求が完了したときに発生します。
183 TM: Promote Tran starting PROMOTE TRANSACTION要求が開始されたときに発生します。
184 TM: Promote Tran completed 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: Rollback Tran completed ROLLBACK TRANSACTION要求が完了したときに発生します。
189 Lock:Timeout (timeout > 0) ページなどのリソースのロック要求がタイムアウトしたときに発生します。
190 Progress Report: Online Index Operation ビルド プロセスの実行中にオンライン インデックスのビルド操作の進行状況を報告します。
191 TM: Save Tran starting SAVE TRANSACTION要求が開始されたときに発生します。
192 TM: Save Tran completed SAVE TRANSACTION要求が完了したときに発生します。
193 Background Job Error バックグラウンド ジョブが異常終了したときに発生します。
194 OLEDB Provider Information 分散クエリが実行され、プロバイダー接続に対応する情報が収集されるときに発生します。
195 Mount Tape テープ マウント要求を受け取ったときに発生します。
196 Assembly Load CLR アセンブリを読み込む要求が発生したときに発生します。
197 Reserved
198 XQuery Static Type XQuery 式が実行されるときに発生します。 このイベント クラスでは静的な XQuery 式が提供されます。
199 QN: subscription クエリ登録をサブスクライブできない場合に発生します。 TextData列には、イベントに関する情報が含まれています。
200 QN: parameter table アクティブなサブスクリプションに関する情報は、内部パラメーター テーブルに格納されます。 このイベント クラスは、パラメーター テーブルが作成または削除されたときに発生します。 通常これらのテーブルは、データベースを再起動したときに作成または削除されます。 TextData列には、イベントに関する情報が含まれています。
201 QN: template クエリ テンプレートによって、サブスクリプション クエリのクラスが表されます。 通常、同じクラスにあるクエリは、パラメーター値を除いてすべて同じになります。 このイベント クラスは、新しいサブスクリプション要求が既に存在するクラス (Match)、新しいクラス (Create)、または Drop クラスに分類された場合に発生します。これは、アクティブなサブスクリプションのないクエリ クラスのテンプレートのクリーンアップを示します。 TextData列には、イベントに関する情報が含まれています。
202 QN: dynamics クエリ通知の内部アクティビティを追跡します。 TextData列には、イベントに関する情報が含まれています。
212 Bitmap Warning クエリでビットマップ フィルターが無効になっているタイミングを示します。
213 Database Suspect Data Page msdbのsuspect_pages テーブルにページが追加されるタイミングを示します。
214 CPU threshold exceeded リソース ガバナーがクエリが CPU しきい値 (REQUEST_MAX_CPU_TIME_SEC) を超えたと検出したことを示します。
215 PreConnect:Starting LOGON トリガーまたはリソース ガバナー分類子関数がいつ実行を開始するかを示します。
216 PreConnect:Completed LOGON トリガーまたはリソース ガバナー分類子関数が実行を完了するタイミングを示します。
217 Plan Guide Successful データベース エンジンが、プラン ガイドを含むクエリまたはバッチの実行プランを正常に生成したことを示します。
218 Plan Guide Unsuccessful プラン ガイドを含むクエリまたはバッチに対して、データベース エンジンが実行プランを生成できなかったことを示します。 データベース エンジンは、プラン ガイドを適用せずに、このクエリまたはバッチの実行プランを生成しようとしました。 無効なプラン ガイドがこの問題の原因である可能性があります。 プラン ガイドは、 sys.fn_validate_plan_guide システム関数を使用して検証できます。
235 Audit Fulltext

[ @columnid = ] columnid

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

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

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

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

1 = 成功
0 = 失敗
24 IndexID イベントの影響を受けるオブジェクトに付けられたインデックス用の ID。 オブジェクトのインデックス ID を確認するには、sysindexes システム テーブルのindid列を使用します。
25 IntegerData トレースでキャプチャされたイベント クラスに依存する整数値。
26 ServerName トレース対象の SQL Server のインスタンスの名前 ( servername または servername\instancename。
27 EventClass 記録されるイベント クラスの種類。
28 ObjectType オブジェクトの種類 (テーブル、関数、ストアド プロシージャなど)。
29 NestLevel このストアド プロシージャが実行されている入れ子レベル。 @@NESTLEVELを参照してください。
30 State エラーが発生した場合のサーバーの状態。
31 Error エラー番号。
32 Mode 取得したロックのロック モード。 この列は、 Lock:Released イベントによって設定されません。
33 Handle イベントで参照されているオブジェクトのハンドル。
34 ObjectName アクセスされるオブジェクトの名前。
35 DatabaseName USE database ステートメントで指定されたデータベースの名前。
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 = system
0 = user。
61 Offset ストアド プロシージャ内またはバッチ内のステートメントの開始オフセット。
62 SourceDatabaseID オブジェクトのソースが存在するデータベースの ID。
63 SqlHandle アドホック クエリのテキスト、または SQL オブジェクトのデータベースとオブジェクト ID に基づく 64 ビット ハッシュ。 この値を sys.dm_exec_sql_text() に渡して、関連付けられている SQL テキストを取得できます。
64 SessionLoginName セッションを開始したユーザーのログイン名。 たとえば、Login1を使用して SQL Server に接続し、ステートメントをLogin2として実行すると、SessionLoginNameLogin1が表示され、LoginNameLogin2表示されます。 このデータ列には、SQL Server ログインと Windows ログインの両方が表示されます。

[ @on = ] on

イベントを有効 (1) または無効 (0) にするかどうかを指定します。 @on は ビットで、既定値はありません。

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

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

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

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

すべての列は消去されます。
NOT NULL 指定したイベントの列が on に変換されます。
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 を実行する必要があります。 各実行中に、 @on が 1 に設定されている場合、指定したイベント sp_trace_setevent トレースのイベントの一覧に追加されます。 @onが 0 に設定されている場合、sp_trace_seteventは指定したイベントをリストから削除します。

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

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

アクセス許可

ALTER TRACE 権限が必要です。

関連するコンテンツ