DBCC TRACEON (Transact-SQL)
Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure
Habilita os sinalizadores de rastreamento especificados.
Convençõ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. 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
desqlservr.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
- DBCC (Transact-SQL)
- DBCC TRACEOFF (Transact-SQL)
- DBCC TRACESTATUS (Transact-SQL)
- Sinalizadores de rastreamento (Transact-SQL)
- Habilitar o comportamento do otimizador de consulta do SQL Server que afeta o plano e pode ser controlado por diferentes sinalizadores de rastreamento em um nível de consulta específico