sp_trace_setstatus (Transact-SQL)

Modifica a situação atual do rastreamento especificado.

Importante
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Usar eventos estendidos.

Convenções da 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 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 sys.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çã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 do SQL (sp_trace_xx) são rigorosamente tipados. 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 Criar um rastreamento (Transact-SQL).

Permissões

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

Consulte também

Referência

sys.fn_trace_geteventinfo (Transact-SQL)

sys.fn_trace_getfilterinfo (Transact-SQL)

sp_trace_generateevent (Transact-SQL)

sp_trace_setevent (Transact-SQL)

sp_trace_setfilter (Transact-SQL)

Conceitos

Rastreamento do SQL