sp_trace_setevent (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Adiciona ou remove um evento ou coluna de eventos a um rastreamento. sp_trace_setevent pode ser executado somente em rastreamentos existentes que são interrompidos (@status é 0). Um erro será retornado se esse procedimento armazenado for executado em um rastreamento que não existe ou cujo @status não 0é .

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use Eventos Estendidos.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_trace_setevent
    [ @traceid = ] traceid
    , [ @eventid = ] eventid
    , [ @columnid = ] columnid
    , [ @on = ] on
[ ; ]

Argumentos

@traceid [ = ] traceid

A ID do rastreamento a ser modificado. @traceid é int, sem padrão. O usuário emprega esse valor @traceid para identificar, modificar e controlar o rastreamento.

@eventid [ = ] eventid

A ID do evento a ser ativado. @eventid é int, sem padrão.

Esta tabela lista os eventos que podem ser adicionados ou removidos de um rastreamento.

Número do evento Nome do evento Descrição
0 em 9 Reserved Reserved
10 RPC:Completed Ocorre quando uma RPC (chamada de procedimento remoto) é concluída.
11 RPC:Starting Ocorre quando uma RPC é iniciada.
12 SQL:BatchCompleted Ocorre quando um lote Transact-SQL é concluído.
13 SQL:BatchStarting Ocorre quando um lote Transact-SQL é iniciado.
14 Audit Login Ocorre quando um usuário faz logon com êxito no SQL Server.
15 Audit Logout Ocorre quando um usuário sai do SQL Server.
16 Attention Ocorre quando eventos de atenção, como solicitações de interrupção de cliente ou conexões de cliente interrompidas, acontecem.
17 ExistingConnection Detecta todas as atividades dos usuários conectados ao SQL Server antes do início do rastreamento.
18 Audit Server Starts and Stops Ocorre quando o estado do serviço SQL Server é modificado.
19 DTCTransaction Rastreia transações coordenadas do MS DTC (Coordenador de Transações Distribuídas da Microsoft) entre dois ou mais bancos de dados.
20 Audit Login Failed Indica que uma tentativa de logon no SQL Server de um cliente falhou.
21 EventLog Indica que os eventos foram registrados no log de aplicativo do Windows.
22 ErrorLog Indica que os eventos de erro foram registrados no log de erros do SQL Server.
23 Lock:Released Indica que um bloqueio em um recurso, como uma página, foi liberado.
24 Lock:Acquired Indica a aquisição de um bloqueio em um recurso, como uma página de dados.
25 Lock:Deadlock Indica que duas transações simultâneas fizeram deadlock uma na outra ao tentar obter bloqueios incompatíveis em recursos de propriedade da outra transação.
26 Lock:Cancel Indica que a aquisição de um bloqueio em um recurso foi cancelada (por exemplo, devido a um deadlock).
27 Lock:Timeout Indica que uma solicitação para um bloqueio em um recurso, como uma página, expirou por causa de outra transação que estava mantendo um bloqueio no recurso necessário. O tempo limite é determinado pela função @@LOCK_TIMEOUT e pode ser definido com a instrução SET LOCK_TIMEOUT.
28 Degree of Parallelism Event Acontece antes de uma instrução SELECT, INSERT ou UPDATE ser executada.
29 em 31 Reserved Use o Evento 28 em vez disso.
32 Reserved Reserved
33 Exception Indica que ocorreu uma exceção no SQL Server.
34 SP:CacheMiss Indica quando um procedimento armazenado não é encontrado no cache de procedimentos.
35 SP:CacheInsert Indica quando um item é inserido no cache de procedimento.
36 SP:CacheRemove Indica quando um item é removido do cache de procedimento.
37 SP:Recompile Indica que um procedimento armazenado foi recompilado.
38 SP:CacheHit Indica quando um procedimento armazenado é localizado no cache de procedimento.
39 Deprecated Preterido
40 SQL:StmtStarting Ocorre quando a instrução Transact-SQL é iniciada.
41 SQL:StmtCompleted Ocorre quando a instrução Transact-SQL é concluída.
42 SP:Starting Indica quando o procedimento armazenado é iniciado.
43 SP:Completed Indica quando o procedimento armazenado é concluído.
44 SP:StmtStarting Indica que uma instrução Transact-SQL em um procedimento armazenado começou a ser executada.
45 SP:StmtCompleted Indica que uma instrução Transact-SQL em um procedimento armazenado terminou de ser executada.
46 Object:Created Indica que um objeto foi criado, tal como para as instruções CREATE INDEX, CREATE TABLE e CREATE DATABASE.
47 Object:Deleted Indica que um objeto foi excluído, tal como nas instruções DROP INDEX e DROP TABLE.
48 Reserved
49 Reserved
50 SQL Transaction Rastreia instruções Transact-SQL BEGIN, COMMIT, SAVE e ROLLBACK TRANSACTION.
51 Scan:Started Indica quando foi iniciada uma verificação de tabela ou de índice.
52 Scan:Stopped Indica quando foi interrompida uma verificação de tabela ou de índice.
53 CursorOpen Indica quando um cursor é aberto em uma instrução Transact-SQL por ODBC, OLE DB ou DB-Library.
54 TransactionLog Rastreia quando as transações são gravadas no log de transações.
55 Hash Warning Indica que uma operação de hash (por exemplo, junção de hash, agregação de hash, união de hash e hash distinto) que não está sendo processada em uma partição de buffer foi revertida para um plano alternativo. Isso pode ocorrer por causa de profundidade de recursão, distorção de dados, sinalizadores de rastreamento ou contagem de bits.
56 em 57 Reserved
58 Auto Stats Indica que ocorreu uma atualização automática de estatísticas de índice.
59 Lock:Deadlock Chain Produzido para cada um dos eventos que resultam no deadlock.
60 Lock:Escalation Indica que um bloqueio mais refinado foi convertido em um bloqueio mais rústico (por exemplo, um bloqueio de página escalonado ou convertido em um bloqueio TABLE ou HoBT).
61 OLE DB Errors Indica que ocorreu um erro OLE DB.
62 em 66 Reserved
67 Execution Warnings Indica todos os avisos ocorridos durante a execução de uma instrução ou procedimento armazenado do SQL Server.
68 Showplan Text (Unencoded) Exibe a árvore de planos da instrução Transact-SQL executada.
69 Sort Warnings Indica operações de classificação que não cabem na memória. Não inclui operações de classificação que envolvem a criação de índices; classificar apenas operações dentro de uma consulta (como uma cláusula ORDER BY usada em uma instrução SELECT).
70 CursorPrepare Indica quando um cursor em uma instrução Transact-SQL é preparado para uso por ODBC, OLE DB ou DB-Library.
71 Prepare SQL ODBC, OLE DB ou DB-Library preparou uma instrução ou instruções Transact-SQL para uso.
72 Exec Prepared SQL ODBC, OLE DB ou DB-Library executou uma instrução ou instruções Transact-SQL preparadas.
73 Unprepare SQL ODBC, OLE DB ou DB-Library despreparou (excluiu) uma instrução ou instruções Transact-SQL preparadas.
74 CursorExecute Um cursor previamente preparado em uma instrução Transact-SQL por ODBC, OLE DB ou DB-Library é executado.
75 CursorRecompile Um cursor aberto em uma instrução Transact-SQL por ODBC ou DB-Library foi recompilado diretamente ou devido a uma alteração de esquema.

Disparado para cursores ANSI e não ANSI.
76 CursorImplicitConversion Um cursor em uma instrução Transact-SQL é convertido pelo SQL Server de um tipo para outro.

Disparado para cursores ANSI e não ANSI.
77 CursorUnprepare Um cursor preparado em uma instrução Transact-SQL não é preparado (excluído) por ODBC, OLE DB ou DB-Library.
78 CursorClose Um cursor aberto anteriormente em uma instrução Transact-SQL por ODBC, OLE DB ou DB-Library é fechado.
79 Missing Column Statistics As estatísticas de coluna que poderiam ter sido úteis para o otimizador não estão disponíveis.
80 Missing Join Predicate A consulta que não é nenhum predicado de junção está sendo executada. Isso pode resultar em uma consulta de longa execução.
81 Server Memory Change O uso de memória do SQL Server aumentou ou diminuiu em 1 megabyte (MB) ou 5% da memória máxima do servidor, o que for maior.
82 em 91 User Configurable (0 - 9) Dados de evento definidos pelo usuário.
92 Data File Auto Grow Indica que um arquivo de dados foi automaticamente estendido pelo servidor.
93 Log File Auto Grow Indica que um arquivo de log foi automaticamente estendido pelo servidor.
94 Data File Auto Shrink Indica que um arquivo de dados foi automaticamente reduzido pelo servidor.
95 Log File Auto Shrink Indica que um arquivo de log foi automaticamente reduzido pelo servidor.
96 Showplan Text Exibe a árvore de plano de consulta da instrução SQL a partir do otimizador de consulta. A TextData coluna não contém o Plano de Execução para este evento.
97 Showplan All Exibe o plano de consulta com detalhes completos de tempo de compilação da instrução SQL executada. A TextData coluna não contém o Plano de Execução para este evento.
98 Showplan Statistics Profile Exibe o plano de consulta com detalhes completos de tempo de execução da instrução SQL executada. A TextData coluna não contém o Plano de Execução para este evento.
99 Reserved
100 RPC Output Parameter Produz valores de saída dos parâmetros para todo RPC.
101 Reserved
102 Audit Database Scope GDR Ocorre sempre que uma permissão GRANT, DENY, REVOKE para uma instrução é emitida por qualquer usuário no SQL Server para ações somente de banco de dados, como conceder permissões em um banco de dados.
103 Audit Object GDR Event Ocorre sempre que uma permissão GRANT, DENY, REVOKE para um objeto é emitida por qualquer usuário no SQL Server.
104 Audit AddLogin Event Ocorre quando um logon do SQL Server é adicionado ou removido; para sp_addlogin e sp_droplogin.
105 Audit Login GDR Event Ocorre quando um direito de logon do Windows é adicionado ou removido; para sp_grantlogin, sp_revokelogine sp_denylogin.
106 Audit Login Change Property Event Ocorre quando uma propriedade de um login, exceto senhas, é modificada; para sp_defaultdb e sp_defaultlanguage.
107 Audit Login Change Password Event Ocorre quando uma senha de logon do SQL Server é alterada.

As senhas não são registradas.
108 Audit Add Login to Server Role Event Ocorre quando um logon é adicionado ou removido de uma função de servidor fixa; para sp_addsrvrolemember, e sp_dropsrvrolemember.
109 Audit Add DB User Event Ocorre quando um logon é adicionado ou removido como usuário de banco de dados (Windows ou SQL Server) em um banco de dados; para sp_grantdbaccess, sp_revokedbaccess, sp_addusere sp_dropuser.
110 Audit Add Member to DB Role Event Ocorre quando um logon é adicionado ou removido como um usuário de banco de dados (fixo ou definido pelo usuário) em um banco de dados; para sp_addrolemember, sp_droprolemembere sp_changegroup.
111 Audit Add Role Event Ocorre quando um logon é adicionado ou removido como um usuário de banco de dados para um banco de dados; para sp_addrole e sp_droprole.
112 Audit App Role Change Password Event Ocorre quando uma senha de uma função de aplicativo é alterada.
113 Audit Statement Permission Event Ocorre quando uma permissão de instrução (como CREATE TABLE) é usada.
114 Audit Schema Object Access Event Ocorre quando uma permissão de objeto (como SELECT) é usada, com êxito ou não.
115 Audit Backup/Restore Event Ocorre quando um comando BACKUP ou RESTORE é emitido.
116 Audit DBCC Event Ocorre quando comandos DBCC são emitidos.
117 Audit Change Audit Event Ocorre quando são feitas modificações de rastreamento de auditoria.
118 Audit Object Derived Permission Event Ocorre quando um comando de objeto CREATE, ALTER e DROP é emitido.
119 OLEDB Call Event Ocorre quando as chamadas de provedor OLE DB são feitas para consultas distribuídas e procedimentos armazenados remotos.
120 OLEDB QueryInterface Event Ocorre quando as chamadas OLE DB QueryInterface são feitas para consultas distribuídas e procedimentos armazenados remotos.
121 OLEDB DataRead Event Ocorre quando uma chamada de solicitação de dados é feita ao provedor OLE DB.
122 Showplan XML Ocorre quando uma instrução SQL é executada. Inclua este evento para identificar operadores de plano de execução. Cada evento é armazenado em um documento XML bem formado. A Binary coluna desse evento contém o Plano de Execução codificado. Use o SQL Server Profiler para abrir o rastreamento e exibir o plano de execução.
123 SQL:FullTextQuery Ocorre quando uma consulta de texto completo é executada.
124 Broker:Conversation Relata o progresso de uma conversa do Service Broker.
125 Deprecation Announcement Ocorre quando você usa um recurso que será removido de uma versão futura do SQL Server.
126 Deprecation Final Support Ocorre quando você usa um recurso que será removido da próxima versão principal do SQL Server.
127 Exchange Spill Event Ocorre quando buffers de comunicação em um plano de consulta paralela foram gravados temporariamente no tempdb banco de dados.
128 Audit Database Management Event Ocorre quando um banco de dados é criado, alterado ou descartado.
129 Audit Database Object Management Event Ocorre quando uma instrução CREATE, ALTER ou DROP é executada em objetos de banco de dados, como esquemas.
130 Audit Database Principal Management Event Ocorre quando os principais, como usuários, são criados, alterados ou descartados de um banco de dados.
131 Audit Schema Object Management Event Ocorre quando objetos de servidor são criados, alterados ou descartados.
132 Audit Server Principal Impersonation Event Ocorre quando há uma representação no escopo do servidor, como EXECUTE AS LOGIN.
133 Audit Database Principal Impersonation Event Ocorre quando uma representação acontece no escopo de banco de dados, como EXECUTE AS USER ou SETUSER.
134 Audit Server Object Take Ownership Event Ocorre quando o proprietário é alterado para objetos no escopo de servidor.
135 Audit Database Object Take Ownership Event Ocorre quando acontece uma alteração de proprietário para objetos no escopo de banco de dados.
136 Broker:Conversation Group Ocorre quando o Service Broker cria um novo grupo de conversação ou descarta um grupo de conversação existente.
137 Blocked Process Report Ocorre quando um processo foi bloqueado para mais do que um período especificado. Não inclui processos do sistema ou processos que estão aguardando recursos não detectáveis por deadlock. Use sp_configure para configurar o limite e a frequência com que os relatórios são gerados.
138 Broker:Connection Relata o status de uma conexão de transporte gerenciada pelo Service Broker.
139 Broker:Forwarded Message Sent Ocorre quando o Service Broker encaminha uma mensagem.
140 Broker:Forwarded Message Dropped Ocorre quando o Service Broker descarta uma mensagem que deveria ser encaminhada.
141 Broker:Message Classify Ocorre quando o Service Broker determina o roteamento de uma mensagem.
142 Broker:Transmission Indica que ocorreram erros na camada de transporte do Service Broker. O número do erro e os valores de estado indicam a origem do erro.
143 Broker:Queue Disabled Indica que uma mensagem suspeita foi detectada porque houve cinco reversões de transação consecutivas em uma fila do Service Broker. O evento contém a ID do banco de dados e a ID de fila da fila que contém a mensagem suspeita.
144 em 145 Reserved
146 Showplan XML Statistics Profile Ocorre quando uma instrução SQL é executada. Identifica os operadores de plano de execução e exibe dados de tempo de compilação completos. A Binary coluna desse evento contém o Plano de Execução codificado. Use o SQL Server Profiler para abrir o rastreamento e exibir o plano de execução.
148 Deadlock Graph Ocorre quando uma tentativa para adquirir um bloqueio é cancelada porque a tentativa fazia parte de um deadlock e foi escolhida como a vítima de deadlock. Fornece uma descrição XML de um deadlock.
149 Broker:Remote Message Acknowledgement Ocorre quando o Service Broker envia ou recebe uma confirmação de mensagem.
150 Trace File Close Ocorre quando um arquivo de rastreamento é fechado durante a sua substituição.
151 Reserved
152 Audit Change Database Owner Ocorre quando a instrução ALTER AUTHORIZATION é usada para alterar o proprietário de um banco de dados e as permissões são marcadas para fazer isso.
153 Audit Schema Object Take Ownership Event Ocorre quando a instrução ALTER AUTHORIZATION é usada para atribuir um proprietário a um objeto e as permissões para fazer isso estão marcadas.
154 Reserved
155 FT:Crawl Started Ocorre quando um rastreamento (população) de texto completo é iniciado. Use para verificar se uma solicitação de rastreamento está sendo selecionada por tarefas de trabalhado.
156 FT:Crawl Stopped Ocorre quando um rastreamento (população) de texto completo é interrompido. As interrupções acontecem quando um rastreamento é concluído com êxito ou quando ocorre um erro fatal.
157 FT:Crawl Aborted Ocorre quando uma exceção é encontrada em um rastreamento de texto completo. Em geral, provoca a interrupção do rastreamento de texto completo.
158 Audit Broker Conversation Informa mensagens de auditoria relacionadas à segurança do diálogo Service Broker.
159 Audit Broker Login Informa mensagens de auditoria relacionadas à segurança de transporte do Service Broker.
160 Broker:Message Undeliverable Ocorre quando o Service Broker não consegue reter uma mensagem recebida que deveria ter sido entregue a um serviço.
161 Broker:Corrupted Message Ocorre quando o Service Broker recebe uma mensagem corrompida.
162 User Error Message Exibe mensagens de erro que os usuários veem no caso de um erro ou uma exceção.
163 Broker:Activation Ocorre quando um monitor de filas inicia um procedimento armazenado de ativação, envia uma QUEUE_ACTIVATION notificação ou quando um procedimento armazenado de ativação iniciado por um monitor de filas é encerrado.
164 Object:Altered Ocorre quando um objeto de banco de dados é alterado.
165 Performance statistics Ocorre quando um plano de consulta compilado foi armazenado em cache pela primeira vez, recompilado ou removido do cache do plano.
166 SQL:StmtRecompile Ocorre quando uma recompilação do nível de instrução acontece.
167 Database Mirroring State Change Ocorre quando o estado de um banco de dados espelho é alterado.
168 Showplan XML For Query Compile Ocorre quando uma instrução SQL é compilada. Exibe os dados de tempo de compilação completos. A Binary coluna desse evento contém o Plano de Execução codificado. Use o SQL Server Profiler para abrir o rastreamento e exibir o plano de execução.
169 Showplan All For Query Compile Ocorre quando uma instrução SQL é compilada. Exibe dados completos em tempo de compilação. Use para identificar operadores de plano de execução.
170 Audit Server Scope GDR Event Indica que ocorreu um evento de concessão, recusa ou revogação para permissões no escopo de servidor, tal como criar um logon.
171 Audit Server Object GDR Event Indica que ocorreu um evento de concessão, negação ou revogação para um objeto de esquema, tal como uma tabela ou função.
172 Audit Database Object GDR Event Indica que ocorreu um evento de concessão, negação ou revogação para objetos de banco de dados, tal como assemblies e esquemas.
173 Audit Server Operation Event Ocorre quando são usadas operações de Segurança Auditoria, tal como alterar configurações, recursos, acesso externo ou autorização.
175 Audit Server Alter Trace Event Ocorre quando uma instrução verifica a permissão ALTER TRACE.
176 Audit Server Object Management Event Ocorre quando objetos de servidor são criados, alterados ou descartados.
177 Audit Server Principal Management Event Ocorre quando principais são criados, alterados ou descartados.
178 Audit Database Operation Event Ocorre quando ocorrem operações de banco de dados, tal como ponto de verificação ou notificação de consulta de assinatura.
180 Audit Database Object Access Event Ocorre quando são acessados objetos de banco de dados, tal como esquemas.
181 TM: Begin Tran starting Ocorre quando uma BEGIN TRANSACTION solicitação é iniciada.
182 TM: Begin Tran completed Ocorre quando uma BEGIN TRANSACTION solicitação é concluída.
183 TM: Promote Tran starting Ocorre quando uma PROMOTE TRANSACTION solicitação é iniciada.
184 TM: Promote Tran completed Ocorre quando uma PROMOTE TRANSACTION solicitação é concluída.
185 TM: Commit Tran starting Ocorre quando uma COMMIT TRANSACTION solicitação é iniciada.
186 TM: Commit Tran completed Ocorre quando uma COMMIT TRANSACTION solicitação é concluída.
187 TM: Rollback Tran starting Ocorre quando uma ROLLBACK TRANSACTION solicitação é iniciada.
188 TM: Rollback Tran completed Ocorre quando uma ROLLBACK TRANSACTION solicitação é concluída.
189 Lock:Timeout (timeout > 0) Ocorre quando uma solicitação para um bloqueio em um recurso, como uma página, expira.
190 Progress Report: Online Index Operation Relata o progresso de uma operação de criação de índice online quando o processo de criação está sendo executado.
191 TM: Save Tran starting Ocorre quando uma SAVE TRANSACTION solicitação é iniciada.
192 TM: Save Tran completed Ocorre quando uma SAVE TRANSACTION solicitação é concluída.
193 Background Job Error Ocorre quando um trabalho em segundo plano é terminado de maneira anormal.
194 OLEDB Provider Information Ocorre quando uma consulta distribuída é executada e coleta informações que correspondem à conexão de provedor.
195 Mount Tape Ocorre quando uma solicitação de montagem de fita é recebida.
196 Assembly Load Ocorre quando acontece uma solicitação para carregar um assembly CLR.
197 Reserved
198 XQuery Static Type Ocorre quando uma expressão XQuery é executada. Essa classe de evento fornece o tipo estático da expressão XQuery.
199 QN: subscription Ocorre quando um registro de consulta não pode ser assinado. A TextData coluna contém informações sobre o evento.
200 QN: parameter table Informações sobre assinaturas ativas são armazenadas em tabelas de parâmetro internas. Esta classe de evento ocorre quando uma tabela de parâmetro é criada ou excluída. Normalmente, essas tabelas são criadas ou excluídas quando o banco de dados é reiniciado. A TextData coluna contém informações sobre o evento.
201 QN: template Um modelo de consulta representa uma classe de consultas de assinatura. Normalmente, as consultas de mesma classe são idênticas com exceção dos valores de parâmetro. Essa classe de evento ocorre quando uma nova solicitação de assinatura se enquadra em uma classe já existente de (Match), uma nova classe (Create) ou uma Drop classe, que indica a limpeza de modelos para classes de consulta sem assinaturas ativas. A TextData coluna contém informações sobre o evento.
202 QN: dynamics Rastreia atividades internas de notificações de consulta. A TextData coluna contém informações sobre o evento.
212 Bitmap Warning Indica quando os filtros do bitmap foram desabilitados em uma consulta.
213 Database Suspect Data Page Indica quando uma página é adicionada à suspect_pages tabela em msdb.
214 CPU threshold exceeded Indica quando o Administrador de Recursos detecta que uma consulta excedeu o valor limite da CPU (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Indica quando uma função do gatilho LOGON ou do classificador Administrador de Recursos inicia a execução.
216 PreConnect:Completed Indica quando uma função do gatilho LOGON ou do classificador Administrador de Recursos conclui a execução.
217 Plan Guide Successful Indica que o Mecanismo de Banco de Dados produziu com êxito um plano de execução para uma consulta ou lote que continha um guia de plano.
218 Plan Guide Unsuccessful Indica que o Mecanismo de Banco de Dados não pôde produzir um plano de execução para uma consulta ou lote que continha um guia de plano. O Mecanismo de Banco de Dados tentou gerar um plano de execução para essa consulta ou lote sem aplicar o guia de plano. Um guia de plano inválido pode ser a causa desse problema. É possível validar o guia de plano usando a função do sys.fn_validate_plan_guide sistema.
235 Audit Fulltext

@columnid [ = ] columnid

A ID da coluna a ser adicionada para o evento. @columnid é int, sem padrão.

A tabela a seguir lista as colunas que podem ser adicionadas a um evento.

Column number Nome da coluna Descrição
1 TextData Valor de texto dependente da classe de evento capturada no rastreamento.
2 BinaryData Valor binário dependente da classe de evento capturada no rastreamento.
3 DatabaseID 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 for emitida para uma determinada conexão.

O valor para um banco de dados pode ser determinado usando a função DB_ID.
4 TransactionID ID da transação atribuída pelo sistema.
5 LineNumber O número da linha que contém o erro. Para eventos que envolvem instruções Transact-SQL, como SP:StmtStarting, o LineNumber contém o número de linha da instrução no procedimento armazenado ou no lote.
6 NTUserName Nome do usuário do Windows.
7 NTDomainName O domínio do Windows ao qual o usuário pertence.
8 HostName Nome do computador cliente que originou a solicitação.
9 ClientProcessID ID atribuída pelo computador cliente ao processo no qual o aplicativo cliente está sendo executado.
10 ApplicationName 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.
11 LoginName Nome de logon do SQL Server do cliente.
12 SPID ID do processo do servidor atribuída pelo SQL Server ao processo associado ao cliente.
13 Duration Tempo decorrido (em milhões de segundos) utilizado pelo evento. Essa coluna de dados não é preenchida Hash Warning pelo evento.
14 StartTime Horário de início do evento, quando disponível.
15 EndTime Hora em que o evento foi encerrado. Essa coluna não é preenchida para iniciar classes de evento, como SQL:BatchStarting ou SP:Starting. Também não é preenchido Hash Warning pelo evento.
16 Reads Número de leituras lógicas do disco executadas pelo servidor em nome do evento. Essa coluna não é preenchida Lock:Released pelo evento.
17 Writes Número de gravações no disco físico executadas pelo servidor em nome do evento.
18 CPU Tempo da CPU (em milissegundos) usado pelo evento.
19 Permissions Representa o bitmap de permissões; usada pela Security Auditing.
20 Severity Nível de severidade de uma exceção.
21 EventSubClass Tipo de subclasse de evento. Essa coluna de dados não é preenchida para todas as classes de evento.
22 ObjectID ID de objeto atribuída pelo sistema.
23 Success Êxito da tentativa de uso de permissões; usada para auditoria.

1 = sucesso
0 = falha
24 IndexID ID do índice no objeto afetado pelo evento. Para determinar a ID de índice de um objeto, use a indid sysindexes coluna da tabela do sistema.
25 IntegerData O valor inteiro dependente da classe de evento capturada no rastreamento.
26 ServerName Nome da instância do SQL Server, servername ou servername\instancename, que está sendo rastreada.
27 EventClass Tipo de classe de evento que está sendo registrada.
28 ObjectType Tipo de objeto, como tabela, função ou procedimento armazenado.
29 NestLevel O nível de aninhamento no qual esse procedimento armazenado está sendo executado. Veja @@NESTLEVEL.
30 State Estado do servidor, no caso de um erro.
31 Error Número de erro.
32 Mode Modo de bloqueio do bloqueio adquirido. Essa coluna não é preenchida Lock:Released pelo evento.
33 Handle Identificador do objeto mencionado no evento.
34 ObjectName Nome do objeto acessado.
35 DatabaseName Nome do banco de dados especificado na instrução do banco de dados USE.
36 FileName Nome lógico do nome de arquivo modificado.
37 OwnerName Nome do proprietário do objeto referenciado.
38 RoleName Nome do banco de dados ou da função em todo o servidor direcionados por uma instrução.
39 TargetUserName Nome de usuário do destino de alguma ação.
40 DBUserName Nome de usuário do banco de dados SQL Server do cliente.
41 LoginSid SID (identificador de segurança) do usuário que fez logon.
42 TargetLoginName Nome de logon do destino de alguma ação.
43 TargetLoginSid SID do logon que é o destino de alguma ação.
44 ColumnPermissions Status de permissões em nível de coluna; usado pela Security Auditing.
45 LinkedServerName Nome do servidor vinculado.
46 ProviderName Nome do provedor OLE DB.
47 MethodName Nome do método OLE DB.
48 RowCounts Número de linhas no lote.
49 RequestID ID da solicitação que contém a instrução.
50 XactSequence Token usado para descrever a transação atual.
51 EventSequence Número de sequência para esse evento.
52 BigintData1 bigint , que depende da classe de evento capturada no rastreamento.
53 BigintData2 bigint , que depende da classe de evento capturada no rastreamento.
54 GUID Valor GUID, que é dependente da classe de evento capturada no rastreamento.
55 IntegerData2 Valor inteiro, que é dependente da classe de evento capturada no rastreamento.
56 ObjectID2 ID do objeto ou entidade relacionada, se disponível.
57 Type Valor inteiro, que é dependente da classe de evento capturada no rastreamento.
58 OwnerID Tipo o objeto que possui o bloqueio. Apenas para eventos de bloqueio.
59 ParentName Nome do esquema que contém o objeto.
60 IsSystem Indica se o evento ocorreu em um processo do sistema ou do usuário.

1 = sistema
0 = usuário.
61 Offset O deslocamento inicial da instrução no lote ou procedimento armazenado.
62 SourceDatabaseID ID do banco de dados no qual a origem do objeto existe.
63 SqlHandle Hash de 64 bits com base no texto de uma consulta ad hoc ou no banco de dados e ID de objeto de um objeto SQL. Esse valor pode ser passado para sys.dm_exec_sql_text() recuperar o texto SQL associado.
64 SessionLoginName O 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 exibe Login1, enquanto LoginName exibe Login2. Essa coluna de dados exibe os logins do SQL Server e do Windows.

@on [ = ] em

Especifica se habilitar (1) ou desabilitar (0) o evento. @on é bit, sem padrão.

Se @on estiver definido como 1, e @columnid for NULL, o evento será definido como ON e todas as colunas serão limpas. Se @columnid não for nulo, a coluna será definida como ON para esse evento.

Se @on estiver definido como 0, e @columnid for NULL, o evento será ativado OFF e todas as colunas serão limpas. Se @columnid não for nulo, a coluna será desativada.

Esta tabela ilustra a interação entre @on e @columnid.

@on @columnid Resultado
LIGADO (1) NULL O evento está ativado.

Todas as colunas são limpas.
NOT NULL A coluna está ativada para o evento especificado.
DESLIGADO (0) NULL O evento está desativado.

Todas as colunas são limpas.
NOT NULL A coluna está desativada para o evento especificado.

Valores do código de retorno

A tabela a seguir descreve os valores de código que você pode obter, após a conclusão do procedimento armazenado.

Código de retorno Descrição
0 Nenhum erro.
1 Erro desconhecido.
2 O rastreamento está sendo executado no momento. A alteração do rastreamento neste momento resulta em um erro.
3 O evento especificado não é válido. O evento pode não existir ou não é apropriado para o procedimento de armazenamento.
4 A coluna especificada não é válida.
9 O identificador de rastreamento especificado não é válido.
11 A coluna especificada é usada internamente e não pode ser removida.
13 Sem memória. Retornado quando não há memória suficiente para executar a ação especificada.
16 A função não é válida para esse rastreamento.

Comentários

sp_trace_setevent executa muitas das ações executadas anteriormente por procedimentos armazenados estendidos disponíveis em versões anteriores do SQL Server. Use sp_trace_setevent em vez de:

  • xp_trace_addnewqueue
  • xp_trace_eventclassrequired
  • xp_trace_seteventclassrequired

Os usuários devem executar sp_trace_setevent para cada coluna adicionada para cada evento. Durante cada execução, se @on for definido como 1, sp_trace_setevent adiciona o evento especificado à lista de eventos do rastreamento. Se @on estiver definido como 0, sp_trace_setevent remove o evento especificado da lista.

Os parâmetros de todos os procedimentos armazenados do Rastreamento SQL (sp_trace_*) são estritamente tipados. Se esses parâmetros não forem chamados com os tipos de dados de parâmetro de entrada corretos, conforme especificado na descrição do argumento, o procedimento armazenado retornará um erro.

Para obter um exemplo de como usar procedimentos armazenados de rastreamento, consulte Criar um rastreamento.

Permissões

Requer permissão ALTER TRACE.

Conteúdo relacionado