[アーティクル]
09/28/2010

sp_trace_setevent (Transact-SQL)

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

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

構文

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

引数

[ @traceid= ] trace_id
変更するトレースの ID を指定します。trace_id のデータ型は int で、既定値はありません。ユーザーは、この trace_id 値を使用して、トレースの識別、変更、および制御を行います。
[ @eventid= ] event_id
有効にするイベントの ID を指定します。event_id のデータ型は int で、既定値はありません。

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

イベント番号	イベント名	説明
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	複数のデータベース間で、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 (7.0 Insert)	SELECT、INSERT、または UPDATE ステートメントが実行される前に発生します。
29-31	予約済み	代わりにイベント 28 を使用してください。
32	予約済み	予約済み
33	Exception	SQL Server で例外が発生したことを示します。
34	SP:CacheMiss	ストアドプロシージャがプロシージャキャッシュ内にないことを示します。
35	SP:CacheInsert	プロシージャキャッシュにアイテムが挿入されたことを示します。
36	SP:CacheRemove	プロシージャキャッシュからアイテムが削除されたことを示します。
37	SP:Recompile	ストアドプロシージャが再コンパイルされたことを示します。
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	Object:Created	CREATE INDEX、CREATE TABLE、CREATE DATABASE などのステートメントで、オブジェクトが作成されたことを示します。
47	Object:Deleted	DROP INDEX や DROP TABLE などのステートメントで、オブジェクトが削除されたことを示します。
48	予約済み
49	予約済み
50	SQL Transaction	Transact-SQL の BEGIN、COMMIT、SAVE、および ROLLBACK TRANSACTION の各ステートメントを追跡します。
51	Scan:Started	テーブルスキャンまたはインデックススキャンが開始されたことを示します。
52	Scan:Stopped	テーブルスキャンまたはインデックススキャンが停止したことを示します。
53	CursorOpen	Transact-SQL ステートメントで、ODBC、OLE DB、または DB-Library によりカーソルがオープンされたことを示します。
54	TransactionLog	トランザクションがいつトランザクションログに書き込まれるかを追跡します。
55	Hash Warning	バッファパーティション上で処理されていないハッシュ演算 (ハッシュ結合、ハッシュ集計、ハッシュユニオン、ハッシュ識別など) が代替プランに変更されたことを示します。これは、再帰深度、データスキュー、トレースフラグ、またはビットカウンティングが原因で発生します。
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-Library で使用できるよう準備されたことを示します。
71	Prepare SQL	ODBC、OLE DB、または DB-Library によって、1 つ以上の Transact-SQL ステートメントが使用できるように準備されたことを示します。
72	Exec Prepared SQL	ODBC、OLE DB、または DB-Library によって、準備された 1 つ以上の Transact-SQL ステートメントが実行されたことを示します。
73	Unprepare SQL	ODBC、OLE DB、または DB-Library によって、準備された 1 つ以上の Transact-SQL ステートメントが削除されたことを示します。
74	CursorExecute	Transact-SQL ステートメントで ODBC、OLE DB、または DB-Library によって準備されたカーソルが実行されたことを示します。
75	CursorRecompile	Transact-SQL ステートメントで ODBC または DB-Library によってオープンされていたカーソルが、直接再コンパイルされたか、またはスキーマが変更されたために再コンパイルされたことを示します。これは ANSI および非 ANSI のカーソルの場合に発生します。
76	CursorImplicitConversion	Transact-SQL ステートメントのカーソルの種類が、SQL Server によって別の種類に変換されたことを示します。これは ANSI および非 ANSI のカーソルの場合に発生します。
77	CursorUnprepare	Transact-SQL ステートメントで準備されたカーソルが、ODBC、OLE DB、または DB-Library によって削除されたことを示します。
78	CursorClose	Transact-SQL ステートメントでオープンされていたカーソルが、ODBC、OLE DB、または DB-Library によってクローズされたことを示します。
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	予約済み
100	RPC Output Parameter	各 RPC に対して、パラメータの出力値を生成します。
101	予約済み
102	Audit Statement GDR Event	SQL Server の任意のユーザーがステートメント権限の GRANT、DENY、REVOKE を実行するたびに発生します。
103	Audit Object GDR Event	SQL Server の任意のユーザーがオブジェクト権限の GRANT、DENY、REVOKE を実行するたびに発生します。
104	Audit AddLogin Event	sp_addlogin および sp_droplogin で、SQL Server ログインが追加または削除されたときに発生します。
105	Audit Login GDR Event	sp_grantlogin、sp_revokelogin、または sp_denylogin で、Windows ログイン権限が追加または削除されたときに発生します。
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	sp_grantdbaccess、sp_revokedbaccess、sp_adduser、および sp_dropuser で、データベースのデータベースユーザー (Windows または SQL Server) として、ログインが追加または削除されたときに発生します。
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 列には、エンコードされたプラン表示が含まれます。トレースを開いてプラン表示を確認するには、SQL Server Profiler を使用します。
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	予約済み
146	Showplan XML Statistics Profile	SQL ステートメントが実行されたときに発生します。プラン表示演算子が識別され、コンパイル時の完全なデータが表示されます。このイベントに対する Binary 列には、エンコードされたプラン表示が含まれます。トレースを開いてプラン表示を確認するには、SQL Server Profiler を使用します。
148	Deadlock Graph	ロックを取得しようとしてデッドロックが発生したため、ロックの取得がキャンセルされたときに発生します。デッドロックについての XML の説明が提供されます。
149	Broker:Remote Message Acknowledgement	Service Broker によってメッセージの受信確認が送信または受信されたときに発生します。
150	Trace File Close	トレースファイルのロールオーバー中にトレースファイルが閉じられたときに発生します。
151	予約済み
152	Audit Change Database Owner	ALTER AUTHORIZATION を使用して、データベースの所有者を変更するか、変更に必要な権限を確認したときに発生します。
153	Audit Schema Object Take Ownership Event	ALTER AUTHORIZATION を使用して、オブジェクトに所有者を割り当てるか、割り当てに必要な権限を確認したときに発生します。
154	予約済み
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 列には、エンコードされたプラン表示が含まれます。トレースを開いてプラン表示を確認するには、SQL Server Profiler を使用します。
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	予約済み
198	XQuery Static Type	XQuery 式が実行されたときに発生します。このイベントクラスでは静的な XQuery 式が提供されます。
199	QN: subscription	クエリの登録がサブスクライブされなかったときに発生します。TextData 列には、このイベントに関する情報が格納されます。
200	QN: parameter table	アクティブなサブスクリプションに関する情報は、内部パラメータテーブルに格納されます。このイベントクラスは、パラメータテーブルが作成または削除されたときに発生します。通常これらのテーブルは、データベースを再起動したときに作成または削除されます。TextData 列には、このイベントに関する情報が格納されます。
201	QN: template	クエリテンプレートによって、サブスクリプションクエリのクラスが表されます。通常、同じクラスにあるクエリは、パラメータ値を除いてすべて同じになります。このイベントクラスは、新しいサブスクリプション要求が、既存のクラス (一致したクラス)、新しいクラス (作成)、または削除するクラスに分類されたときに発生します。これは、アクティブなサブスクリプションが含まれていないクエリクラスのテンプレートをクリーンアップすることを示します。TextData 列には、このイベントに関する情報が格納されます。
202	QN: dynamics	クエリ通知の内部アクティビティを追跡します。TextData 列には、このイベントに関する情報が格納されます。

[ @columnid= ] column_id
イベントに対して追加する列の ID を指定します。column_id のデータ型は int で、既定値はありません。

次の表は、イベントに対して追加できる列の一覧です。

列番号	列名	説明
1	TextData	トレースでキャプチャされたイベントクラスに依存するテキスト値。
2	BinaryData	トレースでキャプチャされたイベントクラスに依存するバイナリ値。
3	DatabaseID	USE database ステートメントで指定されたデータベースの ID、または接続に対して USE database ステートメントが実行されていない場合は、既定のデータベースの ID。データベースに対するデータベース ID の値は、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	イベントの実行に要した経過時間 (マイクロ秒単位)。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 (Transact-SQL)」を参照してください。
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 = システム 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 のデータ型は bit で、既定値はありません。

on を 1 に設定し、column_id が NULL の場合、イベントは ON に設定され、すべての列が消去されます。column_id が NULL でない場合、そのイベントに対して列は ON に設定されます。

on を 0 に設定し、column_id が NULL の場合、イベントは OFF に設定され、すべての列が消去されます。column_id が NULL でない場合、列は OFF になります。

次の表は、@on と @columnid の相互作用の説明です。

@on	@columnid	結果
ON (1)	NULL	イベントは ON になります。すべての列は消去されます。
	NOT NULL	指定されたイベントに対して列は ON になります。
OFF (0)	NULL	イベントは OFF になります。すべての列は消去されます。
	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 Trace ストアドプロシージャ (sp_trace_xx) のパラメータでは、データ型が厳密に定義されています。これらのパラメータを、引数の説明で指定されている正しいデータ型で指定しないと、このストアドプロシージャはエラーを返します。

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

権限

ユーザーに ALTER TRACE 権限が必要です。

次の方法で共有

sp_trace_setevent (Transact-SQL)

構文

引数

リターンコード値

説明

権限

関連項目

参照

その他の技術情報

その他のリソース

次の方法で共有

sp_trace_setevent (Transact-SQL)

構文

引数

リターン コード値

説明

権限

関連項目

参照

その他の技術情報

その他のリソース

リターンコード値