SET ANSI_NULL_DFLT_ON (Transact-SQL)

Применимо к:SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsСистема платформы аналитики (PDW)Конечная точка SQL аналитики в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric

Изменяет поведение сеанса для переопределения установленной по умолчанию допустимости значений NULL для новых столбцов, если значение параметра ANSI null default для базы данных — false. Для получения дополнительной информации о назначении значения ANSI null по умолчанию см.ALTER DATABASE (Transact-SQL).

Соглашения о синтаксисе Transact-SQL

Синтаксис

-- Syntax for SQL Server and Azure SQL Database and Microsoft Fabric

SET ANSI_NULL_DFLT_ON {ON | OFF}

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse

SET ANSI_NULL_DFLT_ON ON

Замечания

Эта настройка влияет на нулевость новых столбцов только тогда, когда нулевость столбца не указана в CREATE TABLE операторах and ALTER TABLE . Когда SETSET ANSI_NULL_DFLT_ON ВКЛЮЧЕНО, новые столбцы, созданные с помощью операторов ALTER TABLE and CREATE TABLE , позволяют использовать null-значения, если статус нулируемости столбца явно не указан. SET ANSI_NULL_DFLT_ON не влияет на столбцы, созданные с явным NULL или NOT NULL.

И то, SETSET ANSI_NULL_DFLT_OFFSETSET ANSI_NULL_DFLT_ON и другое нельзя включить одновременно. Если один параметр установлен в ON, то другой установлен в OFF. Таким образом, можно включить или ANSI_NULL_DFLT_OFFANSI_NULL_DFLT_ON включить, либо оба могут быть отключены. Если любой из вариантов ВКЛЮЧЕН, эта настройка (SETSET ANSI_NULL_DFLT_OFF или SETSET ANSI_NULL_DFLT_ON) вступает в силу. Если оба параметра имеют значение OFF, SQL Server использует значение столбца is_ansi_null_default_on в представлении каталога sys.databases.

Для более надёжной работы Transact-SQL скриптов, используемых в базах данных с разными настройками нуллируемости, лучше указывать NULL или NOT NULL в CREATE TABLE и ALTER TABLE операторах.

Драйвер ODBC собственного клиента SQL Server и поставщик OLE DB собственного клиента SQL Server для SQL Server автоматически устанавливает ANSI_NULL_DFLT_ON значение ON при подключении. По умолчанию для SET ANSI_NULL_DFLT_ON подключений из DB-Library приложений используется ВЫКЛЮЧЕНО.

При SETвключении включено значение ONSET ANSI_DEFAULTSSET.SET ANSI_NULL_DFLT_ON

Параметр SET ANSI_NULL_DFLT_ON устанавливается во время выполнения или выполнения, а не во время синтаксического анализа.

Настройка не SET ANSI_NULL_DFLT_ON применяется, когда таблицы создаются с помощью оператора SELECT INTO.

Чтобы просмотреть текущее значение для этого параметра, выполните следующий запрос.

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

Разрешения

Необходимо быть членом роли public.

Примеры

В следующем примере показаны результаты применения SET ANSI_NULL_DFLT_ON с обоими значениями для параметра базы данных ANSI null default.

USE AdventureWorks2022;  
GO  
  
-- The code from this point on demonstrates that SET ANSI_NULL_DFLT_ON  
-- has an effect when the 'ANSI null default' for the database is false.  
-- Set the 'ANSI null default' database option to false by executing  
-- ALTER DATABASE.  
ALTER DATABASE AdventureWorks2022 SET ANSI_NULL_DEFAULT OFF;  
GO  
-- Create table t1.  
CREATE TABLE t1 (a TINYINT) ;  
GO   
-- NULL INSERT should fail.  
INSERT INTO t1 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_ON to ON and create table t2.  
SET ANSI_NULL_DFLT_ON ON;  
GO  
CREATE TABLE t2 (a TINYINT);  
GO   
-- NULL insert should succeed.  
INSERT INTO t2 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_ON to OFF and create table t3.  
SET ANSI_NULL_DFLT_ON OFF;  
GO  
CREATE TABLE t3 (a TINYINT);  
GO  
-- NULL insert should fail.  
INSERT INTO t3 (a) VALUES (NULL);  
GO  
  
-- The code from this point on demonstrates that SET ANSI_NULL_DFLT_ON   
-- has no effect when the 'ANSI null default' for the database is true.  
-- Set the 'ANSI null default' database option to true.  
ALTER DATABASE AdventureWorks2022 SET ANSI_NULL_DEFAULT ON  
GO  
  
-- Create table t4.  
CREATE TABLE t4 (a TINYINT);  
GO   
-- NULL INSERT should succeed.  
INSERT INTO t4 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_ON to ON and create table t5.  
SET ANSI_NULL_DFLT_ON ON;  
GO  
CREATE TABLE t5 (a TINYINT);  
GO   
-- NULL INSERT should succeed.  
INSERT INTO t5 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_ON to OFF and create table t6.  
SET ANSI_NULL_DFLT_ON OFF;  
GO  
CREATE TABLE t6 (a TINYINT);  
GO   
-- NULL INSERT should succeed.  
INSERT INTO t6 (a) VALUES (NULL);  
GO  
  
-- Set the 'ANSI null default' database option to false.  
ALTER DATABASE AdventureWorks2022 SET ANSI_NULL_DEFAULT ON;  
GO  
  
-- Drop tables t1 through t6.  
DROP TABLE t1,t2,t3,t4,t5,t6;  

См. также

ALTER TABLE (Transact-SQL)
CREATE TABLE (Transact-SQL)
SET Операторы (Transact-SQL)
SET ANSI_DEFAULTS (Transact-SQL)
SET ANSI_NULL_DFLT_OFF (Transact-SQL)