CursorPrepare [clase de eventos]

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

La clase de eventos CursorPrepare describe los eventos de preparación de cursor que tienen lugar en los cursores de la interfaz de programación de aplicaciones (API). Los eventos de preparación de cursor se producen cuando Microsoft Motor de base de datos compila una instrucción SELECT asociada a un cursor en un plan de ejecución, pero no crea el cursor.

Incluya la clase de evento CursorPrepare en los seguimientos que registran el rendimiento de los cursores. Cuando la clase de evento CursorPrepare se incluye en un seguimiento, la cantidad de sobrecarga que se produce depende de la frecuencia con la que se utilicen los cursores en la base de datos durante el seguimiento. Si el uso de los cursores es extenso, el seguimiento puede obstaculizar el rendimiento de manera significativa.

Columnas de datos de la clase de evento CursorPrepare

Nombre de columna de datos	Tipo de datos	Descripción	Identificador de columna	Filtrable
ApplicationName	nvarchar	Nombre de la aplicación cliente que ha creado la conexión a una instancia de SQL Server. Esta columna se rellena con los valores que pasa la aplicación, en lugar de con el nombre que se muestra para el programa.	10	Sí
ClientProcessID	int	Identificador que el equipo host asigna al proceso en el que se ejecuta la aplicación cliente. Esta columna de datos se rellena si el cliente proporciona su identificador de proceso.	9	Sí
DatabaseID	int	Identificador de la base de datos especificada mediante la instrucción USE database o la base de datos predeterminada si no se emite la instrucción USE database para una determinada instancia. SQL Server Profiler muestra el nombre de la base de datos si se captura la columna de datos ServerName en el seguimiento y el servidor está disponible. Determina el valor de una base de datos mediante la función DB_ID.	3	Sí
DatabaseName	nvarchar	Nombre de la base de datos en la que se ejecuta la instrucción del usuario.	35	Sí
EventClass	int	Tipo de evento registrado = 70.	27	No
EventSequence	int	Secuencia de la clase de evento CursorPrepare en el lote.	51	No
GroupID	int	Id. del grupo de carga de trabajo donde se activa el evento de Seguimiento de SQL.	66	Sí
Handle	int	Identificador de la clase de evento.	33	Sí
HostName	nvarchar	Nombre del equipo en el que se está ejecutando el cliente. Esta columna de datos se rellena si el cliente proporciona el nombre del host. Para determinar el nombre del host, utilice la función HOST_NAME.	8	Sí
IsSystem	int	Indica si el evento ha ocurrido en un proceso del sistema o en un proceso de usuario. 1 = sistema, 0 = usuario.	60	Sí
LoginName	nvarchar	Nombre del inicio de sesión del usuario (inicio de sesión de seguridad de SQL Server o credenciales de inicio de sesión de Windows en formato DOMINIO\nombreDeUsuario).	11	Sí
LoginSid	image	SID (número de identificación de seguridad) del usuario que ha iniciado la sesión. Puede encontrar esta información en la vista de catálogo sys.server_principals . Cada SID es único para cada inicio de sesión en el servidor.	41	Sí
NTDomainName	nvarchar	Dominio de Windows al que pertenece el usuario.	7	No
NTUserName	nvarchar	Nombre del usuario de Windows.	6	Sí
IdSolicitud	int	Identificación de la solicitud que preparó el cursor.	49	Sí
ServerName	nvarchar	Nombre de la instancia de SQL Server de la que se realiza un seguimiento.	26	No
SessionLoginName	nvarchar	Nombre de inicio de sesión del usuario que originó la sesión. Por ejemplo, si se conecta a SQL Server usando inicioDeSesión1 y ejecuta una instrucción como inicioDeSesión2, SessionLoginName muestra inicioDeSesión1 y LoginName muestra inicioDeSesión2. En esta columna se muestran los inicios de sesión de SQL Server y de Windows.	64	Sí
SPID	int	Identificador de la sesión en la que se produjo el evento.	12	Sí
StartTime	datetime	Hora a la que se inició el evento, si está disponible.	14	Sí
TransactionID	bigint	Id. de la transacción asignado por el sistema.	4	Sí
XactSequence	bigint	Token que se utiliza para describir la transacción actual.	50	Sí

Consulte también

Eventos extendidos
sp_trace_setevent (Transact-SQL)
Cursores