• Artículo

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 Database Engine (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 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 por la instrucción USE database o la base de datos predeterminada si no se emitió ninguna instrucción USE databasepara una instancia determinada. El 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. 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

GroupID

int

Id. del grupo de cargas de trabajo donde se activa el evento de Seguimiento 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 = 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 buscar 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 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í