sys.dm_fts_index_keywords_by_property (Transact-SQL)

S’applique à :SQL Server

Retourne tout le contenu en rapport avec les propriétés dans l'index de recherche en texte intégral d'une table donnée. Cela inclut toutes les données qui appartiennent à une propriété inscrite par la liste de propriétés de recherche associée à cet index de recherche en texte intégral.

sys.dm_fts_index_keywords_by_property est une fonction de gestion dynamique qui vous permet de voir quelles propriétés inscrites ont été émises par IFilters au moment de l’index, ainsi que le contenu exact de chaque propriété dans chaque document indexé.

Pour consulter tout le contenu au niveau du document (notamment le contenu en rapport avec les propriétés)

• sys.dm_fts_index_keywords_by_document (Transact-SQL)

Pour afficher des informations sur l'index de recherche en texte intégral de niveau supérieur

• sys.dm_fts_index_keywords (Transact-SQL)

Syntaxe

  
sys.dm_fts_index_keywords_by_property  
(   
    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_by_property 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

Notes

Cette vue de gestion dynamique peut répondre aux questions telles que celles-ci :

• Quel contenu est stocké sur une propriété donnée pour un DocID donné ?

• Quels sont les éléments communs d'une propriété donnée parmi les documents indexés ?

• Quels documents contiennent réellement une propriété donnée ? C'est utile si l'interrogation sur une propriété de recherche donnée ne retourne pas le document que vous vous attendiez à trouver.

Lorsque la colonne clé de texte intégral est un type de données Integer, comme cela est recommandé, document_id est directement mappé à la valeur de la clé de texte intégral dans la table de base.

En revanche, lorsque la colonne clé de texte intégral fait appel à un type de données non entier, document_id ne représente pas la clé de texte intégral dans la table de base. Dans ce cas, pour identifier la ligne de la table de base retournée par dm_fts_index_keywords_by_property, vous devez joindre cette vue aux résultats retournés par sp_fulltext_keymappings. Avant de pouvoir les joindre, vous devez stocker la sortie de la procédure stockée dans une table temp. Vous pouvez ensuite joindre la colonne document_id de dm_fts_index_keywords_by_property à la colonne DocId retournée par cette procédure stockée. Notez qu’une colonne timestamp ne peut pas recevoir de valeurs au moment de l’insertion, car elles sont générées automatiquement par SQL Server. Par conséquent, la colonne timestamp doit être convertie en colonnes varbinary(8). L'exemple suivant affiche ces étapes. Dans cet exemple, table_id correspond à l’ID de votre table, database_name correspond au nom de votre base de données et table_name est le nom de votre table.

USE database_name;  
GO  
CREATE TABLE #MyTempTable   
   (  
      docid INT PRIMARY KEY ,  
      [key] INT NOT NULL  
   );  
DECLARE @db_id int = db_id(N'database_name');  
DECLARE @table_id int = OBJECT_ID(N'table_name');  
INSERT INTO #MyTempTable EXEC sp_fulltext_keymappings @table_id;  
SELECT * FROM sys.dm_fts_index_keywords_by_property   
   ( @db_id, @table_id ) kbd  
   INNER JOIN #MyTempTable tt ON tt.[docid]=kbd.document_id;  
GO  
  

Autorisations

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

Exemples

L'exemple suivant retourne des mots clés de la propriété Author dans l'index de recherche en texte intégral de la table Production.Document de l'exemple de base de données AdventureWorks. L’exemple utilise l’alias KWBPOP pour la table retournée par sys.dm_fts_index_keywords_by_property. L’exemple utilise des jointures internes pour combiner des colonnes de sys.registered_search_properties et de sys.fulltext_indexes.

-- Once the full-text index is configured to support property searching  
-- on the Author property, return any keywords indexed for this property.  
USE AdventureWorks2022;  
GO   
SELECT KWBPOP.* FROM   
   sys.dm_fts_index_keywords_by_property( DB_ID(),   
   object_id('Production.Document') ) AS KWBPOP  
   INNER JOIN  
      sys.registered_search_properties AS RSP ON(   
         (KWBPOP.property_id = RSP.property_id)   
         AND (RSP.property_name = 'Author') )  
   INNER JOIN  
      sys.fulltext_indexes AS FTI ON(   
         (FTI.[object_id] = object_id('Production.Document'))   
         AND (RSP.property_list_id = FTI.property_list_id) );  
GO  

Voir aussi

Recherche en texte intégral
Améliorer les performances des index de recherche en texte intégral
sp_fulltext_keymappings (Transact-SQL)
sys.dm_fts_index_keywords_by_document (Transact-SQL)
sys.dm_fts_index_keywords (Transact-SQL)
sys.registered_search_properties (Transact-SQL)
sys.registered_search_property_lists (Transact-SQL)
Rechercher les propriétés du document à l’aide des listes des propriétés de recherche