SET ANSI_NULL_DFLT_ON (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Analyseendpunkt in Microsoft FabricLagerhaus in Microsoft FabricSQL-Datenbank in Microsoft Fabric

Verändert das Sitzungsverhalten, sodass die Standardeinstellung der NULL-Zulässigkeit für neue Spalten überschrieben wird, wenn die Option ANSI NULL Default für die Datenbank auf FALSE festgelegt ist. Weitere Informationen zur Einstellung des ANSI-Null-Standardwerts finden ALTER DATABASE Sie unter (Transact-SQL).

Transact-SQL-Syntaxkonventionen

Syntax

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

Hinweise

Diese Einstellung wirkt sich nur auf die Nullfähigkeit neuer Spalten aus, wenn die Nullfähigkeit der Spalte in den CREATE TABLE and-Anweisungen ALTER TABLE nicht angegeben ist. Wenn SETSET ANSI_NULL_DFLT_ON ON ist, erlauben neue Spalten, die mit den und-Anweisungen ALTER TABLECREATE TABLE erstellt werden, Nullwerte, wenn der Nullabilitätsstatus der Spalte nicht explizit angegeben ist. SET ANSI_NULL_DFLT_ON beeinflusst keine Spalten, die mit einem expliziten NULL oder NOT NULL erstellt wurden.

Beide SETSET ANSI_NULL_DFLT_OFF und SETSET ANSI_NULL_DFLT_ON können nicht gleichzeitig EINGESCHALTET werden. Wird eine der beiden Optionen aktiviert (ON), so wird die andere deaktiviert (OFF). Daher kann entweder ANSI_NULL_DFLT_OFF oder ANSI_NULL_DFLT_ON AN gesetzt werden, oder beide können AUS gesetzt werden. Wenn eine der beiden Optionen AKTIVIERT ist, greift diese Einstellung (SETSET ANSI_NULL_DFLT_OFF oder SETSET ANSI_NULL_DFLT_ON). Wird für beide Optionen OFF festgelegt, verwendet SQL Server den Wert der Spalte is_ansi_null_default_on in der Katalogsicht sys.databases.

Für einen zuverlässigeren Betrieb Transact-SQL Skripte, die in Datenbanken mit unterschiedlichen Nullabilitätseinstellungen verwendet werden, ist es besser, NULL oder NOT NULL in CREATE TABLE und ALTER TABLE Anweisungen anzugeben.

Der SQL Server Native Client ODBC-Treiber und der OLE DB-Anbieter für SQL Server nativer Client für SQL Server werden beim Herstellen einer Verbindung automatisch auf EIN festgelegt ANSI_NULL_DFLT_ON . Die Standardeinstellung für SET ANSI_NULL_DFLT_ON ist AUS für Verbindungen von DB-Library Anwendungen.

Wenn SETSET ANSI_DEFAULTS aktiviert ist, SETSET ANSI_NULL_DFLT_ON ist diese Option aktiviert.

Die Einstellung wird SET ANSI_NULL_DFLT_ON zur Ausführung oder Laufzeit und nicht zur Analysezeit festgelegt.

Die Einstellung von SET ANSI_NULL_DFLT_ON gilt nicht, wenn Tabellen mit der SELECT INTO-Anweisung erstellt werden.

Um die aktuelle Einstellung anzuzeigen, führen Sie die folgende Abfrage aus.

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;

Berechtigungen

Erfordert die Mitgliedschaft in der public -Rolle.

Beispiele

Im folgenden Beispiel werden die Auswirkungen der beiden Einstellungen von SET ANSI_NULL_DFLT_ON für die Datenbankoption ANSI NULL Default dargestellt.

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;

Weitere Informationen

ALTER TABLE (Transact-SQL)
CREATE TABLE (Transact-SQL)
SET Anweisungen (Transact-SQL)
SET ANSI_DEFAULTS (Transact-SQL)
SET ANSI_NULL_DFLT_OFF (Transact-SQL)

  • Last updated on