sp_bindrule (Transact-SQL)

Syntaxe

sp_bindrule [ @rulename = ] 'rule' , 
     [ @objname = ] 'object_name' 
     [ , [ @futureonly = ] 'futureonly_flag' ] 

Arguments

• [ [ @rulename=] 'rule'
  Nom d'une règle créée par l'instruction CREATE RULE. rule est de type nvarchar(776) et n'a pas de valeur par défaut.

• [ @objname=] 'object_name'
  Table ou colonne, ou bien type de données d'alias auquel la règle doit être liée. Une règle ne peut pas être associée à un type de données CLR défini par l'utilisateur, text, ntext, image, varchar(max), nvarchar(max), varbinary(max), xml ou à une colonne timestamp. Une règle ne peut pas être liée à une colonne calculée.

  object_name est de type nvarchar(776) et n'a pas de valeur par défaut. 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 en deux ou trois parties, 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 rule, sauf si une règle a été liée directement à la colonne.

  Notes

  object_name peut contenir les caractères crochet [ et ] comme caractères d'identificateur délimité. Pour plus d'informations, consultez Identificateurs délimités (Moteur de base de données).

  Notes

  Les règles créées sur des expressions utilisant des types de données d'alias peuvent être liées à des colonnes ou des types de données d'alias, mais ne peuvent pas être compilées lorsqu'elles sont référencées. Évitez d'utiliser des règles créées sur des types de données d'alias.

• [ [ @futureonly= ] 'futureonly_flag'
  S'utilise seulement pour lier une règle à un type de données d'alias. L'argument future_only_flag est de type varchar(15). Sa valeur par défaut est NULL. Ce paramètre, lorsqu'il a la valeur futureonly, empêche les colonnes existantes d'un type de données d'alias d'hériter de la nouvelle règle. Si futureonly_flag a pour valeur NULL, la nouvelle règle est liée à toute colonne du type de données d'alias qui n'a pas de règle à ce moment, ou qui utilise la règle existante du type de données d'alias.

Valeurs des codes renvoyés

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

Notes

Vous pouvez lier une nouvelle règle à une colonne (il est toutefois recommandé d'utiliser une contrainte CHECK) ou à un type de données d'alias à l'aide de sp_bindrule sans dissocier une règle existante. L'ancienne règle est remplacée par la nouvelle. Si une règle est associée à une colonne à l'aide d'une contrainte CHECK existante, toutes les restrictions sont évaluées. Vous ne pouvez pas lier de règle à un type de données SQL Server.

La règle s'impose lors d'une tentative d'insertion de données (INSERT) et non au moment de la liaison. Il est possible de lier une règle de type de données caractère à une colonne de type de données numeric, bien qu'une telle opération INSERT ne soit pas valide.

Les colonnes existantes d'un type de données défini par l'utilisateur héritent de la nouvelle règle, sauf si futureonly_flag a la valeur futureonly. Les nouvelles colonnes définies avec le type de données d'alias héritent toujours de la règle. Si la clause ALTER COLUMN d'une instruction ALTER TABLE change le type de données d'une colonne en un type de données d'alias lié à une règle, la colonne n'hérite pas de cette règle liée au type de données. Il convient de lier la règle elle-même à la colonne à l'aide de sp_bindrule.

Lorsque vous liez une règle à une colonne, l'information correspondante est ajoutée à la table sys.columns. Lorsque vous liez une règle à un type de données d'alias, les informations correspondantes sont ajoutées à la table sys.types.

Autorisations

Pour lier une règle à une colonne de table, une autorisation ALTER est nécessaire sur la table. Pour lier une règle à un type de données d'alias, il est nécessaire de disposer d'une autorisation CONTROL sur le type de données d'alias ou d'une autorisation ALTER sur le schéma auquel le type appartient.

Exemples

A. Liaison d'une règle à une colonne

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

B. Liaison d'une règle à un type de données d'alias

USE master;
GO
EXEC sp_bindrule 'rule_ssn', 'ssn'

C. Utilisation de l'argument futureonly_flag

USE master;
GO
EXEC sp_bindrule rule_ssn, 'ssn', 'futureonly'

D. Utilisation des identificateurs délimités

USE master;
GO
CREATE TABLE [t.2] (c1 int) 
-- Notice the period as part of the table name.
EXEC sp_bindrule rule1, '[t.2].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