DROP DEFAULT (Transact-SQL)

Articolo
10/16/2024

Si applica a: SQL Server Istanza gestita di SQL di Azure

Rimuove dal database corrente uno o più valori predefiniti creati dall'utente.

Importante

L'istruzione DROP DEFAULT verrà rimossa a partire dalla prossima versione di Microsoft SQL Server. Non utilizzare DROP DEFAULT in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni che attualmente la utilizzano. In alternativa, usare le definizioni di valori predefiniti che è possibile creare con la parola chiave DEFAULT dell'istruzione ALTER TABLE o CREATE TABLE.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

DROP DEFAULT [ IF EXISTS ] { [ schema_name . ] default_name } [ ,...n ] [ ; ]

Argomenti

IF EXISTS
Si applica a: SQL Server ( SQL Server 2016 (13.x) fino alla versione corrente).

Rimuove in modo condizionale l'impostazione predefinita solo se esiste già.

schema_name
Nome dello schema a cui appartiene il valore predefinito.

default_name
Nome di un valore predefinito esistente. Per visualizzare un elenco dei valori predefiniti esistenti, eseguire sp_help. I valori predefiniti devono essere conformi alle regole per gli identificatori. Il nome dello schema predefinito è facoltativo.

Osservazioni:

Prima di eliminare un valore predefinito associato a una colonna o un tipo di dati alias, è necessario annullarne l'associazione eseguendo sp_unbindefault.

Se si aggiungono nuove righe senza specificare in modo esplicito un valore dopo avere eliminato un valore predefinito da una colonna che ammette valori Null, in tale posizione verrà inserita la stringa NULL. Se si aggiungono nuove righe senza specificare in modo esplicito un valore dopo avere eliminato un valore predefinito da una colonna NOT NULL, verrà visualizzato un messaggio di errore. Queste righe vengono aggiunte successivamente durante la normale esecuzione dell'istruzione INSERT.

Autorizzazioni

Per eseguire l'istruzione DROP DEFAULT, è necessario disporre almeno dell'autorizzazione ALTER per lo schema a cui appartiene il valore predefinito.

Esempi

R. Eliminazione di un valore predefinito

Se un valore predefinito non è associato a una colonna o un tipo di dati alias, è possibile eliminarlo semplicemente tramite l'istruzione DROP DEFAULT. Nell'esempio seguente viene rimosso il valore predefinito datedflt creato dall'utente.

USE AdventureWorks2022;  
GO  
IF EXISTS (SELECT name FROM sys.objects  
         WHERE name = 'datedflt'   
            AND type = 'D')  
   DROP DEFAULT datedflt;  
GO

A partire da SQL Server 2016 (13.x) è possibile usare la sintassi seguente.

DROP DEFAULT IF EXISTS datedflt;  
GO

B. Eliminazione di un valore predefinito associato a una colonna

Nell'esempio seguente viene disassociato e quindi eliminato il valore predefinito EmergencyContactPhone associato alla colonna Contact della tabella phonedflt.

USE AdventureWorks2022;  
GO  
   BEGIN   
      EXEC sp_unbindefault 'Person.Contact.Phone'  
      DROP DEFAULT phonedflt  
   END;  
GO

Vedi anche

CREATE DEFAULT (Transact-SQL)
sp_helptext (Transact-SQL)
sp_help (Transact-SQL)
sp_unbindefault (Transact-SQL)

Condividi tramite