Skip to content

Latest commit

 

History

History
145 lines (123 loc) · 6.37 KB

set-ansi-defaults-transact-sql.md

File metadata and controls

145 lines (123 loc) · 6.37 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs monikerRange
SET ANSI_DEFAULTS (Transact-SQL)
SET ANSI_DEFAULTS (Transact-SQL)
WilliamDAssafMSFT
wiassaf
04/16/2020
sql
t-sql
reference
SET ANSI_DEFAULTS
ANSI_DEFAULTS
SET_ANSI_DEFAULTS_TSQL
ANSI_DEFAULTS_TSQL
ANSI_DEFAULTS option
SET ANSI_DEFAULTS statement
TSQL
>=aps-pdw-2016||=azure-sqldw-latest||>=sql-server-2016||>=sql-server-linux-2017||=azuresqldb-mi-current ||=fabric

SET ANSI_DEFAULTS (Transact-SQL)

[!INCLUDE sql-asdbmi-asa-pdw-fabricse-fabricdw]

Controls a group of [!INCLUDEssNoVersion] settings that collectively specify some ISO standard behavior.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

Syntax for [!INCLUDEssnoversion-md.md], [!INCLUDEsssodfull-md.md], [!INCLUDE fabric]

SET ANSI_DEFAULTS { ON | OFF }

Syntax for [!INCLUDEssazuresynapse-md.md] and [!INCLUDEsspdw-md.md]

SET ANSI_DEFAULTS ON

Remarks

ANSI_DEFAULTS is a server-side setting which can enable the behavior for all client connections. The client typically requests the setting on connection or session initialization. Users should not modify the server setting.
To change client the behavior, users should use the client specific methods like SQL_COPT_SS_PRESERVE_CURSORS. For more information, see SQLSetConnectAttr.

When enabled (ON), this option enables the following ISO settings:

:::row::: :::column::: SET ANSI_NULLS :::column-end::: :::column::: SET CURSOR_CLOSE_ON_COMMIT :::column-end::: :::row-end::: :::row::: :::column::: SET ANSI_NULL_DFLT_ON :::column-end::: :::column::: SET IMPLICIT_TRANSACTIONS :::column-end::: :::row-end::: :::row::: :::column::: SET ANSI_PADDING :::column-end::: :::column::: SET QUOTED_IDENTIFIER :::column-end::: :::row-end::: :::row::: :::column::: SET ANSI_WARNINGS :::column-end::: :::column::: :::column-end::: :::row-end:::

 

Together, these ISO standard SET options define the query processing environment for the duration of the work session of the user, a running trigger, or a stored procedure. However, these SET options do not include all the options required to comply with the ISO standard.

When dealing with indexes on computed columns, filtered indexes, and indexed views, four of these defaults (ANSI_NULLS, ANSI_PADDING, ANSI_WARNINGS, and QUOTED_IDENTIFIER) must be set to ON. These defaults are among seven SET options that must be assigned the required values when you are creating and changing indexes on computed columns, filtered indexes, and indexed views. The other SET options are ARITHABORT (ON), CONCAT_NULL_YIELDS_NULL (ON), and NUMERIC_ROUNDABORT (OFF). For more information about the required SET option settings with indexed views, filtered indexes, and indexes on computed columns, see Considerations When You Use the SET Statements.

The [!INCLUDEssNoVersion] Native Client ODBC driver and [!INCLUDEssNoVersion] Native Client OLE DB Provider for [!INCLUDEssNoVersion] automatically set ANSI_DEFAULTS to ON when connecting. The driver and Provider then set CURSOR_CLOSE_ON_COMMIT and IMPLICIT_TRANSACTIONS to OFF. The OFF settings for CURSOR_CLOSE_ON_COMMIT and IMPLICIT_TRANSACTIONS can be configured in ODBC data sources, in ODBC connection attributes, or in OLE DB connection properties that are set in the application before connecting to [!INCLUDEssNoVersion]. The default for ANSI_DEFAULTS is OFF for connections from DB-Library applications.

When SET ANSI_DEFAULTS is issued, QUOTED_IDENTIFIER is set at parse time, and the following options are set at execute time:

:::row::: :::column::: SET ANSI_NULLS :::column-end::: :::column::: SET ANSI_WARNINGS :::column-end::: :::row-end::: :::row::: :::column::: SET ANSI_NULL_DFLT_ON :::column-end::: :::column::: SET CURSOR_CLOSE_ON_COMMIT :::column-end::: :::row-end::: :::row::: :::column::: SET ANSI_PADDING :::column-end::: :::column::: SET IMPLICIT_TRANSACTIONS :::column-end::: :::row-end:::

Permissions

Requires membership in the public role.

Examples

The following example sets ANSI_DEFAULTS to ON and uses the DBCC USEROPTIONS statement to display the settings that are affected.

-- SET ANSI_DEFAULTS ON.  
SET ANSI_DEFAULTS ON;  
GO  

-- Display the current settings.  
DBCC USEROPTIONS;  
GO 

-- SET ANSI_DEFAULTS OFF.  
SET ANSI_DEFAULTS OFF;  
GO  

See Also

DBCC USEROPTIONS (Transact-SQL)
SET Statements (Transact-SQL)
SET ANSI_NULL_DFLT_ON (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SET CURSOR_CLOSE_ON_COMMIT (Transact-SQL)
SET IMPLICIT_TRANSACTIONS (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)