Partilhar via


classe de evento CursorPrepare

Aplica-se a: SQL ServerBanco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

A classe de evento CursorPrepare descreve os eventos de preparação do cursor que acontecem nos cursores da API (interface de programação de aplicativos). Os eventos de preparação do cursor ocorrem quando o Mecanismo de Banco de Dados da Microsoft 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 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 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 cliente está sendo executado. Essa coluna de dados será populada se a ID do processo do cliente for fornecida pelo cliente. 9 Sim
DatabaseID int ID do banco de dados especificado pela instrução de banco de dados USE ou o banco de dados padrão se nenhuma instrução de banco de dados 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 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 registrado = 70. 27 Não
EventSequence int Sequência da classe de evento CursorPrepare 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 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 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 imagem 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 para cada logon no servidor. 41 Sim
NTDomainName nvarchar O domínio do Windows ao qual o usuário pertence. 7 Não
NTUserName nvarchar Nome do 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, se você se conectar ao SQL Server usando Login1 e executar uma instrução como Login2, SessionLoginName mostrará Login1 e LoginName mostrará Login2. Esta 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 Horário de início do evento, quando 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

Confira também

Eventos estendidos
sp_trace_setevent (Transact-SQL)
Cursores