FULLTEXTCATALOGPROPERTY (Transact-SQL)

Syntaxe

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')

Arguments

• catalog_name
  Expression contenant le nom du catalogue de texte intégral.

• property
  Expression contenant le nom de la propriété de catalogue de texte intégral. Le tableau donne la liste des propriétés et fournit les descriptions des informations renvoyées.

  Propriété	Description
  AccentSensitivity	Respect des accents. 0 = Accents ignorés 1 = Accents respectés
  IndexSize	Taille logique du catalogue de texte intégral en mégaoctets (Mo). Pour plus d'informations, consultez la section « Remarques » plus loin dans cette rubrique.
  ItemCount	Nombre d'éléments indexés de texte intégral actuellement dans le catalogue de texte intégral.
  LogSize	Pris en charge pour compatibilité descendante uniquement. Renvoie toujours 0. Taille en octets du jeu combiné de journaux d'erreurs associés à un catalogue de texte intégral du service Microsoft Search.
  MergeStatus	Indique si une fusion principale est en cours. 0 = Aucune fusion principale en cours. 1 = Fusion principale en cours.
  PopulateCompletionAge	Différence en secondes entre la fin du remplissage du dernier index de texte intégral et le 01/01/1990 00:00:00 Propriété uniquement mise à jour pour des analyses complètes ou incrémentielles. Renvoie la valeur 0 si aucun remplissage ne s'est produit.
  PopulateStatus	0 = Inactif 1 = Remplissage complet en cours 2 = En pause 3 = Accéléré 4 = Récupération 5 = Arrêt 6 = Remplissage incrémentiel en cours 7 = Indexation en cours 8 = Disque plein Suspendu. 9 = Suivi des modifications
  UniqueKeyCount	Nombre de clés uniques dans le catalogue de texte intégral.
  ImportStatus	Indique si le catalogue de texte intégral est en cours d'importation. 0 = Indique que le catalogue de texte intégral n'est pas en cours d'importation. 1 = Indique que le catalogue de texte intégral est en cours d'importation.

Types de retour

int

Exceptions

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

Dans SQL Server 2008, 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 FULLTEXTCATALOGPROPERTY, 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

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'IndexSize') examine uniquement les fragments ayant l'état 4 ou 6 comme indiqué dans sys.fulltext_index_fragments. Ces fragments font partie de l'index logique. Par conséquent, la propriété IndexSize retourne uniquement la taille de l'index logique. Pendant une fusion d'index, toutefois, la taille d'index réelle peut être le double de sa taille logique. Pour rechercher la taille réelle consommée par un index de recherche en texte intégral pendant une fusion, utilisez la procédure stockée système sp_spaceused. Cette procédure examine tous les fragments associés à un index de recherche en texte intégral.

Il est important que les applications n'attendent pas dans une boucle courte que la propriété PopulateStatus passe à l'état inactif (indiquant de la fin d'un remplissage) car les cycles de microprocesseur sont utilisés en dehors des processus de la base de données et la recherche en texte intégral, ce qui provoque des délais d'expiration. Il est d'ailleurs généralement plus intéressant de vérifier la propriété PopulateStatus correspondante au niveau de la table ou TableFullTextPopulateStatus dans la fonction système OBJECTPROPERTYEX. Cette propriété et d'autres propriétés de texte intégral nouvelles dans OBJECTPROPERTYEX fournissent des informations plus précises sur les tables d'indexation de texte intégral. Pour plus d'informations, consultez OBJECTPROPERTYEX (Transact-SQL).

Exemple

L'exemple suivant renvoie le nombre d'éléments indexés en texte intégral dans un catalogue de texte intégral nommé Cat_Desc.

USE AdventureWorks2008R2;
GO
SELECT fulltextcatalogproperty('Cat_Desc', 'ItemCount');
GO

Voir aussi

Référence