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

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

@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.

Conteúdo relacionado

  • Last updated on