DBCC TRACEON (Transact-SQL)
Applies to: SQL Server Azure SQL Managed Instance
Enables the specified trace flags.
Transact-SQL syntax conventions
DBCC TRACEON ( trace# [ , ...n ] [ , -1 ] ) [ WITH NO_INFOMSGS ]
To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.
The number of the trace flag to turn on.
A placeholder that indicates multiple trace flags can be specified.
Switches on the specified trace flags globally. This argument is required in Azure SQL Managed Instance.
Suppresses all informational messages.
On a production server, to avoid unpredictable behavior, we recommend that you only enable trace flags server-wide by using one of the following methods:
- Use the
-Tcommand-line startup option of
sqlservr.exe. This is a recommended best practice because it makes sure that all statements will run with the trace flag enabled. These include commands in startup scripts. For more information, see sqlservr Application.
DBCC TRACEONonly while users or applications aren't concurrently running statements on the system.
Trace flags are used to customize certain characteristics by controlling how SQL Server operates. Trace flags, after they are enabled, remain enabled in the server until disabled by executing a
DBCC TRACEOFF statement. In SQL Server, there are two types of trace flags: session and global. Session trace flags are active for a connection and are visible only for that connection. Global trace flags are set at the server level and are visible to every connection on the server. To determine the status of trace flags, use
DBCC TRACESTATUS. To disable trace flags, use
After turning on a trace flag that affects query plans, execute
DBCC FREEPROCCACHE; so that cached plans are recompiled using the new plan-affecting behavior.
Azure SQL Managed Instance supports the following global Trace Flags: 460, 2301, 2389, 2390, 2453, 2467, 7471, 8207, 9389, 10316, and 11024.
DBCC TRACEON returns the following message:
DBCC execution completed. If DBCC printed error messages, contact your system administrator.
Requires membership in the sysadmin fixed server role.
The following example disables hardware compression for tape drivers, by switching on Trace Flag 3205. This flag is switched on only for the current connection.
DBCC TRACEON (3205); GO
The following example switches on Trace Flag 3205 globally.
DBCC TRACEON (3205, -1); GO
The following example switches on Trace Flags 3205 and 260 globally.
DBCC TRACEON (3205, 260, -1); GO