適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウスMicrosoft Fabric の SQL データベース
セッションの動作を変更して、データベースの ANSI null default オプションが false である場合の、新しい列の NULL 値に関する既定の設定をオーバーライドします。 ANSIのヌルデフォルト値の設定についての詳細は、ALTER DATABASE(Transact-SQL)を参照してください。
構文
-- 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
解説
この設定は、 CREATE TABLE 文や ALTER TABLE 文で列のnullabilityが指定されていない場合のみ、新しい列のnullabilityに影響します。 SET SET ANSI_NULL_DFLT_ONがONの場合、ALTER TABLE文とCREATE TABLE文を使って新たに作成される列は、列のnull可能性状態が明示的に指定されていない場合、null値を使用できます。 SET ANSI_NULL_DFLT_ON 明示的なNULLまたはNOT NULLで作成されたカラムには影響しません。
SET SET ANSI_NULL_DFLT_OFFとSETSET ANSI_NULL_DFLT_ONの両方を同時にONにすることはできません。 一方のオプションが ON に設定されている場合、他方のオプションは OFF に設定されます。 したがって、 ANSI_NULL_DFLT_OFF または ANSI_NULL_DFLT_ON のいずれかをONに設定するか、両方をOFFに設定することも可能です。 どちらかのオプションがオンの場合、その設定(SETSET ANSI_NULL_DFLT_OFF または SETSET ANSI_NULL_DFLT_ON)が有効になります。 両方のオプションを OFF に設定した場合、SQL Server では sys.databases カタログ ビューにある is_ansi_null_default_on 列の値が使用されます。
異なるnullability設定を持つデータベースで使われる Transact-SQL スクリプトをより信頼性の高い操作にするためには、 CREATE TABLE 文や ALTER TABLE 文でNULLまたはNOT NULLを指定する方が良いです。
SQL Server Native Client ODBC ドライバーと SQL Server Native Client OLE DB Provider for SQL Server は、接続時に自動的に ANSI_NULL_DFLT_ON を ON に設定します。 DB-Library アプリケーションからの接続に対しては、SET ANSI_NULL_DFLT_ON は既定で OFF に設定されています。
SET SET ANSI_DEFAULTSがオンの場合、SETSET ANSI_NULL_DFLT_ONが有効になります。
SET ANSI_NULL_DFLT_ONの設定は、解析時ではなく実行時に設定されます。
SET ANSI_NULL_DFLT_ONの設定は、SELECT INTO文でテーブルを作成する場合には適用されません。
この設定の現在の設定を表示するには、次のクエリを実行します。
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;
アクセス許可
ロール public のメンバーシップが必要です。
例
次の例では、SET ANSI_NULL_DFLT_ON データベース オプションに 2 種類の設定を使用した場合の の効果を示します。
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;
参照
ALTER TABLE (Transact-SQL)
CREATE TABLE (Transact-SQL)
SET ステートメント (Transact-SQL)
SET ANSI_DEFAULTS (Transact-SQL)
SET ANSI_NULL_DFLT_OFF (Transact-SQL)