DBCC TRACEON (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Habilita os sinalizadores de rastreamento especificados.

Convenções de sintaxe Transact-SQL

Syntax

DBCC TRACEON ( trace# [ , ...n ] [ , -1 ] ) [ WITH NO_INFOMSGS ]

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

trace#

É o número do sinalizador de rastreamento a ser ativado.

n

Um espaço reservado que indica que vários sinalizadores de rastreamento podem ser especificados.

-1

Ativa globalmente os sinalizadores de rastreamento especificados. Este argumento é necessário na Instância Gerenciada do Azure SQL.

WITH NO_INFOMSGS

Suprime todas as mensagens informativas.

Comentários

Em um servidor de produção, para evitar comportamento imprevisível, recomendamos que você habilite sinalizadores de rastreamento no servidor usando somente um dos seguintes métodos:

  • Use a opção de inicialização de linha de comando -T de sqlservr.exe. Essa é a prática mais recomendada, porque assegura que todas as instruções sejam executadas com o sinalizador de rastreamento habilitado. Isso inclui comandos em scripts de inicialização. Para obter mais informações, consulte sqlservr Application.
  • Use DBCC TRACEON somente enquanto usuários ou aplicativos não estiverem executando instruções simultaneamente no sistema.

Sinalizadores de rastreamento são usados para personalizar certas características que controlam o modo operacional do SQL Server. Os sinalizadores de rastreamento, depois de habilitados, permanecem assim no servidor até que sejam desabilitados por meio da execução de uma instrução DBCC TRACEOFF. No SQL Server, há dois tipos de sinalizadores de rastreamento: sessão e global. Os sinalizadores de rastreamento de sessão são ativos para uma conexão e são visíveis apenas para essa conexão. Sinalizadores de rastreamento globais são definidos no nível do servidor e são visíveis em todas as conexões no servidor. Para determinar o status dos sinalizadores de rastreamento, use DBCC TRACESTATUS. Para desabilitar os sinalizadores de rastreamento, use DBCC TRACEOFF.

Depois de ativar um sinalizador de rastreamento que afeta os planos de consulta, execute DBCC FREEPROCCACHE; para que os planos armazenados em cache sejam recompilados usando o novo comportamento que afeta o plano.

A Instância Gerenciada de SQL do Azure dá suporte aos seguintes sinalizadores de rastreamento globais: 460, 2301, 2389, 2390, 2453, 2467, 7471, 8207, 9389, 10316 e 11024.

Conjuntos de resultados

DBCC TRACEON retorna a seguinte mensagem:

DBCC execution completed. If DBCC printed error messages, contact your system administrator.

Permissões

Exige associação à função de servidor fixa sysadmin .

Exemplos

O exemplo a seguir desabilita a compactação de hardware para unidades de fita por meio da ativação do sinalizador de rastreamento 3205. Esse sinalizador é ativado somente para a conexão atual.

DBCC TRACEON (3205);
GO

O exemplo a seguir ativa o sinalizador de rastreamento 3205 globalmente.

DBCC TRACEON (3205, -1);
GO

O exemplo a seguir ativa os sinalizadores de rastreamento 3205 e 260 globalmente.

DBCC TRACEON (3205, 260, -1);
GO

Confira também