sp_trace_setevent (Transact-SQL)
適用対象:
SQL Server
トレースに対して、イベントまたはイベント列を追加または削除します。 sp_trace_setevent は、停止されている既存のトレースでのみ実行できます (状態 は 0)。 このストアド プロシージャが存在しないトレースで実行されるか、 状態 が 0 でない場合は、エラーが返されます。
重要
この機能は、Microsoft SQL Server の将来のバージョンで削除されます。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに拡張イベントを使用します。
構文
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 | 監査ログイン | ユーザーが正常にSQL Serverにログインしたときに発生します。 |
| 15 | 監査ログアウト | ユーザーが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: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 トランザクション | 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 | ハッシュの警告 | バッファー パーティション上で処理されていないハッシュ演算 (ハッシュ結合、ハッシュ集計、ハッシュ ユニオン、ハッシュ識別など) が代替プランに変更されたことを示します。 これは、再帰の深さ、データ スキュー、トレース フラグ、またはビットカウントが原因で発生する可能性があります。 |
| 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では、使用する 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-Library によって準備されていません (削除)。 |
| 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 | Audit AddLogin イベント | 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 | 監査ログインパスワード変更イベント | 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 イベント | ログインがデータベース ユーザー (固定またはユーザー定義) としてデータベースに追加または削除されたときに発生します。 sp_addrolemember、 sp_droprolemember、 sp_changegroup。 |
| 111 | 監査ロールの追加イベント | ログインがデータベース ユーザーとしてデータベースに追加または削除されたときに発生します。 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 | バックアップ/復元イベントの監査 | 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 ドキュメントに格納されます。 このイベントの Binary 列には、エンコードされたプラン表示が含まれていることに注意してください。 SQL Server Profilerを使用してトレースを開き、プラン表示を表示します。 |
| 123 | SQL:FullTextQuery | フルテキスト クエリが実行されたときに発生します。 |
| 124 | Broker:Conversation | Service Broker の会話の進行状況を報告します。 |
| 125 | 非推奨のお知らせ | 将来のバージョンのSQL Serverから削除される機能を使用すると発生します。 |
| 126 | Deprecation Final Support | SQL Serverの次のメジャー リリースから削除される機能を使用すると発生します。 |
| 127 | Exchange スピル イベント | 並列クエリ プランの通信バッファーが tempdb データベースに一時的に書き込まれた場合に発生します。 |
| 128 | データベース管理イベントの監査 | データベースが作成、変更、または削除されたときに発生します。 |
| 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 | 監査サーバー オブジェクトの所有権の取得イベント | サーバー スコープ内のオブジェクトの所有者が変更されたときに発生します。 |
| 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 ステートメントの実行時に発生します。 プラン表示演算子を識別し、コンパイル時の完全なデータを表示します。 このイベントの Binary 列には、エンコードされたプラン表示が含まれていることに注意してください。 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: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 | データベース ミラーリングの状態の変更 | ミラー化データベースの状態が変更されたときに発生します。 |
| 168 | Showplan XML For Query Compile | SQL ステートメントがコンパイルされるときに発生します。 コンパイル時の完全なデータを表示します。 このイベントの Binary 列には、エンコードされたプラン表示が含まれていることに注意してください。 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: 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: ロールバック Tran が完了しました | ROLLBACK TRANSACTION 要求が完了したときに発生します。 |
| 189 | Lock: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 | msdb のsuspect_pages テーブルにページが追加されるタイミングを示します。 |
| 214 | CPU Threshold Exceeded | Resource Governorがクエリが CPU しきい値 (REQUEST_MAX_CPU_TIME_SEC) を超えたと検出したことを示します。 |
| 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_id は int で、既定値はありません。
次の表に、イベントに追加できる列を示します。
| 列番号 | 列名 | 説明 |
|---|---|---|
| 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 | 期間 | イベントによって取得された経過時間 (マイクロ秒単位)。 このデータ列は、ハッシュ警告イベントによって設定されません。 |
| 14 | StartTime | イベントの開始時刻 (取得できた場合)。 |
| 15 | EndTime | イベントの終了時刻。 SQL:BatchStarting や SP: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 または servername\instancename)。 |
| 27 | EventClass | 記録されるイベント クラスの種類。 |
| 28 | ObjectType | オブジェクトの種類 (テーブル、関数、ストアド プロシージャなど)。 |
| 29 | NestLevel | このストアド プロシージャが実行されている入れ子レベル。 「@@NESTLEVEL (Transact-SQL)」を参照してください。 |
| 30 | 状態 | エラーが発生した場合のサーバーの状態。 |
| 31 | エラー | エラー番号。 |
| 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 = user。 |
| 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 の場合、イベントはオフになり、すべての列がクリアされます。 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 を実行する必要があります。 各実行中に、 @on が 1 に設定されている場合、指定したイベント sp_trace_setevent トレースのイベントの一覧に追加されます。 @onが 0 に設定されている場合、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)