CursorPrepare イベント クラス
CursorPrepare イベント クラスでは、アプリケーション プログラミング インターフェイス (API) のカーソルで発生する、カーソル準備イベントを記述しています。 カーソル準備イベントは、Microsoft データベース エンジンによって、カーソルに関連付けられた SELECT ステートメントのコンパイルにより実行プランが作成され、カーソルの作成は行われなかったときに発生します。
CursorPrepare イベント クラスは、カーソルのパフォーマンスを記録しているトレース内で使用します。 CursorPrepare イベント クラスをトレースに含めた場合、発生するオーバーヘッドの量は、トレース中にデータベースに対してカーソルを使用する頻度によって異なります。 カーソルの使用頻度が高い場合は、トレースによってパフォーマンスが大幅に低下する可能性があります。
CursorPrepare イベント クラスのデータ列
データ列名 |
データ型 |
説明 |
列 ID |
フィルターの適用 |
|---|---|---|---|---|
ApplicationName |
nvarchar |
SQL Server のインスタンスへの接続を作成したクライアント アプリケーションの名前。 この列には、プログラムの表示名ではなく、アプリケーションによって渡された値が格納されます。 |
10 |
可 |
ClientProcessID |
int |
クライアント アプリケーションが実行されているプロセスに対し、ホスト コンピューターが割り当てた ID。 クライアントでクライアント プロセス ID が指定されると、このデータ列に値が格納されます。 |
9 |
可 |
DatabaseID |
int |
USE database ステートメントで指定されたデータベースの ID、または特定のインスタンスについて USE database ステートメントが実行されていない場合は既定のデータベースの ID となります。 SQL Server Profiler では、ServerName データ列がトレースにキャプチャされ、そのサーバーが利用可能な場合、データベースの名前が表示されます。 データベースに対応する値は、DB_ID 関数を使用して特定します。 |
3 |
可 |
DatabaseName |
nvarchar |
ユーザーのステートメントが実行されているデータベースの名前。 |
35 |
可 |
EventClass |
int |
記録されるイベントの種類 = 70。 |
27 |
不可 |
EventSequence |
int |
バッチ内の CursorPrepare イベント クラスのシーケンス。 |
51 |
不可 |
GroupID |
int |
SQL トレース イベントが発生したワークロード グループの ID。 |
66 |
可 |
Handle |
int |
イベント クラスのハンドル。 |
33 |
可 |
HostName |
nvarchar |
クライアントが実行されているコンピューターの名前。 このデータ列には、クライアントがホスト名を指定している場合にデータが格納されます。 ホスト名を特定するには、HOST_NAME 関数を使用します。 |
8 |
可 |
IsSystem |
int |
イベントがシステム プロセスで発生したか、ユーザー プロセスで発生したかを示します。 1 = システム、0 = ユーザーです。 |
60 |
可 |
LoginName |
nvarchar |
ユーザーのログイン名 (SQL Server セキュリティ ログインまたは DOMAIN\username という形式の Windows ログイン資格情報)。 |
11 |
可 |
LoginSid |
image |
ログイン ユーザーのセキュリティ ID 番号 (SID)。 この情報は、sys.server_principals カタログ ビューで参照できます。 各 SID はサーバーのログインごとに一意です。 |
41 |
可 |
NTDomainName |
nvarchar |
ユーザーが所属する Windows ドメイン。 |
7 |
不可 |
NTUserName |
nvarchar |
Windows のユーザー名。 |
6 |
可 |
RequestID |
int |
カーソルを準備した要求 ID。 |
49 |
可 |
ServerName |
nvarchar |
トレースされている SQL Server のインスタンスの名前。 |
26 |
不可 |
SessionLoginName |
nvarchar |
セッションを開始したユーザーのログイン名。 たとえば、Login1 を使用して SQL Server に接続し、Login2 でステートメントを実行すると、SessionLoginName には Login1 が表示され、LoginName には Login2 が表示されます。 この列には、SQL Server ログインと Windows ログインの両方が表示されます。 |
64 |
可 |
SPID |
int |
イベントが発生したセッションの ID。 |
12 |
可 |
StartTime |
datetime |
イベントの開始時刻 (取得できた場合)。 |
14 |
可 |
TransactionID |
bigint |
システムによって割り当てられたトランザクション ID。 |
4 |
可 |
XactSequence |
bigint |
現在のトランザクションを説明するトークン。 |
50 |
可 |
関連項目
参照
sp_trace_setevent (Transact-SQL)