sp_bindefault (Transact-SQL)

Syntaxe

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

Arguments

• [ [ @defname= ] 'default'
  Nom de la valeur par défaut créée par l'instruction CREATE DEFAULT. default est de type nvarchar(776) et n'a pas de valeur par défaut.

• [ [ @objname= ] 'object_name'
  Nom de la table et de la colonne ou type de données d'alias, auquel est liée la valeur par défaut. object_name est de type nvarchar(776) et n'a pas de valeur par défaut. object_name ne peut pas être défini avec varchar(max), nvarchar(max), varbinary(max), xml ou les types CLR définis par l'utilisateur.

  Si object_name est un nom à une composante, il est résolu en tant que type de données d'alias. S'il s'agit d'un nom à deux ou trois composantes, il est d'abord résolu en tant que table et colonne. Si la résolution échoue, il est résolu en tant que type de données d'alias. Par défaut, les colonnes existantes du type de données d'alias héritent de default, sauf si une valeur par défaut a été liée directement à la colonne. Une valeur par défaut ne peut pas être liée à une colonne de type text, ntext, image, varchar(max), nvarchar(max), varbinary(max), xml, timestamp ou à une colonne de type CLR définie par l'utilisateur, une colonne dont la propriété est IDENTITY, une colonne calculée ou une colonne qui a déjà une contrainte DEFAULT.

  Notes

  object_name peut contenir des crochets [] comme identificateurs délimités. Pour plus d'informations, consultez Identificateurs délimités (Moteur de base de données).

• [ [ @futureonly= ] 'futureonly_flag'
  S'utilise seulement pour lier une valeur par défaut à un type de données d'alias. L'argument futureonly_flag est de type varchar(15). Sa valeur par défaut est NULL. Lorsque ce paramètre est défini sur futureonly, les colonnes existantes de ce type de données ne peuvent pas hériter la nouvelle valeur par défaut. Il ne s'emploie jamais lors de la liaison d'une valeur par défaut à une colonne. Si futureonly_flag a pour valeur NULL, la nouvelle valeur par défaut est liée à toute colonne du type de données d'alias qui ne possède pas encore de valeur par défaut ou qui utilise la valeur par défaut existante du type de données d'alias.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Vous pouvez lier une nouvelle valeur par défaut à une colonne (il est toutefois recommandé d'utiliser une contrainte DEFAULT) ou à un type de données d'alias à l'aide de sp_bindefault sans dissocier de valeur par défaut existante. L'ancienne valeur par défaut est remplacée par la nouvelle. Vous ne pouvez pas lier une valeur par défaut à une type de données système SQL Server ou à un type CLR défini par l'utilisateur. En cas d'incompatibilité entre la valeur par défaut et la colonne à laquelle vous l'avez liée, Moteur de base de données SQL Server retourne un message d'erreur quand il essaie d'insérer la valeur par défaut et non au moment de sa liaison.

Les colonnes existantes qui utilisent le type de données d'alias héritent la nouvelle valeur par défaut, sauf si elles sont liées directement à une valeur par défaut ou si futureonly_flag est défini comme futureonly. Les nouvelles colonnes qui utilisent le type de données d'alias héritent toujours la valeur par défaut.

Lorsque vous liez une valeur par défaut à une colonne, l'information correspondante est ajoutée à la vue de catalogue sys.columns. Lorsque vous liez une valeur par défaut à un type de données d'alias, l'information correspondante est ajoutée à la vue de catalogue sys.types.

Autorisations

L'utilisateur doit posséder la table ou être membre du rôle de serveur fixe sysadmin, ou du rôle de base de données fixe db_owner et db_ddladmin.

Exemples

A. Liaison d'une valeur par défaut à une colonne

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

B. Liaison d'une valeur par défaut à un type de données d'alias

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

C. Utilisation de l'argument futureonly_flag

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

D. Utilisation des identificateurs délimités

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.

Voir aussi

Référence