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