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 contenant l'index de recherche en texte intégral à examiner.

Table Returned

Nom de la colonne

Type de données

Description

keyword

nvarchar(4000)

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(4000)

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.

[!REMARQUE]

Le document_count retourné par sys.dm_fts_index_keywords peut être moins précis pour un document spécifique que le nombre retourné par sys.dm_fts_index_keywords_by_document ou par une requête CONTAINS. Cette imprécision éventuelle est estimée inférieure à 1 %. Elle peut se produire lorsqu'un document_id a été compté deux fois s'il tient sur plusieurs lignes dans le fragment d'index ou s'il apparaît plusieurs fois sur 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

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

Voir aussi

Référence

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

sys.dm_fts_index_keywords_by_document (Transact-SQL)

Concepts

Recherche en texte intégral (SQL Server)