Partilhar via

sp_trace_setevent (Transact-SQL)

Aplica-se a:SQL Server

Adiciona ou remove um evento ou coluna de evento 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 cuja @status não é 0.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Em vez disso, use Eventos estendidos.

Transact-SQL convenções de sintaxe

Sintaxe

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

Argumentos

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção de sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

[ @traceid = ] traceide

A ID do rastreamento a ser modificado. @traceid é int, sem padrão. O usuário emprega esse valor de @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 para 9 Reserved Reservado
10 RPC:Completed Ocorre quando uma chamada de procedimento remoto (RPC) é concluída.
11 RPC:Starting Ocorre quando um RPC é iniciado.
12 SQL:BatchCompleted Ocorre quando um lote de Transact-SQL foi concluído.
13 SQL:BatchStarting Ocorre quando um lote de Transact-SQL foi iniciado.
14 Audit Login Ocorre quando um usuário efetua 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 do cliente ou conexões de cliente quebradas, acontecem.
17 ExistingConnection Deteta toda a atividade dos usuários conectados ao SQL Server antes do início do rastreamento.
18 Audit Server Starts and Stops Ocorre quando o estado de serviço do SQL Server é modificado.
19 DTCTransaction Rastreia transações coordenadas pelo Microsoft Distributed Transaction Coordinator (MS DTC) entre dois ou mais bancos de dados.
20 Audit Login Failed Indica que uma tentativa de logon no SQL Server a partir de um cliente falhou.
21 EventLog Indica que os eventos foram registrados no log de aplicativos 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 bloquearam uma à outra, tentando obter bloqueios incompatíveis em recursos que a outra transação possui.
26 Lock:Cancel Indica que a aquisição de um bloqueio em um recurso foi cancelada (por exemplo, devido a um impasse).
27 Lock:Timeout Indica que uma solicitação de bloqueio em um recurso, como uma página, atingiu o tempo limite devido a outra transação que contém 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 Ocorre antes de uma instrução SELECT, INSERT ou UPDATE ser executada.
29 para 31 Reserved Em vez disso, utilize o Evento 28.
32 Reserved Reservado
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 procedimentos.
36 SP:CacheRemove Indica quando um item é removido do cache de procedimentos.
37 SP:Recompile Indica que um procedimento armazenado foi recompilado.
38 SP:CacheHit Indica quando um procedimento armazenado é encontrado no cache de procedimentos.
39 Deprecated Preterido
40 SQL:StmtStarting Ocorre quando a instrução Transact-SQL foi iniciada.
41 SQL:StmtCompleted Ocorre quando a instrução Transact-SQL foi concluída.
42 SP:Starting Indica quando o procedimento armazenado foi iniciado.
43 SP:Completed Indica quando o procedimento armazenado foi concluído.
44 SP:StmtStarting Indica que uma instrução Transact-SQL dentro de um procedimento armazenado começou a ser executada.
45 SP:StmtCompleted Indica que uma instrução Transact-SQL dentro de um procedimento armazenado terminou de ser executada.
46 Object:Created Indica que um objeto foi criado, como para as instruções CREATE INDEX, CREATE TABLE e CREATE DATABASE.
47 Object:Deleted Indica que um objeto foi excluído, como nas instruções DROP INDEX e DROP TABLE.
48 Reserved
49 Reserved
50 SQL Transaction Rastreia Transact-SQL instruções BEGIN, COMMIT, SAVE e ROLLBACK TRANSACTION.
51 Scan:Started Indica quando uma verificação de tabela ou índice foi iniciada.
52 Scan:Stopped Indica quando uma verificação de tabela ou índice foi interrompida.
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 distinção de hash) que não está processando em uma partição de buffer foi revertida para um plano alternativo. Isso pode ocorrer devido à profundidade de recursão, inclinação de dados, sinalizadores de rastreamento ou contagem de bits.
56 para 57 Reserved
58 Auto Stats Indica que ocorreu uma atualização automática das estatísticas do índice.
59 Lock:Deadlock Chain Produzido para cada um dos eventos que levaram ao impasse.
60 Lock:Escalation Indica que um bloqueio de grão mais fino foi convertido em um bloqueio de grão mais grosso (por exemplo, um bloqueio de página escalado ou convertido em um bloqueio TABLE ou HoBT).
61 OLE DB Errors Indica que ocorreu um erro OLE DB.
62 para 66 Reserved
67 Execution Warnings Indica quaisquer avisos que ocorreram durante a execução de uma instrução do SQL Server ou procedimento armazenado.
68 Showplan Text (Unencoded) Exibe a árvore de plano 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 envolvendo a criação de índices; somente operações de classificação 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 ou mais instruções preparadas Transact-SQL.
73 Unprepare SQL ODBC, OLE DB ou DB-Library não preparou (excluiu) uma declaração ou instruções de 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.

Acionado 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.

Acionado para cursores ANSI e não-ANSI.
77 CursorUnprepare Um cursor preparado em uma instrução Transact-SQL é despreparado (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 duraçã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 para 91 User Configurable (0 - 9) Dados do evento definidos pelo usuário.
92 Data File Auto Grow Indica que um arquivo de dados foi estendido automaticamente pelo servidor.
93 Log File Auto Grow Indica que um arquivo de log foi estendido automaticamente pelo servidor.
94 Data File Auto Shrink Indica que um arquivo de dados foi reduzido automaticamente pelo servidor.
95 Log File Auto Shrink Indica que um arquivo de log foi reduzido automaticamente pelo servidor.
96 Showplan Text Exibe a árvore de plano de consulta da instrução SQL do otimizador de consulta. A coluna TextData não contém o Showplan para este evento.
97 Showplan All Exibe o plano de consulta com detalhes completos em tempo de compilação da instrução SQL executada. A coluna TextData não contém o Showplan para este evento.
98 Showplan Statistics Profile Exibe o plano de consulta com detalhes de tempo de execução completo da instrução SQL executada. A coluna TextData não contém o Showplan para este evento.
99 Reserved
100 RPC Output Parameter Produz valores de saída dos parâmetros para cada RPC.
101 Reserved
102 Audit Database Scope GDR Ocorre sempre que uma permissão CONCEDER, NEGAR, REVOGAR 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 CONCEDER, NEGAR, REVOGAR 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 login 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 palavras-passe não são registadas.
108 Audit Add Login to Server Role Event Ocorre quando um login é 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 um usuário de banco de dados (Windows ou SQL Server) para um banco de dados; para sp_grantdbaccess, sp_revokedbaccess, sp_addusere sp_dropuser.
110 Audit Add Member to DB Role Event Ocorre quando um login é adicionado ou removido como um usuário de banco de dados (fixo ou definido pelo usuário) para um banco de dados; para sp_addrolemember, sp_droprolemembere sp_changegroup.
111 Audit Add Role Event Ocorre quando um login é 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 ou sem êxito.
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 modificações de rastreamento de auditoria são feitas.
118 Audit Object Derived Permission Event Ocorre quando um comando de objeto CREATE, ALTER e DROP é emitido.
119 OLEDB Call Event Ocorre quando chamadas de provedor OLE DB são feitas para consultas distribuídas e procedimentos armazenados remotos.
120 OLEDB QueryInterface Event Ocorre quando chamadas de QueryInterface OLE DB 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 para o provedor OLE DB.
122 Showplan XML Ocorre quando uma instrução SQL é executada. Inclua este evento para identificar os operadores do Showplan. Cada evento é armazenado em um documento XML bem formado. A coluna Binary para este evento contém o Showplan codificado. Use o SQL Server Profiler para abrir o rastreamento e exibir o Showplan.
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 paralelo foram gravados temporariamente no banco de dados tempdb.
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 entidades de segurança, como usuários, são criadas, alteradas ou descartadas 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 dentro do escopo do servidor, como EXECUTE AS LOGIN.
133 Audit Database Principal Impersonation Event Ocorre quando ocorre uma representação dentro do escopo do 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 do servidor.
135 Audit Database Object Take Ownership Event Ocorre quando ocorre uma alteração de proprietário para objetos dentro do escopo do 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 por mais de um período de tempo especificado. Não inclui processos do sistema ou processos que estão aguardando recursos não detetá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. Os valores de número e estado do erro indicam a origem do erro.
143 Broker:Queue Disabled Indica que uma mensagem suspeita foi detetada 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 da fila que contém a mensagem suspeita.
144 para 145 Reserved
146 Showplan XML Statistics Profile Ocorre quando uma instrução SQL é executada. Identifica os operadores do Showplan e exibe dados completos em tempo de compilação. A coluna Binary para este evento contém o Showplan codificado. Use o SQL Server Profiler para abrir o rastreamento e exibir o Showplan.
148 Deadlock Graph Ocorre quando uma tentativa de adquirir um bloqueio é cancelada porque a tentativa fazia parte de um impasse e foi escolhida como a vítima do impasse. 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 uma substituição de arquivo de rastreamento.
151 Reserved
152 Audit Change Database Owner Ocorre quando ALTER AUTHORIZATION é usado para alterar o proprietário de um banco de dados e as permissões são verificadas para fazer isso.
153 Audit Schema Object Take Ownership Event Ocorre quando ALTER AUTHORIZATION é usado para atribuir um proprietário a um objeto e as permissões são verificadas para fazer isso.
154 Reserved
155 FT:Crawl Started Ocorre quando um rastreamento de texto completo (população) é iniciado. Use para verificar se uma solicitação de rastreamento é captada por tarefas de trabalho.
156 FT:Crawl Stopped Ocorre quando um rastreamento de texto completo (população) é interrompido. As paradas ocorrem quando um rastreamento é concluído com êxito ou quando ocorre um erro fatal.
157 FT:Crawl Aborted Ocorre quando uma exceção é encontrada durante um rastreamento de texto completo. Geralmente faz com que o rastreamento de texto completo pare.
158 Audit Broker Conversation Relata mensagens de auditoria relacionadas à segurança da caixa de diálogo do Service Broker.
159 Audit Broker Login Relata 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 exceção.
163 Broker:Activation Ocorre quando um monitor de fila inicia um procedimento armazenado de ativação, envia uma notificação de QUEUE_ACTIVATION ou quando um procedimento armazenado de ativação iniciado por um monitor de fila é 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 ocorre uma recompilação em nível de instrução.
167 Database Mirroring State Change Ocorre quando o estado de um banco de dados espelhado é alterado.
168 Showplan XML For Query Compile Ocorre quando uma instrução SQL é compilada. Exibe os dados completos em tempo de compilação. A coluna Binary para este evento contém o Showplan codificado. Use o SQL Server Profiler para abrir o rastreamento e exibir o Showplan.
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 Showplan.
170 Audit Server Scope GDR Event Indica que ocorreu um evento de concessão, negação ou revogação de permissões no escopo do servidor, como a criação de 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, 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, como assemblies e esquemas.
173 Audit Server Operation Event Ocorre quando operações de Auditoria de Segurança, como alteração de configurações, recursos, acesso externo ou autorização, são usadas.
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 entidades de servidor são criadas, alteradas ou descartadas.
178 Audit Database Operation Event Ocorre quando ocorrem operações de banco de dados, como ponto de verificação ou notificação de consulta de assinatura.
180 Audit Database Object Access Event Ocorre quando objetos de banco de dados, como esquemas, são acessados.
181 TM: Begin Tran starting Ocorre quando uma solicitação de BEGIN TRANSACTION é iniciada.
182 TM: Begin Tran completed Ocorre quando uma solicitação de BEGIN TRANSACTION é concluída.
183 TM: Promote Tran starting Ocorre quando uma solicitação de PROMOTE TRANSACTION é iniciada.
184 TM: Promote Tran completed Ocorre quando uma solicitação de PROMOTE TRANSACTION é concluída.
185 TM: Commit Tran starting Ocorre quando uma solicitação de COMMIT TRANSACTION é iniciada.
186 TM: Commit Tran completed Ocorre quando uma solicitação de COMMIT TRANSACTION é concluída.
187 TM: Rollback Tran starting Ocorre quando uma solicitação de ROLLBACK TRANSACTION é iniciada.
188 TM: Rollback Tran completed Ocorre quando uma solicitação de ROLLBACK TRANSACTION é concluída.
189 Lock:Timeout (timeout > 0) Ocorre quando uma solicitação de bloqueio em um recurso, como uma página, atinge o tempo limite.
190 Progress Report: Online Index Operation Relata o progresso de uma operação de compilação de índice online enquanto o processo de compilação está em execução.
191 TM: Save Tran starting Ocorre quando uma solicitação de SAVE TRANSACTION é iniciada.
192 TM: Save Tran completed Ocorre quando uma solicitação de SAVE TRANSACTION é concluída.
193 Background Job Error Ocorre quando um trabalho em segundo plano é encerrado de forma anormal.
194 OLEDB Provider Information Ocorre quando uma consulta distribuída é executada e coleta informações correspondentes à conexão do provedor.
195 Mount Tape Ocorre quando uma solicitação de montagem em fita é recebida.
196 Assembly Load Ocorre quando ocorre uma solicitação para carregar um assembly CLR.
197 Reserved
198 XQuery Static Type Ocorre quando uma expressão XQuery é executada. Esta 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 inscrito. A coluna TextData contém informações sobre o evento.
200 QN: parameter table As informações sobre assinaturas ativas são armazenadas em tabelas de parâmetros internas. Essa classe de evento ocorre quando uma tabela de parâmetros é criada ou excluída. Normalmente, essas tabelas são criadas ou excluídas quando o banco de dados é reiniciado. A coluna TextData contém informações sobre o evento.
201 QN: template Um modelo de consulta representa uma classe de consultas de assinatura. Normalmente, as consultas na mesma classe são idênticas, exceto por seus valores de parâmetro. Essa classe de evento ocorre quando uma nova solicitação de assinatura cai em uma classe já existente de (Match), uma nova classe (Create) ou uma classe Drop, que indica a limpeza de modelos para classes de consulta sem assinaturas ativas. A coluna TextData contém informações sobre o evento.
202 QN: dynamics Rastreia atividades internas de notificações de consulta. A coluna TextData contém informações sobre o evento.
212 Bitmap Warning Indica quando os filtros de bitmap foram desabilitados em uma consulta.
213 Database Suspect Data Page Indica quando uma página é adicionada à tabela suspect_pages no msdb.
214 CPU threshold exceeded Indica quando o Administrador de Recursos deteta que uma consulta excedeu o valor limite da CPU (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Indica quando um gatilho LOGON ou uma função de classificador do Administrador de Recursos inicia a execução.
216 PreConnect:Completed Indica quando um gatilho LOGON ou uma função de classificador do 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 contivesse 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. Você pode validar o guia de plano usando a função 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 para um evento.

Número da coluna 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 USE database ou do banco de dados padrão se nenhuma instrução USE database for emitida para uma determinada conexão.

O valor de um banco de dados pode ser determinado usando a função DB_ID.
4 TransactionID ID atribuída pelo sistema da transação.
5 LineNumber Contém 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 da linha da instrução no procedimento armazenado ou lote.
6 NTUserName Nome de usuário do Windows.
7 NTDomainName 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ído 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. Esta coluna é preenchida com os valores passados pelo aplicativo em vez do 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 Quantidade de tempo decorrido (em microssegundos) decorrido pelo evento. Esta coluna de dados não é preenchida pelo evento Hash Warning.
14 StartTime Hora de início do evento, quando disponível.
15 EndTime Hora em que o evento terminou. Esta coluna não é preenchida para iniciar classes de eventos, como SQL:BatchStarting ou SP:Starting. Também não é povoado pelo evento Hash Warning.
16 Reads Número de leituras de disco lógico realizadas pelo servidor em nome do evento. Esta coluna não é preenchida pelo evento Lock:Released.
17 Writes Número de gravações de disco físico executadas pelo servidor em nome do evento.
18 CPU Quantidade de tempo de CPU (em milissegundos) usada pelo evento.
19 Permissions Representa o bitmap de permissões; utilizado pela Auditoria de Segurança.
20 Severity Nível de gravidade de uma exceção.
21 EventSubClass Tipo de subclasse de evento. Esta coluna de dados não é preenchida para todas as classes de eventos.
22 ObjectID ID atribuído pelo sistema do objeto.
23 Success Sucesso da tentativa de uso de permissões; utilizados 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 coluna indid da tabela do sistema sysindexes.
25 IntegerData 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 rastreado.
27 EventClass Tipo de classe de evento que está sendo gravada.
28 ObjectType Tipo de objeto, como: tabela, função ou procedimento armazenado.
29 NestLevel O nível de aninhamento no qual este procedimento armazenado está sendo executado. Ver @@NESTLEVEL.
30 State Estado do servidor, em caso de erro.
31 Error Número do erro.
32 Mode Modo de bloqueio da fechadura adquirida. Esta coluna não é preenchida pelo evento Lock:Released.
33 Handle Identificador do objeto referenciado no evento.
34 ObjectName Nome do objeto acessado.
35 DatabaseName Nome do banco de dados especificado na instrução USE database.
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 função de todo o servidor visada por uma instrução.
39 TargetUserName Nome de usuário do alvo de alguma ação.
40 DBUserName Nome de usuário do banco de dados SQL Server do cliente.
41 LoginSid Identificador de segurança (SID) do utilizador com sessão iniciada.
42 TargetLoginName Nome de login do alvo de alguma ação.
43 TargetLoginSid SID do login que é alvo de alguma ação.
44 ColumnPermissions Status de permissões em nível de coluna; utilizado pela Auditoria de Segurança.
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 do pedido que contém a declaração.
50 XactSequence Um token para descrever a transação atual.
51 EventSequence Número de sequência para este evento.
52 BigintData1 valor de bigint, que depende da classe de evento capturada no rastreamento.
53 BigintData2 valor de bigint, que depende da classe de evento capturada no rastreamento.
54 GUID Valor GUID, que depende da classe de evento capturada no rastreamento.
55 IntegerData2 Valor inteiro, que depende da classe de evento capturada no rastreamento.
56 ObjectID2 ID do objeto ou entidade relacionado, se disponível.
57 Type Valor inteiro, que depende da classe de evento capturada no rastreamento.
58 OwnerID Tipo do objeto que possui o bloqueio. Apenas para eventos de bloqueio.
59 ParentName Nome do esquema no qual o objeto está dentro.
60 IsSystem Indica se o evento ocorreu em um processo do sistema ou em um processo do usuário.

1 = sistema
0 = usuário.
61 Offset Iniciando o deslocamento da instrução dentro do procedimento armazenado ou lote.
62 SourceDatabaseID ID do banco de dados no qual a origem do objeto existe.
63 SqlHandle Hash de 64 bits baseado no texto de uma consulta ad hoc ou no banco de dados e na ID do 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 login 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 exibirá Login1, enquanto LoginName exibirá Login2. Esta coluna de dados exibe logons do SQL Server e do Windows.

[ @on = ] em

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

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

Se @on estiver definido como 0e @columnid estiver NULL, o evento será transformado 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
EM (1) NULL O evento é transformado em.

Todas as colunas são limpas.
NOT NULL A coluna é 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 de 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 Sem erro.
1 Erro desconhecido.
2 O rastreamento está em execução no momento. Alterar o rastreamento neste momento resulta em um erro.
3 O evento especificado não é válido. O evento pode não existir ou não ser 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 estiver definido como 1, sp_trace_setevent adicionará o evento especificado à lista de eventos do rastreamento. Se @on estiver definido como 0, sp_trace_setevent removerá o evento especificado da lista.

Os parâmetros de todos os procedimentos armazenados do Rastreamento SQL (sp_trace_*) são estritamente digitados. Se esses parâmetros não forem chamados com os tipos de dados de parâmetros 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

  • Last updated on