DBCC TRACEON (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL Managed Instance

Active les indicateurs de trace spécifiés.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Notes

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

trace#

Numéro de l'indicateur de trace à activer.

n

Espace réservé indiquant qu’il est possible de spécifier plusieurs indicateurs de trace.

-1

Active globalement les indicateurs de trace spécifiés. Cet argument est obligatoire dans Azure SQL Managed Instance.

WITH NO_INFOMSGS

Supprime tous les messages d'information.

Notes

Sur un serveur de production, pour éviter un comportement imprévisible, il est recommandé d'activer uniquement les indicateurs de trace à l'échelle du serveur à l'aide de l'une des méthodes suivantes :

  • Utilisez l'option de démarrage de ligne de commande -T de sqlservr.exe. Cette pratique est recommandée car elle garantit que toutes les instructions sont exécutées avec l'indicateur de trace activé. Celles-ci comprennent les commandes des scripts de démarrage. Pour plus d’informations, consultez sqlservr Application.
  • Utilisez DBCC TRACEON uniquement lorsque des utilisateurs ou des applications ne sont pas simultanément en train d'exécuter des instructions sur le système.

Les indicateurs de trace permettent de personnaliser certaines caractéristiques en contrôlant le fonctionnement de SQL Server. Les indicateurs de trace, une fois activés, le restent sur le serveur jusqu'à ce qu'ils soient désactivés par l'exécution d’une instruction DBCC TRACEOFF. Dans SQL Server, il existe deux types d'indicateurs de trace : les indicateurs de trace de session et les indicateurs de trace globaux. Les indicateurs de trace de session sont actifs pour une connexion et visibles uniquement pour celle-ci. Les indicateurs de trace globaux sont définis au niveau du serveur et sont visibles pour chaque connexion sur celui-ci. Pour déterminer l'état des indicateurs de trace, utilisez DBCC TRACESTATUS. Pour désactiver les indicateurs de trace, utilisez DBCC TRACEOFF.

Après avoir activé un indicateur de trace qui affecte les plans de requête, exécutez DBCC FREEPROCCACHE; afin que les plans mis en cache soient recompilés à l’aide du nouveau comportement affectant le plan.

Azure SQL Managed Instance prend en charge les indicateurs de trace globaux suivants : 460, 2301, 2389, 2390, 2453, 2467, 7471, 8207, 9389, 10316 et 11024.

Jeux de résultats

DBCC TRACEON retourne le message suivant :

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

Autorisations

Nécessite l'appartenance au rôle serveur fixe sysadmin .

Exemples

L'exemple suivant désactive la compression matérielle des lecteurs de bandes en activant l'indicateur de trace 3205. Cet indicateur est uniquement activé pour la connexion active.

DBCC TRACEON (3205);
GO

L'exemple suivant active l'indicateur de trace 3205 de manière globale.

DBCC TRACEON (3205, -1);
GO

L'exemple suivant active les indicateurs de trace 3205 et 260 de manière globale.

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

Voir aussi