Compartilhar via


sp_trace_setstatus (Transact-SQL)

Aplica-se: SQL Server

Modifica a situação atual do rastreamento especificado.

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_setstatus
    [ @traceid = ] traceid
    , [ @status = ] status
[ ; ]

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. Para obter informações sobre como recuperar o @traceid, consulte sys.fn_trace_getinfo.

@status [ = ] status

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

A tabela a seguir lista 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 você pode obter, após a conclusão do procedimento armazenado.

Código de retorno Descrição
0 Nenhum erro.
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, o SQL Server retornará 0.

Comentários

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.