SET ANSI_WARNINGS (Transact-SQL)

对几种错误情况指定 ISO 标准行为。

适用范围:SQL Server(SQL Server 2008 至当前版本),Windows Azure SQL Database(初始版本至当前版本)。

主题链接图标 Transact-SQL 语法约定

语法

SET ANSI_WARNINGS { ON | OFF }

注释

SET ANSI_WARNINGS 可以影响下列情况:

  • 设置为 ON 时,如果聚合函数(如 SUM、AVG、MAX、MIN、STDEV、STDEVP、VAR、VARP 或 COUNT)中出现空值,将生成警告消息。 设置为 OFF 时,不发出警告。

  • 设置为 ON 时,被零除错误和算术溢出错误将导致回滚语句,并生成错误消息。 设置为 OFF 时,被零除错误和算术溢出错误将导致返回空值。 如果在 character、Unicode 或 binary 列上尝试执行 INSERT 或 UPDATE 操作,而这些列中的新值长度超出最大列大小,则将出现被零除错误和算术溢出错误导致返回空值的行为。 如果 SET ANSI_WARNINGS 为 ON,则根据 ISO 标准,将取消 INSERT 或 UPDATE 操作。 字符列的尾随空格和二进制列的尾随零都将被忽略。 设置为 OFF 时,数据将剪裁为列的大小,并且语句执行成功。

    备注

    在 binary 或 varbinary 数据转换中发生截断时,不管 SET 选项如何设置,都不发出警告或错误消息。

    备注

    在存储过程和用户定义函数中传递参数,或者在批处理语句中声明和设置变量时,不执行 ANSI_WARNINGS。例如,如果一个变量被定义为 char(3),但后来将该变量设置为一个大于三个字符的值,则数据将被截断为定义的大小,并且 INSERT 或 UPDATE 语句将执行成功。

可以使用 sp_configure 的 user options 选项为服务器的所有连接设置 ANSI_WARNINGS 的默认设置。 有关详细信息,请参阅 sp_configure (Transact-SQL)

创建或操作对索引视图或计算列的索引时,SET ANSI_WARNINGS 必须为 ON。 如果 SET ANSI_WARNINGS 为 OFF,对计算列或索引视图的索引所在的表执行 CREATE、UPDATE、INSERT 和 DELETE 语句将失败。 有关计算列的索引视图和索引必需的 SET 选项设置的详细信息,请参阅 SET 语句 (Transact-SQL) 中的“使用 SET 语句时的注意事项”。

SQL Server 包含 ANSI_WARNINGS 数据库选项。 此选项与 SET ANSI_WARNINGS 等效。 如果 SET ANSI_WARNINGS 为 ON,则发生被零除、字符串超出数据库列及其他类似错误时,将引发错误或警告。 如果 SET ANSI_WARNINGS 为 OFF,则不会引发这些错误和警告。 model 数据库中的 SET ANSI_WARNINGS 的默认值为 OFF。 如果未指定,则应用 ANSI_WARNINGS 设置。 如果 SET ANSI_WARNINGS 为 OFF,则 SQL Server 使用 sys.databases 目录视图中的 is_ansi_warnings_on 列的值。

执行分布式查询时,应将 ANSI_WARNINGS 设置为 ON。

进行连接时,SQL Server 的 SQL Server Native Client ODBC 驱动程序和 SQL Server Native Client OLE DB 访问接口会自动将 ANSI_WARNINGS 设置为 ON。 这可以在 ODBC 数据源、ODBC 连接属性(它们在连接前在应用程序中设置)中进行配置。 从 DB-Library 应用程序连接时,SET ANSI_WARNINGS 的默认值为 OFF。

SET ANSI_DEFAULTS 为 ON 时,将启用 SET ANSI_WARNINGS。

SET ANSI_WARNINGS 的设置是在执行或运行时设置的,而不是在分析时设置的。

如果 SET ARITHABORT 或 SET ARITHIGNORE 为 OFF,而 SET ANSI_WARNINGS 为 ON,则遇到被零除或溢出错误时,SQL Server 仍会返回错误消息。

要查看此设置的当前设置,请运行以下查询。

DECLARE @ANSI_WARN VARCHAR(3) = 'OFF';
IF ( (8 & @@OPTIONS) = 8 ) SET @ANSI_WARN = 'ON';
SELECT @ANSI_WARN AS ANSI_WARNINGS;

权限

要求具有 public 角色的成员身份。

示例

下面的示例阐释了 SET ANSI_WARNINGS 为 ON 和 OFF 时的上述三种情况。

USE AdventureWorks2012;
GO

CREATE TABLE T1 
(
   a int, 
   b int NULL, 
   c varchar(20)
);
GO

SET NOCOUNT ON;

INSERT INTO T1 
VALUES (1, NULL, '') 
      ,(1, 0, '')
      ,(2, 1, '')
      ,(2, 2, '');

SET NOCOUNT OFF;
GO
  
PRINT '**** Setting ANSI_WARNINGS ON';
GO
  
SET ANSI_WARNINGS ON;
GO
  
PRINT 'Testing NULL in aggregate';
GO
SELECT a, SUM(b) 
FROM T1 
GROUP BY a;
GO
  
PRINT 'Testing String Overflow in INSERT';
GO
INSERT INTO T1 
VALUES (3, 3, 'Text string longer than 20 characters');
GO
  
PRINT 'Testing Divide by zero';
GO
SELECT a / b AS ab 
FROM T1;
GO
  
PRINT '**** Setting ANSI_WARNINGS OFF';
GO
SET ANSI_WARNINGS OFF;
GO
  
PRINT 'Testing NULL in aggregate';
GO
SELECT a, SUM(b) 
FROM T1 
GROUP BY a;
GO
  
PRINT 'Testing String Overflow in INSERT';
GO
INSERT INTO T1 
VALUES (4, 4, 'Text string longer than 20 characters');
GO
SELECT a, b, c 
FROM T1
WHERE a = 4;
GO

PRINT 'Testing Divide by zero';
GO
SELECT a / b AS ab 
FROM T1;
GO

DROP TABLE T1

请参阅

参考

INSERT (Transact-SQL)

SELECT (Transact-SQL)

SET 语句 (Transact-SQL)

SET ANSI_DEFAULTS (Transact-SQL)

SESSIONPROPERTY (Transact-SQL)