USTAW ANSI_NULL_DFLT_ON (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punkt końcowy analizy SQL w usłudze Microsoft FabricHurtownia danych w usłudze Microsoft FabricBaza danych SQL w usłudze Microsoft Fabric

Modyfikuje zachowanie sesji, aby nadpisać domyślną nieważność nowych kolumn, gdy domyślna opcja ANSI null dla bazy danych jest fałszywa. Więcej informacji o ustawianiu wartości dla ANSI null default można znaleźć w ALTER DATABASE (Transact-SQL).

Transact-SQL konwencje składni

Składnia

-- 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

Uwagi

To ustawienie wpływa na unieważnienie nowych kolumn tylko wtedy, gdy zerowalność kolumny nie jest określona w instrukcjach CREATE TABLE i ALTER TABLE. Gdy SET ANSI_NULL_DFLT_ON jest WŁĄCZONY, nowe kolumny utworzone za pomocą instrukcji ALTER TABLE i CREATE TABLE pozwalają na wartości zerowe, jeśli status nieważności kolumny nie jest wyraźnie określony. SET ANSI_NULL_DFLT_ON nie wpływa na kolumny utworzone z jawnym NULL lub NOT NULL.

Zarówno SET ANSI_NULL_DFLT_OFF, jak i SET ANSI_NULL_DFLT_ON nie mogą być ustawione jednocześnie ON. Jeśli jedna opcja jest włączona, druga jest wyłączona. Dlatego albo ANSI_NULL_DFLT_OFF, albo ANSI_NULL_DFLT_ON można ustawić ON, albo oba mogą być WYŁĄCZONE. Jeśli któraś z opcji jest WŁĄCZONA, to to ustawienie (USTAW ANSI_NULL_DFLT_OFF lub USTAW ANSI_NULL_DFLT_ON) zaczyna działać. Jeśli obie opcje są wyłączone, SQL Server używa wartości kolumny is_ansi_null_default_on w widoku katalogu sys.databases .

Aby działać bardziej niezawodnie Transact-SQL skryptów używanych w bazach danych z różnymi ustawieniami nulowalności, lepiej jest określić NULL lub NOT NULL w instrukcjach CREATE TABLE i ALTER TABLE.

SQL Server Native Client ODBC driver oraz SQL Server Native Client OLE DB Provider dla SQL Server automatycznie ustawiają ANSI_NULL_DFLT_ON na ON podczas połączenia. Domyślnie dla SET ANSI_NULL_DFLT_ON jest WYŁĄCZONE dla połączeń z DB-Library aplikacji.

Gdy SET ANSI_DEFAULTS jest WŁĄCZONE, SET ANSI_NULL_DFLT_ON jest włączony.

Ustawienie SET ANSI_NULL_DFLT_ON jest ustawiane w czasie wykonywania lub działania, a nie w czasie parsowania.

Ustawienie SET ANSI_NULL_DFLT_ON nie ma zastosowania, gdy tabele są tworzone za pomocą instrukcji SELECT INTO.

Aby zobaczyć aktualne ustawienie dla tego ustawienia, uruchom następujące zapytanie.

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;  
  

Permissions

Wymaga członkostwa w publicznej roli .

Przykłady

Poniższy przykład pokazuje skutki SET ANSI_NULL_DFLT_ON obu ustawień dla domyślnej opcji bazy danych ANSI.

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;  

Zobacz też

ZMIEŃ TABELĘ (Transact-SQL)
CREATE TABLE (Transact-SQL)
INSTRUKCJE SET (Transact-SQL)
ZESTAW ANSI_DEFAULTS (Transact-SQL)
USTAW ANSI_NULL_DFLT_OFF (Transact-SQL)