CREATE DEFAULT (Transact-SQL)

Artículo
05/30/2023

Se aplica a:SQL Server Azure SQL Database Azure SQL Managed Instance

Crea un objeto denominado valor predeterminado. Cuando se enlaza a una columna o a un tipo de datos de alias, un valor predeterminado especifica un valor que debe insertarse en la columna a la que está enlazado el objeto, o en todas las columnas, en el caso de un tipo de datos de alias, si no se proporciona explícitamente un valor durante la inserción.

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use definiciones predeterminadas creadas con la palabra clave DEFAULT de ALTER TABLE o CREATE TABLE.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

schema_name
El nombre del esquema al que pertenece el valor predeterminado.

default_name
El nombre del valor predeterminado. Los nombres predeterminados deben cumplir las reglas de los identificadores. Especificar el nombre del propietario del valor predeterminado es opcional.

constant_expression
Una expresión que contiene solo valores constantes (no puede contener el nombre de ninguna columna u otros objetos de base de datos). Puede utilizar cualquier constante, función integrada o expresión matemática, excepto las que contienen tipos de datos de alias. No es posible utilizar funciones definidas por el usuario. Incluya las constantes de caracteres y fechas entre comillas simples ('); las constantes de moneda, de enteros y de coma flotante no necesitan comillas. Los datos binarios deben precederse de 0x y los datos de moneda deben precederse de un signo de dólar ($). El valor predeterminado debe ser compatible con el tipo de datos de la columna.

Observaciones

Solo puede crear un nombre predeterminado en la base de datos actual. En una base de datos, los nombres predeterminados deben ser únicos para cada esquema. Al crear un valor predeterminado, use sp_bindefault para enlazarlo a una columna o a un tipo de datos de alias.

Si el valor predeterminado no es compatible con la columna a la que está enlazado, SQL Server genera un mensaje de error al intentar insertar el valor predeterminado. Por ejemplo, N/A no se puede usar como valor predeterminado para una columna numérica.

Si el valor predeterminado es demasiado largo para la columna a la que está enlazado, el valor se trunca.

Las instrucciones CREATE DEFAULT no se pueden combinar con otras instrucciones Transact-SQL en el mismo lote.

Un valor predeterminado debe quitarse antes de crear otro con el mismo nombre. Además, se debe anular el enlace del valor predeterminado con la ejecución de sp_unbindefault antes de quitarlo.

Si una columna tiene un valor predeterminado y una regla asociados, el valor predeterminado no debe infringir la regla. No se insertará nunca un valor predeterminado que esté en conflicto con una regla y SQL Server genera un mensaje de error cada vez que se intente insertar el valor predeterminado.

Cuando se enlaza a una columna, un valor predeterminado se inserta cuando:

No se ha insertado un valor explícitamente.
Se utilizan las palabras clave DEFAULT VALUES o DEFAULT con INSERT para insertar valores predeterminados.

Si especifica NOT NULL al crear una columna y no crea un valor predeterminado para esta, se generará un mensaje de error cada vez que el usuario no cree una entrada en esa columna. En la tabla siguiente se ilustra la relación entre la existencia de un valor predeterminado y la definición de una columna como NULL o NOT NULL. Las entradas de la tabla muestran el resultado.

Definición de columna	Sin entrada, sin valor predeterminado	Sin entrada, valor predeterminado	Entrada NULL, sin valor predeterminado	Entrada NULL, valor predeterminado
NULL	NULL	default	NULL	NULL
NOT NULL	Error	default	error	error

Para cambiar el nombre de un valor predeterminado, use sp_rename. Para obtener un informe sobre un valor predeterminado, use sp_help.

Permisos

Para usar CREATE DEFAULT, como mínimo, un usuario debe tener el permiso CREATE DEFAULT en la base de datos actual y el permiso ALTER en el esquema donde se va a crear el valor predeterminado.

Ejemplos

A. Crear un valor predeterminado de caracteres de tipo sencillo

En el siguiente ejemplo se crea un valor predeterminado de caracteres denominado unknown.

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

B. Enlazar un valor predeterminado

En el siguiente ejemplo se enlaza el valor predeterminado creado en el ejemplo A. El valor predeterminado solo entra en efecto si no hay ninguna entrada especificada en la columna Phone de la tabla Contact.

Nota

Omitir una entrada no es lo mismo que incluir NULL explícitamente en una instrucción INSERT.

Como no existe un valor predeterminado llamado phonedflt, se producirá un error en la siguiente instrucción Transact-SQL. Este ejemplo solo tiene propósitos ilustrativos.

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

Consulte también

ALTER TABLE (Transact-SQL)
CREATE RULE (Transact-SQL)
CREATE TABLE (Transact-SQL)
DROP DEFAULT (Transact-SQL)
DROP RULE (Transact-SQL)
Expresiones (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)