sp_trace_setevent (Transact-SQL)

Adiciona ou remove um evento ou coluna de eventos a um rastreamento. sp_trace_setevent pode ser executado apenas 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 exista ou cujo status não seja 0.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_trace_setevent [ @traceid = ] trace_id 
          , [ @eventid = ] event_id
          , [ @columnid = ] column_id
          , [ @on = ] on

Argumentos

  • [ @traceid= ] trace_id
    É a ID do rastreamento a ser modificado. trace_id é int, sem nenhum padrão. O usuário emprega este valor trace_id para identificar, modificar e controlar o rastreamento.

  • [ @eventid= ] event_id
    É a ID do evento a ser ativado. event_id é int, sem nenhum 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-9

Reservado

Reservado

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 faz logoff 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 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 as transações do MS DTC (Microsoft Distributed Transaction Coordinator) 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 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 do sistema @@LOCK_TIMEOUT e pode ser definido com a instrução SET LOCK_TIMEOUT.

28

Degree of Parallelism Event (7.0 Insert)

Acontece antes de uma instrução SELECT, INSERT ou UPDATE ser executada.

29-31

Reservado

Use o Evento 28 em vez disso.

32

Reservado

Reservado

33

Exceção

Indica que uma exceção ocorreu no SQL Server.

34

SP:CacheMiss

Indica quando um procedimento armazenado não é localizado no cache de procedimento.

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

Preterido

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 a execução de uma instrução Transact-SQL em um procedimento armazenado foi iniciada.

45

SP:StmtCompleted

Indica que a execução de uma instrução Transact-SQL em um procedimento armazenado foi concluída.

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

Reservado

49

Reservado

50

SQL Transaction

Rastreia as seguintes instruções Transact-SQL: BEGIN TRAN, COMMIT TRAN, SAVE TRAN e ROLLBACK TRAN.

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 hash, agregado de hash, união de hash e distinção de hash) 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-57

Reservado

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-66

Reservado

67

Execution Warnings

Indicam qualquer aviso que ocorreu durante a execução de uma instrução ou um procedimento armazenado do SQL Server.

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. Isso não inclui operações de classificação envolvendo a criação de índices, mas somente operações de classificação em 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 está pronto para ser usado por ODBC, OLE DB ou DB-Library.

71

Prepare SQL

ODBC, OLE DB ou DB-Library preparou uma instrução Transact-SQL ou instruções 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 anteriormente 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, OLE DB, 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 de um tipo para outro pelo SQL Server.

Disparado 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 anteriormente aberto em uma instrução Transact-SQL por ODBC, OLE DB, ou DB-Library foi fechado.

79

Missing Column Statistics

Estatísticas de coluna que podem ter sido úteis para o otimizador não estão disponíveis.

80

Missing Join Predicate

A consulta que está sendo executada não tem nenhum predicado de junção. 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 em 5 por cento da memória máxima de servidor, o que for maior.

82-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. Observe que a coluna TextData 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. Observe que a coluna TextData 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. Observe que a coluna TextData não contém o plano de execução para este evento.

99

Reservado

100

RPC Output Parameter

Produz valores de saída dos parâmetros para todo RPC.

101

Reservado

102

Evento Audit Statement GDR

Ocorre sempre que um GRANT, DENY, REVOKE para uma permissão de instrução é emitido por qualquer usuário no SQL Server.

103

Evento Audit Object GDR

Ocorre sempre que um GRANT, DENY, REVOKE para uma permissão de objeto é emitido por qualquer usuário no SQL Server.

104

Evento Audit AddLogin

Ocorre quando um logon do SQL Server é adicionado ou removido; para sp_addlogin e sp_droplogin.

105

Evento Audit Login GDR

Ocorre quando um direito de logon do Windows é adicionado ou removido; para sp_grantlogin, sp_revokelogin e sp_denylogin.

106

Evento Audit Login Change Property

Ocorre quando uma propriedade de um logon, exceto as senhas, é modificada; para sp_defaultdb e sp_defaultlanguage.

107

Evento Audit Login Change Password

Ocorre quando uma senha de logon do SQL Server é alterada.

As senhas não são registradas.

108

Evento Audit Add Login to Server Role

Ocorre quando um logon é adicionado ou removido de uma função de servidor fixa; para sp_addsrvrolemember e sp_dropsrvrolemember.

109

Evento Audit Add DB User

Ocorre quando um logon é adicionado ou removido como um usuário do banco de dados (do Windows ou do SQL Server) para um banco de dados; para sp_grantdbaccess, sp_revokedbaccess, sp_adduser e sp_dropuser.

110

Evento Audit Add Member to DB Role

Ocorre quando um logon é adicionado ou removido como um usuário do banco de dados para um banco de dados; para sp_addrolemember, sp_droprolemember e sp_changegroup.

111

Evento Audit Add Role

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

Evento Audit App Role Change Password

Ocorre quando uma senha de uma função de aplicativo é alterada.

113

Evento Audit Statement Permission

Ocorre quando uma permissão de instrução (como CREATE TABLE) é usada.

114

Evento Audit Schema Object Access

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

Evento Audit DBCC

Ocorre quando comandos DBCC são emitidos.

117

Evento Audit Change Audit

Ocorre quando são feitas modificações de rastreamento de auditoria.

118

Evento Audit Object Derived Permission

Ocorre quando um comando de objeto CREATE, ALTER e DROP é emitido.

119

Evento OLEDB Call

Ocorre quando as chamadas de provedor OLE DB são feitas para consultas distribuídas e procedimentos armazenados remotos.

120

Evento OLEDB QueryInterface

Ocorre quando as chamadas de provedor OLE DB QueryInterface são feitas para consultas distribuídas e procedimentos armazenados remotos.

121

Evento OLEDB DataRead

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. Observe que a coluna Binary para este 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 é usado um recurso que será removido de uma versão futura do SQL Server.

126

Deprecation Final Support

Ocorre quando é usado um recurso que será removido da próxima versão principal do SQL Server.

127

Evento Exchange Spill

Ocorre quando buffers de comunicação em um plano de consulta paralelo é temporariamente gravado no banco de dados tempdb.

128

Evento Audit Database Management

Ocorre quando um banco de dados é criado, alterado ou descartado.

129

Evento Audit Database Object Management

Ocorre quando uma instrução CREATE, ALTER ou DROP é executada em objetos de banco de dados, como esquemas.

130

Evento Audit Database Principal Management

Ocorre quando os principais, como usuários, são criados, alterados ou descartados de um banco de dados.

131

Evento Audit Schema Object Management

Ocorre quando objetos de servidor são criados, alterados ou descartados.

132

Evento Audit Server Principal Impersonation

Ocorre quando há uma representação no escopo de servidor, como EXECUTE LOGIN AS.

133

Evento Audit Database Principal Impersonation

Ocorre quando uma representação acontece no escopo de banco de dados, como EXECUTE AS USER ou SETUSER.

134

Evento Audit Server Object Take Ownership

Ocorre quando o proprietário é alterado para objetos no escopo de servidor.

135

Evento Audit Database Object Take Ownership

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 ou descarta um 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 em recursos não detectáveis por deadlock. Use sp_configure para configurar o limite e a frequência com as quais relatórios são gerados.

138

Broker:Connection

Relata o status de uma conexão de transporte administrada 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 destinada a ser encaminhada.

141

Broker:Message Classify

Ocorre quando o Service Broker determina o roteamento para uma mensagem.

142

Broker:Transmission

Indica que erros ocorreram 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 havia cinco reversões de transação sucessivas 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-145

Reservado

 

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. Observe que a coluna Binary para este 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

Reservado

 

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

Evento Audit Schema Object Take Ownership

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

Reservado

 

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

Relata mensagens de auditoria relacionadas à segurança 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 pode reter uma mensagem recebida que deve ser 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 fila inicia um procedimento armazenado de ativação, envia uma notificação 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 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. Observe que a coluna Binary para este 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 os dados de tempo de compilação completos. Use para identificar operadores de plano de execução.

170

Evento Audit Server Scope GDR

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

Evento Audit Server Object GDR

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

Evento Audit Database Object GDR

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

Evento Audit Server Operation

Ocorre quando são usadas operações de Segurança Auditoria, tal como alterar configurações, recursos, acesso externo ou autorização.

175

Evento Audit Server Alter Trace

Ocorre quando uma instrução verifica a permissão ALTER TRACE.

176

Evento Audit Server Object Management

Ocorre quando objetos de servidor são criados, alterados ou descartados.

177

Evento Audit Server Principal Management

Ocorre quando principais são criados, alterados ou descartados.

178

Evento Audit Database Operation

Ocorre quando ocorrem operações de banco de dados, tal como ponto de verificação ou notificação de consulta de assinatura.

180

Evento Audit Database Object Access

Ocorre quando são acessados objetos de banco de dados, tal como esquemas.

181

TM: Begin Tran starting

Ocorre quando uma solicitação BEGIN TRANSACTION é iniciada.

182

TM: Begin Tran completed

Ocorre quando uma solicitação BEGIN TRANSACTION é concluída.

183

TM: Promote Tran starting

Ocorre quando uma solicitação PROMOTE TRANSACTION é iniciada.

184

TM: Promote Tran completed

Ocorre quando uma solicitação PROMOTE TRANSACTION é concluída.

185

TM: Commit Tran starting

Ocorre quando uma solicitação COMMIT TRANSACTION é iniciada.

186

TM: Commit Tran completed

Ocorre quando uma solicitação COMMIT TRANSACTION é concluída.

187

TM: Rollback Tran starting

Ocorre quando uma solicitação ROLLBACK TRANSACTION é iniciada.

188

TM: Rollback Tran completed

Ocorre quando uma solicitação ROLLBACK TRANSACTION é 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 solicitação SAVE TRANSACTION é iniciada.

192

TM: Save Tran completed

Ocorre quando uma solicitação SAVE TRANSACTION é 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

Reservado

 

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 assinado. A coluna TextData 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 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 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 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 em msdb.

214

Limite de CPU excedido

Indica quando o Administrador de Recursos detecta que uma consulta excedeu o valor do limite de 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 SQL Server produziu com sucesso um plano de execução para uma consulta ou lote, que continha uma guia de plano.

218

Plan Guide Unsuccessful

Indica que o SQL Server não pôde produzir um plano de execução, para uma consulta ou lote, que continha uma guia de plano. O SQL Server 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 do sistema sys.fn_validate_plan_guide.

235

Audit Fulltext

  • [ @columnid= ] column_id
    É a ID da coluna a ser adicionada para o evento. column_id é int, sem nenhum padrão.

A tabela a seguir lista as colunas que podem ser adicionadas a 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 o banco de dados padrão se nenhuma instrução USE database 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. No caso de eventos que envolvem instruções Transact-SQL, como SP:StmtStarting, LineNumber contém o número de linha da instrução no procedimento armazenado ou lote.

6

NTUserName

Nome de usuário do Microsoft 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í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 cliente no SQL Server.

12

SPID

ID de processo de servidor atribuída pelo SQL Server ao processo associado ao cliente.

13

Duration

Tempo decorrido (em milhões de segundos) utilizado pelo evento. Esta coluna de dados não é populada pelo evento Hash Warning.

14

StartTime

Horário de início do evento, quando disponível.

15

EndTime

Horário em que o evento foi encerrado. Esta coluna não é populada para classes de evento iniciais, como SQL:BatchStarting ou SP:Starting. Também não é populada pelo evento Hash Warning.

16

Reads

Número de leituras lógicas do disco executadas pelo servidor em nome do evento. Esta coluna não é populada pelo evento Lock:Released.

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 é populada 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 = êxito0 = falha

24

IndexID

ID do índice no objeto afetado pelo evento. Para determinar a ID do í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 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. Consulte @@NESTLEVEL (Transact-SQL).

30

State

Estado do servidor, no caso de um erro.

31

Error

Número de erro.

32

Mode

Modo de bloqueio do bloqueio adquirido. Esta coluna não é populada pelo evento Lock:Released.

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 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 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 do 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 desse evento.

52

BigintData1

Valor bigint, que é dependente da classe de evento capturada no rastreamento.

53

BigintData2

Valor bigint, que é dependente 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

Tipo

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 em que se encontra a origem do objeto.

63

SqlHandle

Hash de 64 bits com base no texto de uma consulta ad hoc ou na ID de objeto e banco de dados de um objeto SQL. Esse valor pode ser transmitido a sys.dm_exec_sql_text() para 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 irá exibir Login1, enquanto que LoginName exibirá Login2. Esta coluna de dados exibe logons tanto do SQL Server, quanto do Windows.

  • **[ @on=\]**on
    Especifica se o evento deve ser ON (1) ou OFF (0). on é bit, sem nenhum padrão.

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

    Se on for definido como 0 e column_id for NULL, o evento será OFF e todas as colunas serão limpas. Se column_id não for nulo, então a coluna será definida como OFF.

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

@on

@columnid

Resultado

ON (1)

NULL

Evento é definido como ON.

Todas as colunas são limpas.

 

NOT NULL

A coluna é definida como ON para o evento especificado.

OFF (0)

NULL

O evento é definido como OFF.

Todas as colunas são limpas.

 

NOT NULL

A coluna é definida como OFF para o evento especificado.

Valores de código de retorno

A tabela a seguir descreve os valores dós códigos que os usuários podem 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. Alterar o rastreamento nesse momento resultará em um erro.

3

O evento especificado não é válido. O evento pode não existir ou não é um apropriado para o procedimento de loja.

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

Memória insuficiente. Retornado quando não há memória suficiente para executar a ação especificada.

16

A função não é válida para este rastreamento.

Comentários

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

  • xp_trace_addnewqueue

  • xp_trace_eventclassrequired

  • xp_trace_seteventclassrequired

Os usuários devem executar sp_trace_setevent para cada coluna adicionada a cada evento. Durante cada execução, se @on for definido como 1, sp_trace_setevent adicionará o evento especificado à lista de eventos do rastreamento. Se @on for 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_xx) são rigorosamente digitados. Se esses parâmetros não forem chamados com os tipos de dados com parâmetro de entrada corretos, como especificado na descrição do argumento, o procedimento armazenado retornará um erro.

Para obter um exemplo do uso de procedimentos armazenados de rastreamento, consulte Como criar um rastreamento (Transact-SQL).

Permissões

O usuário deve ter a permissão ALTER TRACE.