SET ANSI_NULL_DFLT_OFF (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

Altera o comportamento da sessão para sobrepor a nulidade padrão das novas colunas quando a opção ANSI nula por defeito para a base de dados é verdadeira. Para mais informações sobre como definir o valor para o padrão nulo ANSI, veja ALTER DATABASE (Transact-SQL).

Transact-SQL convenções de sintaxe

Sintaxe

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

Observações

Esta configuração só afeta a nulidade das novas colunas quando a nulidade da coluna não está especificada nas instruções CREATE TABLE e ALTER TABLE. Por defeito, quando o ANSI_NULL_DFLT_OFF SET está ON, as novas colunas criadas usando as instruções ALTER TABLE e CREATE TABLE NÃO são NULAS se o estado de anulabilidade da coluna não for explicitamente especificado. O SET ANSI_NULL_DFLT_OFF não afeta colunas criadas usando um NULL explícito ou NOT NULL.

Tanto SET ANSI_NULL_DFLT_OFF como SET ANSI_NULL_DFLT_ON não podem ser ativados ao mesmo tempo. Se uma opção estiver ATIVADA, a outra opção fica DESLIGADA. Portanto, tanto ANSI_NULL_DFLT_OFF como SET ANSI_NULL_DFLT_ON podem ser ativados, ou ambos podem ser desligados. Se alguma das opções estiver ATIVADA, essa definição (SET ANSI_NULL_DFLT_OFF ou SET ANSI_NULL_DFLT_ON) entra em vigor. Se ambas as opções estiverem desativadas, o SQL Server usa o valor da coluna is_ansi_null_default_on na vista de catálogo sys.databases .

Para uma operação mais fiável dos scripts Transact-SQL usados em bases de dados com diferentes definições de anulabilidade, é melhor especificar sempre NULL ou NOT NULL nas instruções CREATE TABLE e ALTER TABLE.

A definição do SET ANSI_NULL_DFLT_OFF é definida em tempo de execução ou execução e não em tempo de análise.

Para visualizar a definição atual desta definição, execute a seguinte consulta.

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

Requer a participação na função pública.

Examples

O exemplo seguinte mostra os efeitos de SET ANSI_NULL_DFLT_OFF com ambas as definições para a opção de base de dados padrão 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;  
  

Ver também

ALTERAR TABELA (Transact-SQL)
CRIAR TABELA (Transact-SQL)
Instruções SET (Transact-SQL)
SET ANSI_NULL_DFLT_ON (Transact-SQL)