SET ANSI_NULL_DFLT_ON (Transact-SQL)

Modifie le comportement de la session de manière à supplanter l'acceptation par défaut des valeurs NULL dans les nouvelles colonnes lorsque l'option ANSI null default de la base de données a la valeur false. Pour plus d'informations sur la configuration de la valeur de l'option ANSI null default, consultez ALTER DATABASE (Transact-SQL) et Définition des options de base de données.

Conventions de la syntaxe de Transact-SQL

Syntaxe

SET ANSI_NULL_DFLT_ON {ON | OFF}

Notes

Ce paramètre affecte l'acceptation des valeurs NULL dans une nouvelle colonne, uniquement si celle-ci n'est pas spécifiée dans les instructions CREATE TABLE et ALTER TABLE. Lorsque l'option SET ANSI_NULL_DFLT_ON est activée (ON), les nouvelles colonnes créées à l'aide de l'instruction ALTER TABLE ou CREATE TABLE autorisent les valeurs NULL si cet état n'est pas explicitement spécifié pour ces dernières. SET ANSI_NULL_DFLT_ON n'a aucun effet sur les colonnes créées avec une valeur NULL ou NOT NULL explicite.

SET ANSI_NULL_DFLT_OFF et SET ANSI_NULL_DFLT_ON ne peuvent pas être activées (valeur ON) simultanément. Si l'une des options a la valeur ON, l'autre a automatiquement la valeur OFF. Par conséquent, SET ANSI_NULL_DFLT_OFF ou SET ANSI_NULL_DFLT_ON peut avoir la valeur ON ou les deux peuvent avoir la valeur OFF. Si l'une des deux options a la valeur ON, ce paramètre (SET ANSI_NULL_DFLT_OFF ou SET ANSI_NULL_DFLT_ON) prend effet. Si la valeur des deux options est OFF, SQL Server utilise la valeur de la colonne is_ansi_null_default_on dans l'affichage catalogue sys.databases.

Pour garantir un meilleur fonctionnement des scripts Transact-SQL utilisés dans des bases de données gérant différemment l'acceptation de valeurs NULL, il est préférable de spécifier NULL ou NOT NULL dans les instructions CREATE TABLE et ALTER TABLE.

Le pilote ODBC du client natif SQL Server et le fournisseur OLE DB du client natif SQL Server pour SQL Server affectent automatiquement la valeur ON à ANSI_NULL_DFLT_ON lors de la connexion. Dans le cas d'applications DB-Library, SET ANSI_NULL_DFLT_ON prend par défaut la valeur OFF.

Lorsque SET ANSI_DEFAULTS est défini sur ON, l'option SET ANSI_NULL_DFLT_ON est activée.

La valeur de SET ANSI_NULL_DFLT_ON est définie lors de l'exécution, et non pas durant l'analyse.

Autorisations

Nécessite l'appartenance au rôle public.

Exemple

L'exemple suivant illustre les effets de SET ANSI_NULL_DFLT_ON lorsque la valeur de l'option de base de données ANSI null default est ON et OFF, respectivement.

USE AdventureWorks;
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 AdventureWorks 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 AdventureWorks 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 AdventureWorks SET ANSI_NULL_DEFAULT ON
GO

-- Drop tables t1 through t6.
DROP TABLE t1
DROP TABLE t2
DROP TABLE t3
DROP TABLE t4
DROP TABLE t5
DROP TABLE t6

Voir aussi

Référence

ALTER TABLE (Transact-SQL)

CREATE TABLE (Transact-SQL)

SET (Transact-SQL)

SET ANSI_DEFAULTS (Transact-SQL)

SET ANSI_NULL_DFLT_OFF (Transact-SQL)