sp_trace_setstatus (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis)

Modifica a situação atual do rastreamento especificado.

Importante

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

Ícone de link do tópico Convenções da sintaxe Transact-SQL

Sintaxe

  
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status  

Argumentos

[ @traceid = ] trace_id É a ID do rastreamento a ser modificado. trace_id é int, sem padrão. O usuário emprega esse trace_id valor para identificar, modificar e controlar o rastreamento. para obter informações sobre como recuperar o trace_id, confira sys.fn_trace_getinfo ()SQL de transação.

[ @status = ] status Especifica a ação a ser implementada no rastreamento. o status é int, sem padrão.

A tabela a seguir descreve o status que pode ser especificado.

Status Descrição
0 Interrompe o rastreamento especificado.
1 Inicia o rastreamento especificado.
2 Fecha o rastreamento especificado e exclui sua definição do servidor.

Observação

Um rastreamento deve ser interrompido primeiro antes de ser encerrado. Um rastreamento deve ser interrompido e encerrado primeiro antes de ser exibido.

Valores do código de retorno

A tabela a seguir descreve os valores de código que os usuários podem obter após a conclusão do procedimento armazenado.

Código de retorno Descrição
0 Sem erros.
1 Erro desconhecido.
8 O status especificado não é válido.
9 O Identificador de Rastreamento especificado não é válido.
13 Sem memória. Retornado quando não há memória suficiente para executar a ação especificada.

Se o rastreamento já estiver no estado especificado, SQL Server retornará 0.

Comentários

os parâmetros de todos os procedimentos armazenados de rastreamento de SQL (sp_trace_xx) são estritamente tipados. 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 de como usar procedimentos armazenados de rastreamento, veja Criar um rastreamento (Transact-SQL).

Permissões

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

Consulte Também

sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
Rastreamento do SQL