sys.dm_fts_index_keywords (Transact-SQL)

Retourne des informations sur le contenu d'un index de recherche en texte intégral pour la table spécifiée.

sys.dm_fts_index_keywords est une fonction de gestion dynamique.

[!REMARQUE]

Pour afficher des informations d'index de recherche en texte intégral de niveaux inférieurs, utilisez la fonction de gestion dynamique sys.dm_fts_index_keywords_by_document au niveau du document.

Syntaxe

sys.dm_fts_index_keywords( DB_ID('database_name'), OBJECT_ID('table_name') )

Arguments

  • db_id('database_name')
    Appel à la fonction DB_ID(). Cette fonction accepte un nom de base de données et retourne l'ID de la base de données, que sys.dm_fts_index_keywords utilise pour rechercher la base de données spécifiée. Si database_name est omis, la fonction retourne l'ID de la base de données active.

  • object_id('table_name')
    Appel à la fonction OBJECT_ID(). Cette fonction accepte un nom de table et retourne l'ID de la table qui contient l'index de recherche en texte intégral à examiner.

Table retournée

Nom de la colonne

Type de données

Description

keyword

nvarchar(8000)

Représentation hexadécimale du mot clé stocké dans l'index de recherche en texte intégral.

RemarqueRemarque
OxFF représente le caractère spécial qui indique la fin d'un fichier ou d'un dataset.

display_term

nvarchar(8000)

Format explicite du mot clé. Ce format est dérivé du format hexadécimal.

RemarqueRemarque
La valeur display_term de OxFF est « END OF FILE ».

column_id

int

ID de la colonne à partir de laquelle le mot clé actuel a été indexé en texte intégral.

document_count

int

Nombre de documents ou de lignes contenant le terme actuel.

Notes

Les informations retournées par sys.dm_fts_index_keywords sont utiles pour déterminer, entre autres choses, les éléments ci-dessous.

  • Si un mot clé fait partie de l'index de recherche en texte intégral.

  • Le nombre de documents ou de lignes qui contiennent un mot clé donné.

  • Le mot clé le plus courant dans l'index de recherche en texte intégral :

    • document_count de chaque keyword_value comparé au document_count total, le nombre de documents de 0xFF.

    • En règle générale, les mots clés courants peuvent être déclarés en tant que mots vides.

Autorisations

Requiert les autorisations CREATE FULLTEXT CATALOG et SELECT sur les colonnes couvertes par l'index de recherche en texte intégral.

Exemples

A. Affichage du contenu de l'index de recherche en texte intégral au niveau supérieur

L'exemple suivant affiche des informations sur le contenu du niveau supérieur de l'index de recherche en texte intégral de la table HumanResources.JobCandidate de l'exemple de base de données AdventureWorks.

SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks'), object_id('HumanResources.JobCandidate'))
GO