CREATE DEFAULT (Transact-SQL)

Articolo
12/22/2023

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

Crea un oggetto denominato valore predefinito. Quando è associato a una colonna o a un tipo di dati alias, un valore predefinito specifica un valore da inserire nella colonna a cui è associato l'oggetto (o in tutte le colonne, nel caso di un tipo di dati alias) se durante un inserimento non viene specificato in modo esplicito alcun valore.

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Al loro posto utilizzare definizioni predefinite, che è possibile creare utilizzando la parola chiave DEFAULT di ALTER TABLE o CREATE TABLE.

Convenzioni di sintassi Transact-SQL

Sintassi

  
CREATE DEFAULT [ schema_name . ] default_name   
AS constant_expression [ ; ]

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

schema_name
Nome dello schema a cui appartiene il valore predefinito.

default_name
Nome del valore predefinito. I nomi dei valori predefiniti devono essere conformi alle regole per gli identificatori. Il nome del proprietario del valore predefinito è facoltativo.

constant_expression
Espressione che include solo valori costanti. Non può includere i nomi di colonne o di altri oggetti di database. È possibile usare qualsiasi costante, funzione predefinita o espressione matematica, ad eccezione di quelle contenenti tipi di dati alias. Non è possibile usare funzioni definite dall'utente. Racchiudere le costanti per valori di carattere e data tra virgolette singole ('). Le costanti per valori di valuta, interi e a virgola mobile non richiedono le virgolette. I dati binari devono essere preceduti da 0x, mentre i dati di valuta devono essere preceduti dal simbolo di valuta. Il valore predefinito deve essere compatibile con il tipo di dati della colonna.

Osservazioni:

È possibile creare un nome predefinito solo nel database corrente. I nomi di valore predefinito in un database devono essere univoci per ogni schema. Quando si crea un valore predefinito, usare sp_bindefault per associarlo a una colonna o a un tipo di dati alias.

Se il valore predefinito non è compatibile con la colonna a cui è associato, SQL Server genera un messaggio di errore quando viene eseguito un tentativo di inserire il valore predefinito. Non è possibile, ad esempio, usare N/D come valore predefinito per una colonna numerica.

Se la lunghezza del valore predefinito è eccessiva per la colonna a cui è associato, il valore viene troncato.

Le istruzioni CREATE DEFAULT non possono essere combinate con altre istruzioni Transact-SQL in un singolo batch.

Un valore predefinito deve essere eliminato prima di poterne creare uno nuovo con lo stesso nome. È inoltre necessario annullare l'associazione del valore predefinito eseguendo sp_unbindefault prima della sua eliminazione.

Se a una colonna sono associati un valore predefinito e una regola, il valore predefinito non deve violare la regola. Un valore predefinito in conflitto con una regola non viene mai inserito e SQL Server genera un messaggio di errore ogni volta che viene eseguito un tentativo di inserire il valore predefinito.

Quando è associato a una colonna, un valore predefinito viene inserito nei casi seguenti:

Non è già stato inserito un valore in modo esplicito.
Con l'istruzione INSERT è stata specificata la parola chiave DEFAULT VALUES o DEFAULT per l'inserimento di valori predefiniti.

Se si specifica NOT NULL quando si crea una colonna e non si crea alcun valore predefinito, viene generato un messaggio di errore quando un utente non immette una voce nella colonna. Nella tabella seguente vengono descritte le relazioni tra l'esistenza di un valore predefinito e la definizione di una colonna come NULL o NOT NULL. Le voci nella tabella indicano i risultati ottenuti.

Definizione di colonna	Nessuna voce, nessun valore predefinito	Nessuna voce, valore predefinito	Voce NULL, nessun valore predefinito	Voce NULL, valore predefinito
NULL	NULL	impostazione predefinita	NULL	NULL
NOT NULL	Error	impostazione predefinita	Errore	Errore

Per rinominare un valore predefinito, usare sp_rename. Per ottenere un report relativo a un valore predefinito, usare sp_help.

Autorizzazioni

Per usare CREATE DEFAULT, un utente deve avere almeno l'autorizzazione CREATE DEFAULT nel database corrente e l'autorizzazione ALTER per lo schema in cui viene creato il valore predefinito.

Esempi

R. Creazione di un semplice valore predefinito costituito da una stringa di caratteri

Nell'esempio seguente viene creato un valore predefinito costituito dalla stringa di caratteri unknown.

USE AdventureWorks2022;  
GO  
CREATE DEFAULT phonedflt AS 'unknown';

B. Associazione di un valore predefinito

Nell'esempio seguente viene associato il valore predefinito creato nell'esempio A. Il valore predefinito viene utilizzato solo se non vengono specificate voci per la colonna Phone della tabella Contact.

Nota

Omettere una voce è diverso da specificare esplicitamente NULL in un'istruzione INSERT.

Poiché non esiste un valore predefinito denominato phonedflt, l'istruzione Transact-SQL seguente ha esito negativo. Questo esempio viene utilizzato solo a scopo illustrativo.

USE AdventureWorks2022;  
GO  
sp_bindefault 'phonedflt', 'Person.PersonPhone.PhoneNumber';

Vedi anche

ALTER TABLE (Transact-SQL)
CREATE RULE (Transact-SQL)
CREATE TABLE (Transact-SQL)
DROP DEFAULT (Transact-SQL)
DROP RULE (Transact-SQL)
Espressioni (Transact-SQL)
INSERT (Transact-SQL)
sp_bindefault (Transact-SQL)
sp_help (Transact-SQL)
sp_helptext (Transact-SQL)
sp_rename (Transact-SQL)
sp_unbindefault (Transact-SQL)