Classe de evento CursorExecute

A classe de evento CursorExecute descreve eventos de execução do cursor que ocorrem em cursores APIs (interface de programação de aplicativo). Os eventos de execução do cursor ocorrem quando o Microsoft Mecanismo de Banco de Dados cria e popula um cursor pelo plano de execução criado por um evento de preparação do cursor.

Inclua a classe de evento CursorExecute em rastreamentos que estejam registrando o desempenho de cursores. Quando a classe de evento CursorRecompile está incluída no rastreamento, a quantidade de sobrecarga criada dependerá 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 CursorExecute

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 = 74.

27

 Não

EventSequence

int

Sequência da classe de evento CursorExecute 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 pela Biblioteca ODBC, OLE DB ou DB 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

Não

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

Identificação de solicitação que executou 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 usado para descrever a transação atual.

50

Sim

Consulte também

Referência

sp_trace_setevent (Transact-SQL)

Conceitos

Eventos estendidos

Cursores