Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL Server
Modifica o estado atual do rastreamento especificado.
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_setstatus
[ @traceid = ] traceid
, [ @status = ] status
[ ; ]
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. 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.
| Situação | 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 vestígio deve ser interrompido primeiro antes de poder ser fechado. Um rastreamento deve ser interrompido e fechado primeiro antes de poder ser visualizado.
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. |
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 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.