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.
Notes
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(4000) |
Représentation hexadécimale du mot clé stocké dans l'index de recherche en texte intégral.
Remarque
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.
Remarque
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.
Notes
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 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
Requiert les autorisations CREATE FULLTEXT CATALOG et SELECT sur les colonnes couvertes par l'index de recherche en texte intégral.
Exemples
A. Afficher le 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 AdventureWorks2008R2. .
SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2008R2'), object_id('HumanResources.JobCandidate'))
GO