OBJECTPROPERTY (Transact-SQL)

Retourne des informations concernant les objets étendus aux schémas dans la base de données actuelle. Pour obtenir la liste de tous les objets étendus aux schémas, consultez sys.objects (Transact-SQL). Cette fonction ne peut pas être utilisée pour les objets non étendus aux schémas, tels que les déclencheurs DDL et les notifications d'événements.

Conventions de la syntaxe Transact-SQL

Syntaxe

OBJECTPROPERTY ( id , property ) 

Arguments

• id
  Expression représentant l'ID de l'objet dans la base de données active. id est de type int et est considéré comme un objet étendu aux schémas dans le contexte de la base de données active.

• property
  Expression représentant les informations devant être retournées pour l'objet spécifié par id. property peut avoir l'une des valeurs suivantes.

  [!REMARQUE]

  Sauf indication contraire, NULL est retourné lorsque property n'est pas un nom de propriété valide, lorsque id n'est pas un ID d'objet valide, lorsque id est un type d'objet non pris en charge pour la valeur spécifiée de property, ou lorsque l'appelant n'est pas autorisé à consulter les métadonnées de l'objet.

  Nom de la propriété	Type d'objet	Description et valeurs retournées
  CnstIsClustKey	Contrainte	Contrainte PRIMARY KEY avec un index cluster. 1 = True 0 = False
  CnstIsColumn	Contrainte	Contrainte CHECK, DEFAULT ou FOREIGN KEY sur une seule colonne. 1 = True 0 = False
  CnstIsDeleteCascade	Contrainte	Contrainte FOREIGN KEY avec l'option ON DELETE CASCADE. 1 = True 0 = False
  CnstIsDisabled	Contrainte	Contrainte désactivée. 1 = True 0 = False
  CnstIsNonclustKey	Contrainte	Contrainte PRIMARY KEY ou UNIQUE avec index non-cluster. 1 = True 0 = False
  CnstIsNotRepl	Contrainte	La contrainte est définie avec les mots clés NOT FOR REPLICATION. 1 = True 0 = False
  CnstIsNotTrusted	Contrainte	La contrainte a été activée sans vérifier les lignes existantes. Elle peut ne pas s'appliquer à toutes les lignes. 1 = True 0 = False
  CnstIsUpdateCascade	Contrainte	Contrainte FOREIGN KEY avec l'option ON UPDATE CASCADE. 1 = True 0 = False
  ExecIsAfterTrigger	Déclencheur	Déclencheur AFTER. 1 = True 0 = False
  ExecIsAnsiNullsOn	Fonction Transact-SQL, procédure Transact-SQL, déclencheur Transact-SQL, vue	Définition de valeurs ANSI NULL lors de la création. 1 = True 0 = False
  ExecIsDeleteTrigger	Déclencheur	Déclencheur DELETE. 1 = True 0 = False
  ExecIsFirstDeleteTrigger	Déclencheur	Premier déclencheur activé lorsqu'une instruction DELETE est exécutée sur la table. 1 = True 0 = False
  ExecIsFirstInsertTrigger	Déclencheur	Premier déclencheur activé lorsqu'une instruction INSERT est exécutée sur la table. 1 = True 0 = False
  ExecIsFirstUpdateTrigger	Déclencheur	Premier déclencheur activé lorsqu'une instruction UPDATE est exécutée sur la table. 1 = True 0 = False
  ExecIsInsertTrigger	Déclencheur	Déclencheur INSERT. 1 = True 0 = False
  ExecIsInsteadOfTrigger	Déclencheur	Déclencheur INSTEAD OF. 1 = True 0 = False
  ExecIsLastDeleteTrigger	Déclencheur	Dernier déclencheur activé lorsqu'une instruction DELETE est exécutée sur la table. 1 = True 0 = False
  ExecIsLastInsertTrigger	Déclencheur	Dernier déclencheur activé lorsqu'une instruction INSERT est exécutée sur la table. 1 = True 0 = False
  ExecIsLastUpdateTrigger	Déclencheur	Dernier déclencheur activé lorsqu'une instruction UPDATE est exécutée sur la table. 1 = True 0 = False
  ExecIsQuotedIdentOn	Fonction Transact-SQL, procédure Transact-SQL, déclencheur Transact-SQL, vue	Définition de QUOTED_IDENTIFIER lors de la création. 1 = True 0 = False
  ExecIsStartup	Procédure	Procédure de démarrage. 1 = True 0 = False
  ExecIsTriggerDisabled	Déclencheur	Déclencheur désactivé. 1 = True 0 = False
  ExecIsTriggerNotForRepl	Déclencheur	Déclencheur défini comme NOT FOR REPLICATION. 1 = True 0 = False
  ExecIsUpdateTrigger	Déclencheur	Déclencheur UPDATE. 1 = True 0 = False
  HasAfterTrigger	Table, vue	La table ou la vue comporte un déclencheur AFTER. 1 = True 0 = False
  HasDeleteTrigger	Table, vue	La table ou la vue comporte un déclencheur DELETE. 1 = True 0 = False
  HasInsertTrigger	Table, vue	La table ou la vue comporte un déclencheur INSERT. 1 = True 0 = False
  HasInsteadOfTrigger	Table, vue	La table ou la vue comporte un déclencheur INSTEAD OF. 1 = True 0 = False
  HasUpdateTrigger	Table, vue	La table ou la vue comporte un déclencheur UPDATE. 1 = True 0 = False
  IsAnsiNullsOn	Fonction Transact-SQL, procédure Transact-SQL, table, déclencheur Transact-SQL, vue	Spécifie que le paramètre d'option ANSI NULLS de la table a la valeur ON. Cela signifie que toutes les comparaisons avec une valeur nulle produisent la valeur UNKNOWN. Ce paramètre s'applique à l'ensemble des expressions dans la définition de la table, y compris les contraintes et les colonnes calculées, aussi longtemps que la table existe. 1 = True 0 = False
  IsCheckCnst	Tout objet étendu aux schémas	Contrainte CHECK. 1 = True 0 = False
  IsConstraint	Tout objet étendu aux schémas	Contrainte CHECK, DEFAULT ou FOREIGN KEY à une seule colonne sur une colonne ou une table. 1 = True 0 = False
  IsDefault	Tout objet étendu aux schémas	Valeur par défaut associée. 1 = True 0 = False
  IsDefaultCnst	Tout objet étendu aux schémas	Contrainte DEFAULT. 1 = True 0 = False
  IsDeterministic	Fonction, vue	Propriété de déterminisme de la fonction ou de la vue. 1 = Déterministe 0 = Non déterministe
  IsEncrypted	Fonction Transact-SQL, procédure Transact-SQL, table, déclencheur Transact-SQL, vue	Indique que le texte d'origine provenant de l'instruction du module a été converti dans un format d'obfuscation. La sortie générée par l'obfuscation n'est pas visible directement dans les affichages catalogue de SQL Server 2005. Les utilisateurs n'ayant pas accès aux tables système ou aux fichiers de base de données ne peuvent pas récupérer le texte d'obfuscation. Le texte est cependant à la disposition des utilisateurs qui peuvent accéder aux tables système via le port DAC ou accéder directement aux fichiers de bases de données. Les utilisateurs qui peuvent associer un débogueur au processus serveur peuvent également récupérer la procédure d'origine de la mémoire au moment de l'exécution. 1 = Chiffré 0 = Non chiffré Type de données de base : int
  IsExecuted	Tout objet étendu aux schémas	Objet pouvant être exécuté (vue, procédure, fonction ou déclencheur). 1 = True 0 = False
  IsExtendedProc	Tout objet étendu aux schémas	Procédure étendue. 1 = True 0 = False
  IsForeignKey	Tout objet étendu aux schémas	Contrainte FOREIGN KEY. 1 = True 0 = False
  IsIndexed	Table, vue	Table ou vue comportant un index. 1 = True 0 = False
  IsIndexable	Table, vue	Table ou vue pour laquelle un index peut être créé. 1 = True 0 = False
  IsInlineFunction	Fonction	Fonction Inline. 1 = Fonction Inline 0 = Fonction non Inline
  IsMSShipped	Tout objet étendu aux schémas	Objet créé durant l'installation de SQL Server. 1 = True 0 = False
  IsPrimaryKey	Tout objet étendu aux schémas	Contrainte PRIMARY KEY. 1 = True 0 = False NULL = N'est pas une fonction, ou identificateur de l'objet non valide.
  IsProcedure	Tout objet étendu aux schémas	Procédure. 1 = True 0 = False
  IsQuotedIdentOn	Fonction Transact-SQL, procédure Transact-SQL, table, déclencheur Transact-SQL, vue, contrainte CHECK, définition DEFAULT	Spécifie que le paramètre d'identificateur entre guillemets pour l'objet est ON. Cela signifie que des guillemets doubles délimitent les identificateurs dans toutes les expressions impliquées dans la définition de l'objet. 1 = activé 0 = désactivé
  IsQueue	Tout objet étendu aux schémas	File d'attente Service Broker 1 = True 0 = False
  IsReplProc	Tout objet étendu aux schémas	Procédure de réplication. 1 = True 0 = False
  IsRule	Tout objet étendu aux schémas	Règle liée. 1 = True 0 = False
  IsScalarFunction	Fonction	Fonction scalaire. 1 = Fonction scalaire 0 = Fonction non scalaire
  IsSchemaBound	Fonction, vue	Fonction ou vue liée à un schéma, créée à l'aide de SCHEMABINDING. 1 = Fonction liée à un schéma 0 = Non liée à un schéma
  IsSystemTable	Table	Table système. 1 = True 0 = False
  IsTable	Table	Table. 1 = True 0 = False
  IsTableFunction	Fonction	Fonction table. 1 = Fonction table 0 = Fonction non-table
  IsTrigger	Tout objet étendu aux schémas	Déclencheur 1 = True 0 = False
  IsUniqueCnst	Tout objet étendu aux schémas	Contrainte UNIQUE. 1 = True 0 = False
  IsUserTable	Table	Table définie par l'utilisateur. 1 = True 0 = False
  IsView	Vue	Vue. 1 = True 0 = False
  OwnerId	Tout objet étendu aux schémas	Propriétaire de l'objet. Remarque Le propriétaire du schéma n'est pas nécessairement le propriétaire de l'objet.Par exemple, les objets enfants (ceux où parent_object_id est non NULL) retournent toujours le même ID de propriétaire que leur parent. Non NULL = ID utilisateur de base de données du propriétaire de l'objet.
  TableDeleteTrigger	Table	La table comporte un déclencheur DELETE. >1 = ID du premier déclencheur du type spécifié.
  TableDeleteTriggerCount	Table	La table comporte le nombre de déclencheurs DELETE spécifié. >0 = Nombre de déclencheurs DELETE.
  TableFullTextMergeStatus	Table	Indique s'il s'agit d'une table qui a un index de recherche en texte intégral qui est en cours de fusion. 0 = La table n'a pas d'index de recherche en texte intégral ou l'index de recherche en texte intégral n'est pas en cours de fusion. 1 = L'index de recherche en texte intégral est en cours de fusion.
  TableFullTextBackgroundUpdateIndexOn	Table	Un index de mise à jour d'arrière-plan de texte intégral est activé (suivi des modifications automatiques) pour la table. 1 = TRUE 0 = FALSE
  TableFulltextCatalogId	Table	ID du catalogue de texte intégral dans lequel résident les données d'indexation de texte intégral de la table. Différent de zéro = ID de catalogue de texte intégral associé à l'index unique qui identifie les lignes dans une table indexée en texte intégral. 0 = Table sans index de texte intégral.
  TableFulltextChangeTrackingOn	Table	Le suivi des modifications de texte intégral est activé pour la table. 1 = TRUE 0 = FALSE
  TableFulltextDocsProcessed	Table	Nombre de lignes traitées depuis le démarrage de l'indexation de texte intégral. Dans une table en cours d'indexation pour une recherche en texte intégral, toutes les colonnes d'une ligne sont considérées comme faisant partie d'un même document à indexer. 0 = Aucune analyse ou indexation de texte intégral active n'est terminée. > 0 = l'une des possibilités suivantes : Nombre de documents traités par des opérations d'insertion ou de mise à jour depuis le début d'une modification de remplissage intégral, incrémentiel ou manuel. Nombre de lignes traitées par des opérations d'insertion ou de mise à jour depuis l'activation des modifications avec le remplissage de l'index de mise à jour d'arrière-plan, depuis la modification du schéma d'index en texte intégral, depuis la reconstruction du catalogue de texte intégral, depuis que l'instance de SQL Server a redémarré, etc. NULL = Table sans index de texte intégral. Remarque Cette propriété ne contrôle pas et ne compte pas les lignes supprimées.
  TableFulltextFailCount	Table	Nombre de lignes que la recherche en texte intégral n'a pas indexées. 0 = Le remplissage est terminé. > 0 = Un des éléments suivants : Nombre de documents qui n'ont pas été indexés depuis le début d'une mise à jour du remplissage intégral, incrémentiel ou manuel. Pour le suivi des modifications avec l'index de mise à jour d'arrière-plan, nombre de lignes qui n'ont pas été indexées depuis le début du remplissage, ou depuis le redémarrage du remplissage. Cela peut être causé par une modification du schéma, une reconstruction du catalogue, un redémarrage du serveur, etc. NULL = Table sans index de texte intégral.
  TableFulltextItemCount	Table	Nombre de lignes dont l'indexation de texte intégral a réussi.
  TableFulltextKeyColumn	Table	ID de la colonne associée à l'index de colonne unique qui fait partie de la définition de l'indexation de texte intégral. 0 = Table sans index de texte intégral.
  TableFulltextPendingChanges	Table	Nombre d'entrées de suivi des modifications en attente à traiter. 0 = Le suivi des modifications n'est pas activé. NULL = Table sans index de texte intégral.
  TableFulltextPopulateStatus	Table	0 = Inactif. 1 = Remplissage complet en cours. 2 = Remplissage incrémentiel en cours. 3 = Propagation des changements suivis en cours. 4 = Création de l'index de mise à jour d'arrière-plan en cours, par exemple le suivi des modifications automatiques. 5 = Indexation de texte intégral accélérée ou suspendue.
  TableHasActiveFulltextIndex	Table	La table dispose d'un index de recherche en texte intégral actif. 1 = True 0 = False
  TableHasCheckCnst	Table	La table comporte une contrainte CHECK. 1 = True 0 = False
  TableHasClustIndex	Table	La table comporte un index cluster. 1 = True 0 = False
  TableHasDefaultCnst	Table	La table comporte une contrainte DEFAULT. 1 = True 0 = False
  TableHasDeleteTrigger	Table	La table comporte un déclencheur DELETE. 1 = True 0 = False
  TableHasForeignKey	Table	La table comporte une contrainte FOREIGN KEY. 1 = True 0 = False
  TableHasForeignRef	Table	La table est référencée par une contrainte FOREIGN KEY. 1 = True 0 = False
  TableHasIdentity	Table	La table comporte une colonne d'identité. 1 = True 0 = False
  TableHasIndex	Table	La table comporte un index de type non défini. 1 = True 0 = False
  TableHasInsertTrigger	Table	L'objet comporte un déclencheur INSERT. 1 = True 0 = False
  TableHasNonclustIndex	Table	La table comporte un index non-cluster. 1 = True 0 = False
  TableHasPrimaryKey	Table	La table comporte une clé primaire. 1 = True 0 = False
  TableHasRowGuidCol	Table	La table comporte un ROWGUIDCOL pour une colonne uniqueidentifier. 1 = True 0 = False
  TableHasTextImage	Table	La table comporte une colonne text, ntext ou image. 1 = True 0 = False
  TableHasTimestamp	Table	La table comporte une colonne timestamp. 1 = True 0 = False
  TableHasUniqueCnst	Table	La table comporte une contrainte UNIQUE. 1 = True 0 = False
  TableHasUpdateTrigger	Table	L'objet comporte un déclencheur UPDATE. 1 = True 0 = False
  TableHasVarDecimalStorageFormat	Table	La table est activée pour le format de stockage vardecimal. 1 = True 0 = False
  TableInsertTrigger	Table	La table comporte un déclencheur INSERT. >1 = ID du premier déclencheur du type spécifié.
  TableInsertTriggerCount	Table	La table comporte le nombre de déclencheurs INSERT spécifié. >0 = Nombre de déclencheurs INSERT.
  TableIsFake	Table	La table n'est pas réelle. Elle est matérialisée en interne sur demande par le moteur de base de données SQL Server. 1 = True 0 = False
  TableIsLockedOnBulkLoad	Table	La table est verrouillée à cause d'un travail bcp ou BULK INSERT. 1 = True 0 = False
  TableIsPinned	Table	La table est épinglée pour être conservée dans le cache de données. 0 = False Cette fonctionnalité n'est pas prise en charge par SQL Server 2005 et versions ultérieures
  TableTextInRowLimit	Table	Nombre d'octets maximaux autorisés pour text in row. 0 si l'option text in row n'est pas définie.
  TableUpdateTrigger	Table	La table comporte un déclencheur UPDATE. > 1 = ID du premier déclencheur du type spécifié.
  TableUpdateTriggerCount	Table	La table comporte le nombre de déclencheurs UPDATE spécifié. > 0 = Nombre de déclencheurs UPDATE.
  TableHasColumnSet	Table	La table comporte un jeu de colonnes. 0 = False 1 = True Pour plus d'informations, consultez Utiliser des jeux de colonnes.

Types de retour

int

Exceptions

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

Un utilisateur peut voir uniquement les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d'une autorisation. Cela signifie que les fonctions intégrées générant des métadonnées, telles que OBJECTPROPERTY, 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.

Notes

Le Moteur de base de données considère que object_id se situe dans le contexte de la base de données active. Une requête référençant un object_id dans une autre base de données renverra NULL ou des résultats incorrects. Par exemple, dans la requête qui suit, le contexte de base de données actuel est la base de données master. Le moteur de base de données tentera de retourner la valeur de la propriété de l'object_id spécifié dans cette base de données et non dans la base de données spécifiée dans la requête. La requête renvoie des résultats incorrects car la vue vEmployee n'est pas dans la base de données master.

USE master;
GO
SELECT OBJECTPROPERTY(OBJECT_ID(N'AdventureWorks2012.HumanResources.vEmployee'), 'IsView');
GO

OBJECTPROPERTY(view_id, 'IsIndexable') peut utiliser un volume important de ressources système, car l'évaluation de la propriété IsIndexable nécessite l'analyse de la définition de la vue, sa normalisation et son optimisation partielle. Bien que la propriété IsIndexable identifie les tables ou les vues qui peuvent être indexées, la création réelle de l'index peut malgré tout échouer si certaines conditions de clé d'index ne sont pas remplies. Pour plus d'informations, consultez CREATE INDEX (Transact-SQL).

OBJECTPROPERTY(table_id, 'TableHasActiveFulltextIndex') retourne la valeur 1 (True) lorsqu'au moins une colonne d'une table est ajoutée pour l'indexation. L'indexation de texte intégral est activée au niveau du remplissage dès l'ajout de la première colonne à indexer.

Lors de la création d'une table, l'option QUOTED IDENTIFIER est toujours stockée avec la valeur ON dans les métadonnées de la table, même si elle a la valeur OFF au moment de sa création. Par conséquent, OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') retourne toujours la valeur 1 (True).

Exemples

A.Vérification qu'un objet est une table

L'exemple suivant teste si UnitMeasure est une table dans la base de données AdventureWorks2012 .

USE AdventureWorks2012;
GO
IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 1
   PRINT 'UnitMeasure is a table.'
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 0
   PRINT 'UnitMeasure is not a table.'
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') IS NULL
   PRINT 'ERROR: UnitMeasure is not a valid object.';
GO

B.Vérification du déterminisme d'une fonction définie par l'utilisateur à valeur scalaire

L'exemple suivant teste si la fonction ufnGetProductDealerPrice (à valeur scalaire et définie par l'utilisateur), qui renvoie une valeur money, est déterministe.

USE AdventureWorks2012;
GO
SELECT OBJECTPROPERTY(OBJECT_ID('dbo.ufnGetProductDealerPrice'), 'IsDeterministic');
GO

Le jeu de résultats révèle que ufnGetProductDealerPrice n'est pas une fonction déterministe.

-----

0

C.Recherche des objets appartenant à un schéma spécifique

L'exemple suivant utilise la propriété SchemaId pour retourner tous les objets qui appartiennent au schéma Production.

USE AdventureWorks2012;
GO
SELECT name, object_id, type_desc
FROM sys.objects 
WHERE OBJECTPROPERTY(object_id, N'SchemaId') = SCHEMA_ID(N'Production')
ORDER BY type_desc, name;
GO

Voir aussi

Référence

COLUMNPROPERTY (Transact-SQL)

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

OBJECTPROPERTYEX (Transact-SQL)

ALTER AUTHORIZATION (Transact-SQL)

TYPEPROPERTY (Transact-SQL)

sys.objects (Transact-SQL)