CursorOpen イベント クラス
適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance
CursorOpen イベント クラスでは、アプリケーション プログラミング インターフェイス (API) のカーソルで発生する、カーソルを開くイベントが示されます。 カーソルを開くイベントは、SQL Server データベース エンジンがカーソルとカーソル オプションに関連付ける SQL ステートメントを定義し、カーソルを設定するときに発生します。
カーソルのパフォーマンスを記録しているトレースに、 CursorOpen イベント クラスを含めます。 CursorOpen イベント クラスをトレースに含めた場合、発生するオーバーヘッドの量は、トレース中にデータベースに対してカーソルを使用する頻度によって異なります。 カーソルの使用頻度が高い場合は、トレースによってパフォーマンスが大幅に低下する可能性があります。
CursorOpen イベント クラスのデータ列
データ列名 | データの種類 | 説明 | 列 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 | 記録されるイベントの種類 = 53。 | 27 | いいえ |
EventSequence | int | バッチ内の CursorOpen イベント クラスのシーケンス。 | 51 | いいえ |
GroupID | int | SQL トレース イベントが発生したワークロード グループの ID。 | 66 | はい |
Handle | int | サーバーとの間で実行を調整するときに ODBC、OLE DB、または DB-Library によって使用される整数。 | 33 | はい |
HostName | nvarchar | クライアントが実行されているコンピューターの名前。 このデータ列にはクライアントからホスト名が提供されている場合に値が格納されます。 ホスト名を指定するには、 HOST_NAME 関数を使用します。 | 8 | はい |
IntegerData | int | カーソルの種類。 値は次のとおりです。 1 = キー セット 2 = 動的 4 = 順方向専用 8 = 静的 16 = 高速順方向 |
25 | はい |
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 | はい |
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 | はい |