DBCC TRACEON (Transact-SQL)

Habilita os sinalizadores de rastreamento especificados.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

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.

  • 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 do 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 Aplicativo sqlservr.

  • Use DBCC TRACEON (trace# [, ....n],-1) 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. Sinalizadores de rastreamento, depois de habilitados, permanecem assim no servidor até que sejam desabilitados executando uma instrução DBCC TRACEOFF. No SQL Server, há dois tipos de sinalizadores de rastreamento: sessão e global. Sinalizadores de rastreamento de sessão são ativados para uma conexão e são visíveis somente naquela 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 sinalizadores de rastreamento, use DBCC TRACEOFF.

Conjuntos de resultados

DBCC TRACEON retorna o conjunto de resultados seguinte (mensagem):

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

Permissões

Requer associação na função de servidor fixa sysadmin.

Exemplos

O exemplo a seguir desabilita a compactação de hardware para drivers em fita, ativando sinalizadores 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