次の方法で共有

CursorClose イベント クラス

  • [アーティクル]

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance

カーソルクローズ イベントは、データベース エンジンが閉じてカーソルの割り当てを解除したときに発生します。 CursorClose イベント クラスは、アプリケーション プログラミング インターフェイス (API) カーソルで発生する、カーソルを閉じるイベントを記述しています。 このイベント クラスは、ODBC、OLE DB、または DB ライブラリによる 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。 27 いいえ
EventSequence int バッチ内の CursorClose イベント クラスのシーケンス。 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 の形式の Microsoft 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)