SET Options

The following table provides an alphabetical list of SET options and the corresponding database and server options that are supported in Microsoft SQL Server.

SET option	Database option	Server option	Default setting
SET ANSI_DEFAULTS (Transact-SQL)	None	None	Not applicable
SET ANSI_NULL_DFLT_OFF (Transact-SQL) SET ANSI_NULL_DFLT_ON (Transact-SQL)	ANSI_NULL_DEFAULT	user options assigns a default	OFF
SET ANSI_NULLS (Transact-SQL)	ANSI_NULLS	user options assigns a default	OFF
SET ANSI_PADDING (Transact-SQL)	ANSI_PADDING	user options assigns a default	ON
SET ANSI_WARNINGS (Transact-SQL)	ANSI_WARNINGS	user options assigns a default	OFF
SET ARITHABORT (Transact-SQL)	ARITHABORT	user options assigns a default	OFF
SET ARITHIGNORE (Transact-SQL)	None	user options assigns a default	OFF
SET CONCAT_NULL_YIELDS_NULL (Transact-SQL)	CONCAT_NULL_YIELDS_NULL	None	OFF
SET CONTEXT_INFO (Transact-SQL)	None	None	OFF
SET CURSOR_CLOSE_ON_COMMIT (Transact-SQL)	CURSOR_CLOSE ON_COMMIT	user options assigns a default	OFF
SET DATEFIRST (Transact-SQL)	None	None	7
SET DATEFORMAT (Transact-SQL)	None	None	mdy
SET DEADLOCK_PRIORITY (Transact-SQL)	None	None	NORMAL
SET FIPS_FLAGGER (Transact-SQL)	None	None	OFF
SET FMTONLY (Transact-SQL)	None	None	OFF
SET FORCEPLAN (Transact-SQL)	None	None	OFF
SET IDENTITY_INSERT (Transact-SQL)	None		OFF
SET IMPLICIT_TRANSACTIONS (Transact-SQL)	None	user options assigns a default	OFF
SET LANGUAGE (Transact-SQL)	None	None	us_english
SET LOCK_TIMEOUT (Transact-SQL)	None	None	No limit
SET NOCOUNT (Transact-SQL)	None	user options assigns a default	OFF
SET NOEXEC (Transact-SQL)	None	None	OFF
SET NUMERIC_ROUNDABORT (Transact-SQL)	NUMERIC_ROUNDABORT	None	OFF
SET OFFSETS (Transact-SQL)	None	None	OFF
SET PARSEONLY (Transact-SQL)	None	None	OFF
SET QUERY_GOVERNOR_COST_LIMIT (Transact-SQL)	None	query governor cost limit	OFF
SET QUOTED_IDENTIFIER (Transact-SQL)	quoted identifier	user options assigns a default	OFF
SET REMOTE_PROC_TRANSACTIONS (Transact-SQL)	None	None	OFF
SET ROWCOUNT (Transact-SQL)	None	None	OFF
SET SHOWPLAN_ALL (Transact-SQL)	None	None	OFF
SET SHOWPLAN_TEXT (Transact-SQL)	None	None	OFF
SET SHOWPLAN_XML (Transact-SQL)	None	None	OFF
SET STATISTICS IO (Transact-SQL)	None	None	OFF
SET STATISTICS PROFILE (Transact-SQL)	None	None	OFF
SET STATISTICS TIME (Transact-SQL)	None	None	OFF
SET STATISTICS XML (Transact-SQL)	None	None	OFF
SET TEXTSIZE (Transact-SQL)	None	None	OFF
SET TRANSACTION ISOLATION LEVEL (Transact-SQL)	None	None	n/a
SET XACT_ABORT (Transact-SQL)	None	None	OFF

Parse-Time and Execute-Time SET Options

The point at which a SET option takes effect depends upon whether the option is a parse-time option or an execute-time option. Parse-time options take effect during parsing, as the options are encountered in text, without regard to the control of flow statements. Execute-time options take effect during the execution of the code in which they are specified. If execution fails before the SET statement is executed, the option is not set. If execution fails after the SET statement is executed, the option is set.

The QUOTED_IDENTIFIER, PARSEONLY, OFFSETS, and FIPS_FLAGGER options are parse-time options. All other SET options are execute-time options.

SET QUOTED_IDENTIFIER and SET ANSI_NULLS statements that occur within a batch or stored procedure do not affect that batch or stored procedure. Instead, the settings that are used for statements inside the batch or stored procedure are the settings that are in effect when the batch or stored procedure is created.

Duration of SET Options

This section describes the duration of SET options.

• SET options that are set by a user in a script apply until reset or until the user's session with the server is terminated.

• SET options that are set within a stored procedure or trigger apply until they are reset inside that stored procedure or trigger, or until control returns to the code that invoked the stored procedure or trigger.

• A MARS-enabled connection maintains a list of default SET option values. When a batch executes under that connection, the default SET option values are copied to the request's environment. After the batch ends, the environment is copied back to the session's default. In this way, multiple batches executing at the same time under the same connection run under an isolated SET options environment.

  Note

  Under MARS-enabled connections, if multiple batches execute at the same time and they modify the batch execution environment, the resulting default environment for the connection depends on the last batch that has completed execution.

• Unless explicitly reset, SET option values from all higher level code apply within a stored procedure or trigger.

• SET options that are set by a user within a dynamic SQL batch apply only for the duration of that batch.

• Unless explicitly or implicitly reset, SET options that are set for a connection apply after connecting to a different database.

  Note

  An additional consideration is when a user connects to a database and some option may be automatically set to ON, based on the values specified by the prior use of the user options, server option, or the values that apply to all ODBC and OLE DB connections.

Shortcut SET Option

Transact-SQL provides the SET ANSI_DEFAULTS statement as a shortcut for setting these ISO standard options:

• SET ANSI_NULLS

• SET CURSOR_CLOSE_ON_COMMIT

• SET ANSI_NULL_DFLT_ON

• SET IMPLICIT_TRANSACTIONS

• SET ANSI_PADDING

• SET QUOTED_IDENTIFIER

• SET ANSI_WARNINGS

The shortcut resets the values for these options. Any individual option that is set after the shortcut is used will override the corresponding value set by the shortcut.

Note

SET ANSI_DEFAULTS does not set all the options required to comply with the ISO standard.

See Also

Reference

SET Statements (Transact-SQL)

Concepts

Using Options in SQL Server