User configurable イベント クラス
適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance
ユーザー定義のイベントを監視するには、User configurable イベント カテゴリを使用します。 ユーザー定義のイベント クラスを作成して、他のイベント カテゴリにあるシステム提供のイベント クラスでは監視できないイベントを監視します。 たとえば、ユーザー定義のイベントを作成して、テスト中のアプリケーションの進行状況を監視できます。 アプリケーションを実行すると、あらかじめ定義したポイントでイベントが生成され、アプリケーションの現在の実行ポイントを特定できます。
User configurable イベント クラスのデータ列
データ列名 | データの種類 | 説明 | 列 ID | フィルター可能 |
---|---|---|---|---|
ApplicationName | nvarchar | SQL Server のインスタンスへの接続を作成したクライアント アプリケーションの名前。 この列には、プログラムの表示名ではなく、アプリケーションによって渡された値が格納されます。 | 10 | はい |
BinaryData | image | トレースでキャプチャされたイベント クラスに依存するバイナリ値。 | 2 | はい |
ClientProcessID | int | クライアント アプリケーションが実行されているプロセスに対し、ホスト コンピューターが割り当てた ID。 クライアントによりクライアント プロセス ID が指定されると、このデータ列に値が格納されます。 | 9 | はい |
DatabaseID | int | USE database ステートメントで指定されたデータベースの ID、または特定のインスタンスについて USE database ステートメントが実行されていない場合は既定の database となります。 SQL Server Profiler では、 ServerName データ列がトレースにキャプチャされ、そのサーバーが利用可能な場合、データベースの名前が表示されます。 データベースに対応する値は、DB_ID 関数を使用して特定します。 | 3 | はい |
DatabaseName | nvarchar | ユーザーのステートメントが実行されているデータベースの名前。 | 35 | はい |
EventClass | int | イベントの種類 = 82 ~ 91。 | 27 | いいえ |
EventSequence | int | 要求内の特定のイベントのシーケンス。 | 51 | いいえ |
GroupID | int | SQL トレース イベントが発生したワークロード グループの ID。 | 66 | はい |
HostName | nvarchar | クライアントが実行されているコンピューターの名前。 このデータ列にはクライアントからホスト名が提供されている場合に値が格納されます。 ホスト名を指定するには、 HOST_NAME 関数を使用します。 | 8 | はい |
IsSystem | int | イベントがシステム プロセスとユーザー プロセスのどちらで発生したか。 1 はシステム、0 はユーザーです。 | 60 | はい |
LoginName | nvarchar | ユーザーのログインの名前 (SQL Server セキュリティ ログインまたは DOMAIN\username の形式の Microsoft Windows ログイン資格情報)。 | 11 | はい |
LoginSid | image | ログインしたユーザーのセキュリティ識別子 (SID)。 この情報は、sys.server_principals カタログ ビューで参照できます。 各 SID はサーバーのログインごとに一意です。 | 41 | はい |
NTDomainName | nvarchar | ユーザーが所属する Windows ドメイン。 | 7 | はい |
NTUserName | nvarchar | Windows のユーザー名。 | 6 | はい |
RequestID | int | ステートメントが含まれている要求の ID。 | 49 | はい |
SessionLoginName | nvarchar | セッションを開始したユーザーのログイン名。 たとえば、Login1 を使用して SQL Server に接続し、Login2 としてステートメントを実行すると、SessionLoginName に Login1 が表示され、LoginName に Login2 が表示されます。 この列には、SQL Server ログインと Windows ログインの両方が表示されます。 | 64 | はい |
SPID | int | イベントが発生したセッションの ID。 | 12 | はい |
StartTime | datetime | イベントの開始時刻 (取得できた場合)。 | 14 | はい |
TextData | ntext | トレースでキャプチャされたイベント クラスに依存するテキスト値。 | 1 | はい |
TransactionID | bigint | システムによって割り当てられたトランザクション ID。 | 4 | はい |
参照
SQL Server Profiler
sp_trace_setevent (Transact-SQL)
sp_trace_generateevent (Transact-SQL)