Compartilhar via


sp_trace_setstatus (Transact-SQL)

Modifica a situação atual do rastreamento especificado.

Ícone de vínculo de tópicoConvenções de 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 nenhum padrão. O usuário emprega este valor trace_id para identificar, modificar e controlar o rastreamento. Para obter mais informações sobre a recuperação de trace_id, consulte fn_trace_getinfo (Transact-SQL).

  • [ @status= ] status
    Especifica a ação a ser implementada no rastreamento. 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çãoObservação

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

Valores de 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

Nenhum erro.

1

Erro desconhecido.

8

O status especificado não é válido.

9

O Identificador de Rastreamento especificado não é válido.

13

Memória insuficiente. Retornado quando não há memória suficiente para executar a ação especificada.

Se o rastreamento já estiver na situação especificada, SQL Server retornará 0.

Comentários

Os parâmetros de todos os procedimentos armazenados do Rastreamento SQL (sp_trace_xx) são rigorosamente digitados. 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 do uso de procedimentos armazenados de rastreamento, consulte Como criar um rastreamento (Transact-SQL).

Permissões

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