sys.dm_fts_index_keywords (Transact-SQL)

S’applique à :SQL Server

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.

Notes

Pour afficher les informations d’index de texte intégral de niveau inférieur, 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 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 contenant l'index de recherche en texte intégral à examiner.

Table retournée

Nom de la colonne Type de données Description
keyword nvarchar(4000) La représentation hexadécimale du mot clé stockée à l’intérieur de l’index de texte intégral.

Remarque : OxFF représente le caractère spécial qui indique la fin d’un fichier ou d’un jeu de données.
display_term nvarchar(4000) Format explicite du mot clé. Ce format est dérivé du format hexadécimal.

Remarque : La valeur display_term pour 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 connaître les éléments suivants, entre autres :

  • 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 par rapport au total document_count, 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.

Notes

Les document_count retournées par sys.dm_fts_index_keywords peuvent être moins précises pour un document spécifique que le nombre retourné par sys.dm_fts_index_keywords_by_document ou une requête CONTAINS . Cette imprécision éventuelle est estimée inférieure à 1 %. Cette inexactitude peut se produire parce qu’une document_id peut être comptée deux fois lorsqu’elle continue sur plusieurs lignes dans le fragment d’index, ou lorsqu’elle apparaît plusieurs fois dans la même ligne. Pour obtenir un nombre plus précis pour un document spécifique, utilisez sys.dm_fts_index_keywords_by_document ou une requête CONTAINS .

Autorisations

Nécessite l'appartenance au rôle serveur fixe sysadmin .

Exemples

R. 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.

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

Voir aussi

Fonctions et vues de gestion dynamique liées à la recherche en texte intégral et à la recherche sémantique (Transact-SQL)
Recherche en texte intégral
sys.dm_fts_index_keywords_by_document (Transact-SQL)