SET ANSI_NULL_DFLT_OFF (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsEndpoint de análise SQL no Microsoft FabricArmazém no Microsoft FabricBanco de dados SQL no Microsoft Fabric

Altera o comportamento da sessão para substituir a possibilidade de nulidade padrão de novas colunas quando a opção padrão nula ANSI do banco de dados é true. Para mais informações sobre como definir o valor para o padrão nulo ANSI, vejaALTER DATABASE (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

-- Syntax for SQL Server and Azure SQL Database and Microsoft Fabric
  
SET ANSI_NULL_DFLT_OFF { ON | OFF }
-- Syntax for Azure Synapse Analytics

SET ANSI_NULL_DFLT_OFF OFF

Comentários

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

Tanto SETSET ANSI_NULL_DFLT_OFF quanto SETSET ANSI_NULL_DFLT_ON LIGADO ao mesmo tempo. Se uma opção for definida como ON, a outra será definida como OFF. Portanto, ou ANSI_NULL_DFLT_OFF ou SETSET ANSI_NULL_DFLT_ON pode ser ativado, ou ambos podem ser desligados. Se qualquer uma das opções estiver ATIVADA, essa configuração (SETSET ANSI_NULL_DFLT_OFF ou SETSET ANSI_NULL_DFLT_ON) entra em vigor. Se ambas as opções forem definidas como OFF, o SQL Server usará o valor da coluna is_ansi_null_default_on na exibição de catálogo sys.databases.

Para uma operação mais confiável dos scripts Transact-SQL usados em bancos de dados com diferentes configurações de anulabilidade, é melhor sempre especificar NULL ou NOT NULL em CREATE TABLE as instruções and ALTER TABLE .

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

Para exibir a configuração atual dessa configuração, execute a consulta a seguir.

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;  

Permissões

Requer associação à função public.

Exemplos

O exemplo a seguir mostra os efeitos de SET ANSI_NULL_DFLT_OFF com ambas as configurações da opção de banco de dados Padrão ANSI null.

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;