CursorOpen, clase de eventos

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

La clase de eventos CursorOpen describe los eventos de cursor abierto que tienen lugar en los cursores de la interfaz de programación de aplicaciones (API). Los eventos de cursor abierto ocurren cuando el Motor de base de datos de SQL Server define la instrucción SQL que se desea asociar con el cursor y las opciones de cursor y, a continuación, rellena el cursor.

Incluya la clase de evento CursorOpen en los seguimientos que registran el rendimiento de los cursores. Cuando la clase de evento CursorOpen se incluye en un seguimiento, la cantidad de sobrecarga impuesta 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 CursorOpen

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 el identificador de proceso del cliente.	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 databasepara 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 = 53.	27	No
EventSequence	int	Secuencia de la clase de evento CursorOpen 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	Valor entero utilizado por ODBC, OLE DB o DB-Library para coordinar la ejecución con el servidor.	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í
IntegerData	int	Tipo de cursor. Los valores son: 1 = Conjunto de claves 2 = Dinámico 4 = Solo avance 8 = Estático 16 = Avance rápido	25	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 Microsoft Windows con el 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	Sí
NTUserName	nvarchar	Nombre del usuario de Windows.	6	Sí
IdSolicitud	int	Identificador de la solicitud que ha abierto 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	Símbolo (token) que describe la transacción actual.	50	Sí

Consulte también

Eventos extendidos
sp_trace_setevent (Transact-SQL)
Cursores