SET ANSI_NULL_DFLT_OFF (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)Titik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft Fabric

Mengubah perilaku sesi untuk menimpa nullabilitas default kolom baru ketika opsi default null ANSI untuk database adalah true. Untuk informasi selengkapnya tentang mengatur nilai untuk default NULL ANSI, lihat MENGUBAH DATABASE (Transact-SQL).

Konvensi sintaks transact-SQL

Sintaksis

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

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Keterangan

Pengaturan ini hanya memengaruhi nullability kolom baru ketika nullability kolom tidak ditentukan dalam pernyataan CREATE TABLE dan ALTER TABLE. Secara default, ketika SET ANSI_NULL_DFLT_OFF AKTIF, kolom baru yang dibuat dengan menggunakan pernyataan ALTER TABLE dan CREATE TABLE TIDAK NULL jika status nullability kolom tidak ditentukan secara eksplisit. SET ANSI_NULL_DFLT_OFF tidak memengaruhi kolom yang dibuat dengan menggunakan NULL eksplisit atau NOT NULL.

SET ANSI_NULL_DFLT_OFF dan SET ANSI_NULL_DFLT_ON tidak dapat diatur AKTIF secara bersamaan. Jika satu opsi diatur AKTIF, opsi lainnya diatur NONAKTIF. Oleh karena itu, ANSI_NULL_DFLT_OFF atau SET ANSI_NULL_DFLT_ON dapat diatur AKTIF, atau keduanya dapat diatur NONAKTIF. Jika salah satu opsi aktif, pengaturan tersebut (SET ANSI_NULL_DFLT_OFF atau SET ANSI_NULL_DFLT_ON) berlaku. Jika kedua opsi diatur NONAKTIF, SQL Server menggunakan nilai kolom is_ansi_null_default_on dalam tampilan katalog sys.databases .

Untuk operasi skrip Transact-SQL yang lebih andal yang digunakan dalam database dengan pengaturan nullability yang berbeda, lebih baik selalu menentukan NULL atau NOT NULL dalam pernyataan CREATE TABLE dan ALTER TABLE.

Pengaturan SET ANSI_NULL_DFLT_OFF diatur pada waktu eksekusi atau run time dan bukan pada waktu penguraian.

Untuk menampilkan pengaturan saat ini untuk pengaturan ini, jalankan kueri berikut.

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;  

Izin

Memerlukan keanggotaan dalam peran publik.

Contoh

Contoh berikut menunjukkan efek dengan SET ANSI_NULL_DFLT_OFF kedua pengaturan untuk opsi database default null 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;  
  

Lihat Juga

ALTER TABLE (Transact-SQL)
BUAT TABEL (Transact-SQL)
Pernyataan SET (Transact-SQL)
SET ANSI_NULL_DFLT_ON (Transact-SQL)