Classe de evento CursorOpen

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

A classe de evento CursorOpen descreve eventos de cursor aberto que ocorrem em cursores da API (interface de programação de aplicativos). Os eventos de abertura do cursor ocorrem quando o Mecanismo de Banco de Dados do SQL Server define a instrução SQL a ser associada ao cursor e às opções de cursor e, em seguida, preenche o cursor.

Inclua a classe de evento CursorOpen em rastreamentos que estão gravando o desempenho de cursores. Quando a classe de evento CursorOpen é incluída no rastreamento, a quantidade de sobrecarga criada depende 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 CursorOpen

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	A ID do banco de dados especificada pela instrução USE database ou a ID do banco de dados padrão se nenhuma instrução USE databasetiver sido emitida para 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 = 53.	27	Não
EventSequence	int	Sequência da classe de evento CursorOpen 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 por ODBC, OLE DB ou DB-Library 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	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 Microsoft Windows na forma de DOMAIN\username).	11	Sim
LoginSid	imagem	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	Identificador da solicitação que abriu 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	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 que descreve a transação atual.	50	Sim

Confira também

Eventos estendidos
sp_trace_setevent (Transact-SQL)
Cursores