カーソルクローズ イベントは、データベース エンジンがカーソルを閉じて割り当てを解除したときに発生します。 CursorClose イベント クラスは、アプリケーション プログラミング インターフェイス (API) カーソルで発生するカーソル クローズ イベントを記述します。 このイベント クラスは、ODBC、OLE DB、または DB-Library によって Transact-SQL カーソル ステートメントが閉じられたときに発生します。
カーソルのパフォーマンスを記録しているトレースに CursorClose イベント クラスを含めます。 発生するオーバーヘッドの量は、トレース中にデータベースに対してカーソルが使用される頻度によって異なります。 カーソルが広範囲に使用されている場合、トレースによってパフォーマンスが大幅に低下する可能性があります。
CursorClose イベント クラスのデータ列
| データ列名 | データの種類 | 説明 | 列 ID | フィルターの適用 |
|---|---|---|---|---|
| ApplicationName | nvarchar | SQL Server のインスタンスへの接続を作成したクライアント アプリケーションの名前。 この列には、プログラムの表示名ではなく、アプリケーションによって渡された値が格納されます。 | 10 | イエス |
| 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 | 記録されたイベントの種類 = 78。 | 二十七 | いいえ |
| EventSequence | int | バッチ内の CursorClose イベント クラスのシーケンス。 | 51 | いいえ |
| GroupID を する | int | SQL トレース イベントが発生したワークロード グループの ID。 | 66 | イエス |
| ハンドル | int | イベントで参照されているオブジェクトのハンドル。 | 33 | イエス |
| HostName | nvarchar | クライアントが実行されているコンピューターの名前。 このデータ列にはクライアントからホスト名が提供されている場合に値が格納されます。 ホスト名を指定するには、 HOST_NAME 関数を使用します。 | 8 | イエス |
| IsSystem | int | イベントがシステム プロセスとユーザー プロセスのどちらで発生したか。 1 はシステム、0 はユーザーです。 | 六十 | イエス |
| LoginName | nvarchar | ユーザーのログインの名前 (SQL Server セキュリティ ログインまたは DOMAIN\username の形式の Microsoft Windows ログイン資格情報)。 | 11 | イエス |
| LoginSid | 画像 | ログイン ユーザーのセキュリティ 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 | イエス |