CursorUnprepare 事件类
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例
CursorUnprepare 事件类提供了与应用程序编程接口 (API) 游标中发生的游标撤消事件相关的信息。 当Microsoft 数据库引擎放弃执行计划时，将发生游标未准备事件。
将 CursorUnprepare 事件类包括到记录游标性能的跟踪中。 当跟踪中包括 CursorUnprepare 事件时，引发的开销量取决于跟踪过程中对数据库使用游标的频率。 如果广泛使用游标，则跟踪将会显著地降低性能。
CursorUnprepare 事件类的数据列
| 数据列名称 | 数据类型 | 说明 | 列 ID | 可筛选 |
|---|---|---|---|---|
| ApplicationName | nvarchar | 创建到 SQL Server 实例连接的客户端应用程序的名称。 该列由应用程序传递的值填充，而不是由所显示的程序名填充。 | 10 | 是 |
| ClientProcessID | int | 主机为运行该客户端应用程序的进程分配的 ID。 如果客户端提供了客户端进程 ID，则填充此数据列。 | 9 | 是 |
| DatabaseID | int | 由 USE 数据库语句指定的数据库的 ID；如果未对给定实例发出 USE 数据库语句，则为默认数据库的 ID。 如果在跟踪中捕获 ServerName 数据列且服务器可用，SQL Server Profiler 将显示数据库名称。 可使用 DB_ID 函数来确定数据库的值。 | 3 | 是 |
| DatabaseName | nvarchar | 正在其中运行用户语句的数据库的名称。 | 35 | 是 |
| EventClass | int | 记录的事件类型 = 77。 | 27 | 否 |
| EventSequence | int | CursorUnprepare 事件类的批处理顺序。 | 51 | 否 |
| GroupID | int | 在其中激发 SQL 跟踪事件的工作负荷组的 ID。 | 66 | 是 |
| Handle | Int | 标识正在撤消的已准备好的句柄。 | 33 | 是 |
| HostName | nvarchar | 正在运行客户端的计算机的名称。 如果客户端提供了主机名，则填充此数据列。 若要确定主机名，请使用 HOST_NAME 函数。 | 8 | 是 |
| IsSystem | int | 指示事件是发生在系统进程中还是发生在用户进程中。 1 = 系统，0 = 用户。 | 60 | 是 |
| LoginName | nvarchar | 用户的登录名（SQL Server 安全登录名或域\用户名形式的Microsoft Windows 登录凭据）。 | 11 | 是 |
| LoginSid | image | 已登录的用户的安全标识符 (SID)。 你可以在 sys.server_principals 目录视图中找到此信息。 服务器中的每个登录名都具有唯一的 SID。 | 41 | 是 |
| NTDomainName | nvarchar | 用户所属的 Windows 域。 | 7 | 是 |
| NTUserName | nvarchar | Windows 用户名。 | 6 | 是 |
| RequestID | int | 撤消了游标的请求标识。 | 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 | 是 |