CursorPrepare 事件类描述在应用程序编程接口 (API) 游标中发生的游标准备事件。 当Microsoft数据库引擎将与游标关联的 SELECT 语句编译到执行计划中但不创建游标时,游标准备事件就会发生。
在记录游标性能的跟踪中包含 CursorPrepare 事件类。 当 CursorPrepare 事件类被包含在跟踪中时,产生的额外开销将取决于在跟踪期间对数据库使用游标的频率。 如果游标广泛使用,跟踪可能会显著妨碍性能。
CursorPrepare 事件类数据列
| 数据列名称 | 数据类型 | DESCRIPTION | 列 ID | 可筛选 |
|---|---|---|---|---|
| ApplicationName | nvarchar | 创建到 SQL Server 实例连接的客户端应用程序的名称。 此列由应用程序传递的值填充,而不是由所显示的程序名填充。 | 10 | 是的 |
| ClientProcessID | int | 主机为运行该客户端应用程序的进程分配的 ID。 如果客户端提供了客户端进程 ID,则填充此数据列。 | 9 | 是的 |
| DatabaseID | int | 由 USE database 语句指定的数据库的 ID;如果未对给定实例发出 USE database 语句,则为默认数据库的 ID。 如果在跟踪中捕获 ServerName 数据列且服务器可用,SQL Server Profiler 将显示数据库名称。 可使用 DB_ID 函数来确定数据库的值。 | 3 | 是的 |
| 数据库名称 | nvarchar | 正在其中运行用户语句的数据库的名称。 | 35 | 是的 |
| EventClass | int | 记录的事件类型 = 70。 | 二十七 | 否 |
| EventSequence | int | Batch 中的 CursorPrepare 事件类的顺序。 | 51 | 否 |
| GroupID | int | 在其中激发 SQL 跟踪事件的工作负荷组的 ID。 | 66 | 是的 |
| 处理 | int | 事件类的句柄。 | 33 | 是的 |
| HostName | nvarchar | 正在运行客户端的计算机的名称。 如果客户端提供了主机名,则填充此数据列。 若要确定主机名,请使用 HOST_NAME 函数。 | 8 | 是的 |
| IsSystem | int | 指示事件是发生在系统进程中还是发生在用户进程中。 1 = 系统,0 = 用户。 | 六十 | 是的 |
| LoginName | nvarchar | 用户的登录名(SQL Server 安全登录名或域\用户名形式的 Windows 登录凭据)。 | 11 | 是的 |
| LoginSid | 图像 | 登录用户的安全标识号 (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 | 日期/时间 | 事件开始的时间(如果可用)。 | 14 | 是的 |
| TransactionID | bigint | 系统分配的事务 ID。 | 4 | 是的 |
| XactSequence | bigint | 用于说明当前事务的标记。 | 50 | 是的 |