CursorOpen (clase de evento)
La clase de evento 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 SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005) de Microsoft 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 las trazas que registran el rendimiento de los cursores. Cuando la clase de evento CursorOpen se incluye en una traza, la cantidad de sobrecarga impuesta depende de la frecuencia con la que se utilicen los cursores en la base de datos durante la traza. Si el uso de los cursores es extenso, la traza puede obstaculizar el rendimiento de manera significativa.
Columnas de datos de la clase de evento CursorOpen
| Nombre de la columna de datos | Tipo de datos | Descripción | Id. 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 del 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 Id. de proceso del cliente. |
9 |
Sí |
DatabaseID |
int |
Id. de la base de datos especificada en la instrucción USE database o la base de datos predeterminada si no se emitió ninguna instrucción USE databasepara una instancia determinada. El Analizador de SQL Server muestra el nombre de la base de datos si se captura la columna de datos ServerName en la traza y el servidor está disponible. El valor para una base de datos se puede determinar mediante la función DB_ID. |
3 |
Sí |
DatabaseName |
nvarchar |
Nombre de la base de datos en 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 |
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 = Sólo 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 en formato DOMINIO\nombreDeUsuario). |
11 |
Sí |
LoginSid |
image |
SID (identificador de seguridad) del usuario que ha iniciado la sesión. Puede encontrar esta información en la tabla syslogins de la base de datos master. 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 de usuario de Windows. |
6 |
Sí |
RequestID |
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 |
Id. de la sesión en la que se ha producido 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í |
Vea también
Conceptos
Cursores (motor de base de datos)
Otros recursos
Supervisar eventos
sp_trace_setevent (Transact-SQL)