classe de evento CursorPrepare

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstâ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 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 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 USE de database ou o banco de dados padrão se nenhuma instrução USE de database tiver sido emitida para uma determinada instância. 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 de logon do usuário (logon de segurança do SQL Server ou as credenciais de logon do Windows na forma de DOMAIN\nome_do_usuário).	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, 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	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

Consulte Também

Eventos estendidos
sp_trace_setevent (Transact-SQL)
Cursores