set-arithignore-transact-sql.md

title	SET ARITHIGNORE (Transact-SQL)
description	SET ARITHIGNORE (Transact-SQL)
author	WilliamDAssafMSFT
ms.author	wiassaf
ms.date	12/04/2017
ms.prod	sql
ms.prod_service	database-engine, sql-database, synapse-analytics, pdw
ms.technology	t-sql
ms.topic	reference
f1_keywords	SET ARITHIGNORE SET_ARITHIGNORE_TSQL ARITHIGNORE ARITHIGNORE_TSQL
helpviewer_keywords	SET ARITHIGNORE statement overflow errors [SQL Server] ARITHIGNORE option divide-by-zero errors
dev_langs	TSQL
ms.assetid	71b2c2a5-c83a-4dfe-8469-237987a6e503
monikerRange	>=aps-pdw-2016||=azuresqldb-current||=azure-sqldw-latest||>=sql-server-2016||>=sql-server-linux-2017||=azuresqldb-mi-current

SET ARITHIGNORE (Transact-SQL)

[!INCLUDE sql-asdb-asdbmi-asa-pdw]

Controls whether error messages are returned from overflow or divide-by-zero errors during a query.

Transact-SQL Syntax Conventions

Syntax

-- Syntax for SQL Server and Azure SQL Database

SET ARITHIGNORE { ON | OFF }

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse  

SET ARITHIGNORE OFF

[!INCLUDEsql-server-tsql-previous-offline-documentation]

Note

[!INCLUDEsynapse-analytics-od-unsupported-syntax]

Remarks

The SET ARITHIGNORE setting only controls whether an error message is returned. [!INCLUDEssNoVersion] returns a NULL in a calculation involving an overflow or divide-by-zero error, regardless of this setting. The SET ARITHABORT setting can be used to determine whether the query is terminated. This setting does not affect errors occurring during INSERT, UPDATE, and DELETE statements.

If either SET ARITHABORT or SET ARITHIGNORE is OFF and SET ANSI_WARNINGS is ON, [!INCLUDEssNoVersion] still returns an error message when encountering divide-by-zero or overflow errors.

The setting of SET ARITHIGNORE is set at execute or run time and not at parse time.

To view the current setting for this setting, run the following query.

DECLARE @ARITHIGNORE VARCHAR(3) = 'OFF';  
IF ( (128 & @@OPTIONS) = 128 ) SET @ARITHIGNORE = 'ON';  
SELECT @ARITHIGNORE AS ARITHIGNORE;  

Permissions

Requires membership in the public role.

Examples

The following example demonstrates using both SET ARITHIGNORE settings with both types of query errors.

SET ARITHABORT OFF;  
SET ANSI_WARNINGS OFF  
GO  
  
PRINT 'Setting ARITHIGNORE ON';  
GO  
-- SET ARITHIGNORE ON and testing.  
SET ARITHIGNORE ON;  
GO  
SELECT 1 / 0 AS DivideByZero;  
GO  
SELECT CAST(256 AS TINYINT) AS Overflow;  
GO  
  
PRINT 'Setting ARITHIGNORE OFF';  
GO  
-- SET ARITHIGNORE OFF and testing.  
SET ARITHIGNORE OFF;  
GO  
SELECT 1 / 0 AS DivideByZero;  
GO  
SELECT CAST(256 AS TINYINT) AS Overflow;  
GO  

Examples: [!INCLUDEssSDWfull] and [!INCLUDEssPDW]

The following example demonstrates the divide by zero and the overflow errors. This example does not return an error message for these errors because ARITHIGNORE is OFF.

-- SET ARITHIGNORE OFF and testing.  
SET ARITHIGNORE OFF;  
SELECT 1 / 0 AS DivideByZero;  
SELECT CAST(256 AS TINYINT) AS Overflow;  

See Also

SET Statements (Transact-SQL)
SET ARITHABORT (Transact-SQL)