• Artículo

CursorPrepare (clase de evento)

La clase de evento 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 tienen lugar cuando el Motor de base de datos de Microsoft 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 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 del programa que se muestra.

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. del 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 database para una instancia determinada. En SQL Server Profiler se 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 = 70.

27

No

EventSequence

int

Secuencia de la clase de evento CursorPrepare 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

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 (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

No

NTUserName

nvarchar

Nombre del usuario de Windows.

6

Sí

RequestID

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

Id. 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) utilizado para describir la transacción actual.

50

Sí