Partager via

  • Article

FULLTEXTCATALOGPROPERTY (Transact-SQL)

Renvoie des informations concernant les propriétés de catalogue de texte intégral.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')

Arguments

[!REMARQUE]

Les propriétés suivantes seront supprimées dans une version ultérieure de SQL Server : LogSize et PopulateStatus. Évitez par conséquent d'utiliser ces propriétés dans un nouveau travail de développement et prévoyez la modification des applications qui les utilisent actuellement.

  • 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 renvoyés

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 AdventureWorks;
GO
SELECT fulltextcatalogproperty('Cat_Desc', 'ItemCount');
GO