COLUMNPROPERTY (Transact-SQL)

Mis à jour : 17 juillet 2006

Renvoie des informations sur une colonne ou un paramètre de procédure.

Conventions de la syntaxe de Transact-SQL

Syntaxe

COLUMNPROPERTY ( id , column , property ) 

Arguments

• id
  Expression contenant l'identificateur (ID) de la table ou de la procédure.

• column
  Expression contenant le nom de la colonne ou du paramètre.

• property
  Expression contenant les informations à renvoyer pour id qui peut prendre l'une des valeurs suivantes.

  Valeur

Exceptions

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher l'objet.

Dans SQL Server 2005, un utilisateur peut voir uniquement les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d'un droit d'accès. Cela signifie que les fonctions intégrées générant des métadonnées, telles que COLUMNPROPERTY, peuvent retourner la valeur NULL si l'utilisateur ne dispose d'aucune autorisation sur l'objet. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées et Dépannage de la visibilité des métadonnées.

Notes

Lorsque vous vérifiez la propriété déterministe d'une colonne, assurez-vous d'abord que la colonne est calculée. IsDeterministic renvoie la valeur NULL pour les colonnes non calculées. Les colonnes calculées peuvent être spécifiées sous la forme de colonnes d'index.

Types des valeurs renvoyées

int

Exemples

L'exemple suivant renvoie la longueur de la colonne LastName.

USE AdventureWorks;
GO
SELECT COLUMNPROPERTY( OBJECT_ID('Person.Contact'),'LastName','PRECISION')AS 'Column Length';
GO

Voici l'ensemble des résultats.

Column Length 
------------- 
50

(1 row(s) affected)

Voir aussi

Référence

Fonctions de métadonnées (Transact-SQL)
OBJECTPROPERTY (Transact-SQL)
TYPEPROPERTY (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Nouveau contenu : Ajout de la section « Exceptions ».