CursorPrepare 事件类描述了应用程序编程接口 (API) 游标中发生的游标准备事件。当 Microsoft SQL Server 2005 数据库引擎 将与游标关联的 SELECT 语句编译到执行计划中但不创建该游标时，就会发生游标准备事件。
CursorPrepare 事件类包括在记录游标性能的跟踪中。当跟踪中包括 CursorPrepare 事件类时，所造成的开销数量取决于跟踪期间对数据库使用游标的频率。如果广泛使用游标，则跟踪可能会显著地降低性能。
CursorPrepare 事件类的数据列
| 数据列名称 | 数据类型 | 说明 | 列 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 |
是 |
DatabaseName |
nvarchar |
正在运行用户语句的数据库的名称。 |
35 |
是 |
EventClass |
int |
记录的事件类型 = 70。 |
27 |
否 |
EventSequence |
int |
CursorPrepare 事件类在批处理中的顺序。 |
51 |
否 |
Handle |
int |
事件类的处理程序。 |
33 |
是 |
HostName |
nvarchar |
正在运行客户端的计算机的名称。如果客户端提供了主机名，则填充此数据列。若要确定主机名，请使用 HOST_NAME 函数。 |
8 |
是 |
IsSystem |
int |
指示事件是发生在系统进程还是发生在用户进程。1 = 系统，0 = 用户。 |
60 |
是 |
LoginName |
nvarchar |
用户的登录名（SQL Server 安全登录名或 Windows 登录凭据，格式为“域\用户名”）。 |
11 |
是 |
LoginSid |
image |
登录用户的安全标识号 (SID)。您可以在 master 数据库的 syslogins 表中找到此信息。服务器中的每个登录名都具有唯一的 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 |
是 |
请参阅
概念
其他资源
监视事件
sp_trace_setevent (Transact-SQL)