sp_bindefault (Transact-SQL)

Enlaza un valor predeterminado con una columna o un tipo de datos de alias.

Importante:

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Se recomienda crear definiciones predeterminadas mediante la palabra clave DEFAULT de las instrucciones ALTER TABLE o CREATE TABLE. Para obtener más información, vea Crear y modificar definiciones DEFAULT.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_bindefault [ @defname = ] 'default' , 
    [ @objname = ] 'object_name' 
    [ , [ @futureonly = ] 'futureonly_flag' ] 

Argumentos

[ @defname= ] 'default'

Es el nombre del valor predeterminado creado por CREATE DEFAULT. default es de tipo nvarchar(776) y no tiene ningún valor predeterminado.

[ @objname= ] 'object_name'

Es el nombre de la tabla y la columna o del tipo de datos de alias con el que se enlaza el valor predeterminado. object_name es de tipo nvarchar(776), y no tiene ningún valor predeterminado. object_name no se puede definir con varchar(max), nvarchar(max), varbinary(max), xml o con los tipos definidos por el usuario CLR.

Si object_name es un nombre de una sola parte, se resuelve como un tipo de datos de alias. Si es un nombre de dos o tres partes, se resuelve primero como una tabla y una columna, y si esta resolución genera un error, se resuelve como un tipo de datos de alias. De forma predeterminada, las columnas existentes del tipo de datos de alias heredan default a menos que se haya enlazado directamente un valor predeterminado con la columna. No se puede enlazar un valor predeterminado con una columna de tipo text, ntext, image, varchar(max), nvarchar(max), varbinary(max), xml, timestamp o definido por el usuario CLR, una columna con la propiedad IDENTITY, una columna calculada o una columna que ya tenga una restricción DEFAULT.

[!NOTA] object_name puede contener corchetes [] como identificadores delimitados. Para obtener más información, vea Identificadores delimitados (motor de base de datos).

[ @futureonly= ] 'futureonly_flag'

Sólo se utiliza al enlazar un valor predeterminado con un tipo de datos de alias. futureonly_flag es de tipo varchar(15) y su valor predeterminado es NULL. Cuando este parámetro se establece en futureonly, las columnas existentes no pueden heredar el nuevo valor predeterminado. Este parámetro nunca se utiliza al enlazar un valor predeterminado con una columna. Si futureonly_flag es NULL, el nuevo valor predeterminado se enlaza con las columnas del tipo de datos de alias que actualmente no tengan un valor predeterminado o que utilicen el valor predeterminado existente del tipo de datos de alias.

Notas

Puede utilizar sp_bindefault para enlazar un valor predeterminado nuevo con una columna, aunque es preferible utilizar la restricción DEFAULT, o con un tipo de datos de alias sin deshacer el enlace con un valor predeterminado existente. El valor predeterminado anterior se reemplaza. No puede enlazar un valor predeterminado con un tipo de datos del sistema de SQL Server 2005 o un tipo definido por el usuario CLR. Si el valor predeterminado no es compatible con la columna con la que se debe enlazar, el SQL Server Database Engine (Motor de base de datos de SQL Server) devuelve un mensaje de error cuando intenta insertar el valor predeterminado y no cuando lo enlaza.

Las columnas existentes del tipo de datos de alias heredan el nuevo valor predeterminado a menos que tengan un valor predeterminado enlazado directamente o que se especifique futureonly_flag como futureonly. Las nuevas columnas del tipo de datos de alias siempre heredan el valor predeterminado.

Al enlazar un valor predeterminado con una columna, la información relacionada se agrega a la vista de catálogo sys.columns. Al enlazar un valor predeterminado con un tipo de datos de alias, la información relacionada se agrega a la vista de catálogo sys.types.

Permisos

El usuario debe ser propietario de la tabla o ser un miembro de la función fija de servidor sysadmin o de las funciones fijas de base de datos db_owner y db_ddladmin.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Enlazar un valor predeterminado con una columna

Se ha definido un valor predeterminado denominado today en la base de datos actual mediante CREATE DEFAULT y en el siguiente ejemplo se enlaza el valor predeterminado con la columna HireDate de la tabla Employee. Cuando se agregue una fila a la tabla Employee y no se proporcionen datos para la columna HireDate, dicha columna obtiene el valor predeterminado today.

USE master;
GO
EXEC sp_bindefault 'today', 'HumanResources.Employee.HireDate';

B. Enlazar un valor predeterminado con un tipo de datos de alias

El valor predeterminado denominado def_ssn y el tipo de datos de alias denominado ssn ya existen. En el siguiente ejemplo se enlaza el valor predeterminado def_ssn con ssn. Al crear una tabla, el valor predeterminado es heredado por todas las columnas a las que se asigna el tipo de datos de alias ssn. Las columnas existentes del tipo ssn también heredan el valor predeterminado def_ssn a menos que se especifique futureonly para el valor futureonly_flag o que la columna tenga un valor predeterminado enlazado directamente. Los valores predeterminados enlazados con columnas siempre tienen preferencia sobre los enlazados con tipos de datos.

USE master;
GO
EXEC sp_bindefault 'def_ssn', 'ssn';

C. Utilizar futureonly_flag

En el siguiente ejemplo se enlaza el valor predeterminado def_ssn con el tipo de datos de alias ssn. Dado que se especifica futureonly, esto no afecta a las columnas existentes de tipo ssn.

USE master;
GO
EXEC sp_bindefault 'def_ssn', 'ssn', 'futureonly';

D. Utilizar identificadores delimitados

En el siguiente ejemplo se muestra el uso de identificadores delimitados, [t.1], en object_name.

USE master;
GO
CREATE TABLE [t.1] (c1 int) 
-- Notice the period as part of the table name.
EXEC sp_bindefault 'default1', '[t.1].c1' 
-- The object contains two periods; 
-- the first is part of the table name, 
-- and the second distinguishes the table name from the column name.

Vea también

Referencia

Procedimientos almacenados del motor de base de datos (Transact-SQL)
CREATE DEFAULT (Transact-SQL)
DROP DEFAULT (Transact-SQL)
sp_unbindefault (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005