USTAW ANSI_NULL_DFLT_OFF (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

Zmienia zachowanie sesji, aby nadpisać domyślną nieważność nowych kolumn, gdy domyślna opcja ANSI null w bazie danych jest prawdziwa. 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_OFF { ON | OFF }

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse

SET ANSI_NULL_DFLT_OFF OFF

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. Domyślnie, gdy SET ANSI_NULL_DFLT_OFF jest WŁĄCZONE, nowe kolumny utworzone za pomocą instrukcji ALTER TABLE i CREATE TABLE NIE są NULL, jeśli status nulowalności kolumny nie jest wyraźnie określony. SET ANSI_NULL_DFLT_OFF nie wpływa na kolumny utworzone przez użycie jawnego 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 SET ANSI_NULL_DFLT_ON mogą być ustawione 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 unieważnienia, lepiej zawsze określać NULL lub NOT NULL w instrukcjach CREATE TABLE i ALTER TABLE.

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

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

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

Permissions

Wymaga członkostwa w roli publicznej.

Przykłady

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

USE AdventureWorks2022;  
GO  
  
-- Set the 'ANSI null default' database option to true by executing   
-- ALTER DATABASE.  
GO  
ALTER DATABASE AdventureWorks2022 SET ANSI_NULL_DEFAULT ON;  
GO  
-- Create table t1.  
CREATE TABLE t1 (a TINYINT);  
GO  
-- NULL INSERT should succeed.  
INSERT INTO t1 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_OFF to ON and create table t2.  
SET ANSI_NULL_DFLT_OFF ON;  
GO  
CREATE TABLE t2 (a TINYINT);  
GO   
-- NULL INSERT should fail.  
INSERT INTO t2 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_OFF to OFF and create table t3.  
SET ANSI_NULL_DFLT_OFF OFF;  
GO  
CREATE TABLE t3 (a TINYINT) ;  
GO   
-- NULL INSERT should succeed.  
INSERT INTO t3 (a) VALUES (NULL);  
GO  
  
-- This illustrates the effect of having both the database  
-- option and SET option disabled.  
-- Set the 'ANSI null default' database option to false.  
ALTER DATABASE AdventureWorks2022 SET ANSI_NULL_DEFAULT OFF;  
GO  
-- Create table t4.  
CREATE TABLE t4 (a TINYINT) ;  
GO   
-- NULL INSERT should fail.  
INSERT INTO t4 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_OFF to ON and create table t5.  
SET ANSI_NULL_DFLT_OFF ON;  
GO  
CREATE TABLE t5 (a TINYINT);  
GO   
-- NULL insert should fail.  
INSERT INTO t5 (a) VALUES (NULL);  
GO  
  
-- SET ANSI_NULL_DFLT_OFF to OFF and create table t6.  
SET ANSI_NULL_DFLT_OFF OFF;  
GO  
CREATE TABLE t6 (a TINYINT);   
GO   
-- NULL insert should fail.  
INSERT INTO t6 (a) VALUES (NULL);  
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)
USTAW ANSI_NULL_DFLT_ON (Transact-SQL)