• Artigo

Classe de evento CursorPrepare

A classe de evento do CursorPrepare descreve os eventos de preparação do cursor que acontecem nos cursores API (interface de programação de aplicativos). Os eventos de preparação do cursor ocorrem quando o Microsoft Mecanismo de Banco de Dados compila uma instrução SELECT associada a um cursor em um plano de execução, mas não cria o cursor.

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

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 do cliente está sendo executado. Essa coluna de dados será populada se o ID do processo cliente for fornecido pelo cliente.

9

Sim

DatabaseID

int

ID do banco de dados especificado pela instrução de USE database ou do banco de dados padrão, se nenhuma instrução USE database USE tiver sido emitida para uma determinada instância. O SQL Server Profiler exibirá o nome do banco de dados se a coluna de dados do ServerName for capturada no rastreamento e o servidor estiver disponível. O valor de um banco de dados pode ser determinado com 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 = 70.

27

Não

EventSequence

int

Seqüência da classe de evento CursorPrepare no lote.

51

Não

GroupID

int

ID do grupo de cargas de trabalho no qual o evento Rastreamento SQL é disparado.

66

Sim

Handle

int

Manipulador da classe de evento.

33

Sim

HostName

nvarchar

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

8

Sim

IsSystem

int

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

60

Sim

LoginName

nvarchar

Nome do logon do usuário (logon de segurança do SQL Server ou as credenciais de logon do Windows na forma de DOMAIN\username).

11

Sim

LoginSid

image

Número SID (identificação 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 de cada logon no servidor.

41

Sim

NTDomainName

nvarchar

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

7

Não

NTUserName

nvarchar

Nome de usuário do Windows.

6

Sim

RequestID

int

Identificação de solicitação que preparou 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, ao se conectar ao SQL Server usando Login1 e executar uma instrução como Login2, SessionLoginName mostrará Login1 e LoginName mostrará Login2. Essa coluna exibe logons do SQL Server e do Windows.

64

Sim

SPID

int

ID da sessão na qual ocorreu o evento.

12

Sim

StartTime

datetime

Hora em que o evento foi iniciado, quando disponível.

14

Sim

TransactionID

bigint

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

4

Sim

XactSequence

bigint

Token usado para descrever a transação atual.

50

Sim