Classe de evento CursorOpen

A classe de evento CursorOpen descreve eventos de cursor aberto que ocorrem em cursores de interface de programas aplicativos (API). Os eventos de cursor aberto ocorrem quando o Mecanismo de Banco de Dados do SQL Server define a instrução SQL a ser associada ao cursor e às opções de cursor e, então, popula o cursor.

Inclua a classe de evento CursorOpen em rastreamentos que estão registrando o desempenho de cursores. Quando a classe de evento CursorOpen é incluída no rastreamento, a quantidade de sobrecarga criada depende da frequência de uso dos cursores em relação ao banco de dados durante o rastreamento. Se os cursores forem usados extensivamente, o rastreamento poderá diminuir significativamente o desempenho.

Colunas de dados da classe de evento CursorOpen

Nome da coluna de dados

Tipo de dados

Descrição

ID da coluna

Filtrável

ApplicationName

nvarchar

Nome do aplicativo cliente que criou a conexão com uma instância do SQL Server. Essa coluna é populada com os valores passados pelo aplicativo e não com o nome exibido do programa.

10

Sim

ClientProcessID

int

ID atribuída pelo computador host ao processo em que o aplicativo cliente está sendo executado. Essa coluna de dados será populada se o cliente fornecer a ID de processo do cliente.

9

Sim

DatabaseID

int

ID do banco de dados especificado pela instrução USE database ou o banco de dados padrão se nenhuma instrução USE databasetiver sido emitida para uma determinada instância. O SQL Server Profiler exibirá o nome do banco de dados se a coluna de dados ServerName for capturada no rastreamento e o servidor estiver disponível. Determine o valor para um banco de dados usando a função DB_ID.

3

Sim

DatabaseName

nvarchar

Nome do banco de dados no qual a instrução do usuário está sendo executada.

35

Sim

EventClass

int

Tipo de evento gravado = 53.

27

Não

EventSequence

int

Sequência da classe de evento CursorOpen no lote.

51

Não

GroupID

int

ID do grupo de carga de trabalho no qual o evento de Rastreamento do SQL dispara.

66

Sim

Handle

int

O inteiro usado por ODBC, OLE DB ou DB-Library para coordenar execução de servidor.

33

Sim

HostName

nvarchar

Nome do computador no qual o cliente está sendo executado. Essa coluna de dados será populada se o cliente fornecer o nome do host. Para determinar o nome do host, use a função HOST_NAME.

8

Sim

IntegerData

int

Tipo de cursor. Os valores são:

1 = Keyset

2 = Dinâmico

4 = Somente avanço

8 = Estático

16 = De avanço rápido

25

Sim

IsSystem

int

Indica se o evento ocorreu em um processo do sistema ou do usuário. 1 = sistema, 0 = usuário.

60

Sim

LoginName

nvarchar

Nome de logon do usuário (logon de segurança do SQL Server ou as credenciais de logon do Microsoft Windows no formato DOMÍNIO/nomedousuário).

11

Sim

LoginSid

image

SID (identificador de segurança) do usuário que fez logon. Você pode encontrar essas informações na exibição de catálogo sys.server_principals. Cada SID é exclusivo para cada logon no servidor.

41

Sim

NTDomainName

nvarchar

O domínio do Windows ao qual o usuário pertence.

7

Sim

NTUserName

nvarchar

Nome do usuário do Windows.

6

Sim

RequestID

int

Identificador da solicitação que abriu o cursor.

49

Sim

ServerName

nvarchar

Nome da instância do SQL Server que está sendo rastreada.

26

Não

SessionLoginName

nvarchar

Nome de logon do usuário que originou a sessão. Por exemplo, para se conectar ao SQL Server usando o Logon1 e executar uma instrução como Logon2, o SessionLoginName mostrará o Logon1 e o LoginName mostrará o Logon2. Essa coluna exibe logons do SQL Server e do Windows.

64

Sim

SPID

int

Identificação da sessão em que ocorreu o evento.

12

Sim

StartTime

datetime

Hora de início do evento, se disponível.

14

Sim

TransactionID

bigint

ID da transação atribuída pelo sistema.

4

Sim

XactSequence

bigint

Token que descreve a transação atual.

50

Sim

Consulte também

Referência

sp_trace_setevent (Transact-SQL)

Conceitos

Eventos estendidos

Cursores