CursorPrepare 事件类

适用于: SQL Server Azure SQL 数据库 Azure SQL 托管实例

CursorPrepare 事件类描述了应用程序编程接口 (API) 游标中发生的游标准备事件。 当Microsoft数据库引擎将与游标关联的 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
GroupID int 在其中激发 SQL 跟踪事件的工作负荷组的 ID。 66
Handle int 事件类的处理程序。 33
HostName nvarchar 正在运行客户端的计算机的名称。 如果客户端提供了主机名,则填充此数据列。 若要确定主机名,请使用 HOST_NAME 函数。 8
IsSystem int 指示事件是发生在系统进程中还是发生在用户进程中。 1 = 系统,0 = 用户。 60
LoginName nvarchar 用户的登录名(SQL Server 安全登录名或域\用户名形式的 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

另请参阅

扩展事件
sp_trace_setevent (Transact-SQL)
光标