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.