sys.dm_fts_index_keywords_by_property (Transact-SQL)

适用于SQL Server

在给定表的全文索引中返回与属性相关的所有内容。 其中包括属于与全文索引关联的搜索属性列表注册的任何属性的所有数据。

sys.dm_fts_index_keywords_by_property是一种动态管理功能,可用于查看 IFilters 在索引时发出的已注册属性,以及每个索引文档中每个属性的确切内容。

查看所有文档级内容(包括与属性相关的内容)

查看更高级别的全文索引信息

注意

有关搜索属性列表的信息,请参阅 搜索属性列表的搜索文档属性。

语法

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

参数

db_id('database_name')
对 DB_ID() 函数的调用。 此函数接受数据库名称并返回数据库 ID,sys.dm_fts_index_keywords_by_property用于查找指定的数据库。 如果省略 database_name,则返回当前数据库 ID

object_id('table_name')
对 OBJECT_ID() 函数的调用。 此函数接受表名,并返回包含要检查的全文索引的表的表 ID。

返回的表

数据类型 描述
keyword nvarchar(4000) 存储在全文索引中的关键字的十六进制表示形式。

注意:OxFF 表示指示文件或数据集末尾的特殊字符。
display_term nvarchar(4000) 关键字的可读格式。 此格式是从全文索引中存储的内部格式派生的。

注意:OxFF 表示指示文件或数据集末尾的特殊字符。
column_id int 从中对当前关键字进行全文索引的列的 ID。
document_id int 从中对当前字词进行全文索引的文档或行的 ID。 此 ID 对应于该文档或行的全文键值。
property_id int 在OBJECT_ID('table_name') 参数中指定的表的全文索引内搜索属性的内部属性 ID。

在将给定属性添加到搜索属性列表时,全文引擎会注册该属性并为其指定特定于该属性列表的内部属性 ID。 内部属性 ID 是一个整数,对给定的搜索属性列表唯一。 如果为多个搜索属性列表注册给定属性,则可能会为每个搜索属性列表指定不同的内部属性 ID。

注意:内部属性 ID 不同于将属性添加到搜索属性列表时指定的属性整数标识符。 有关详细信息,请参阅 使用搜索属性列表搜索文档属性

若要查看property_id与属性名称之间的关联,
sys.registered_search_properties (Transact-SQL)

注解

此动态管理视图可以回答诸如以下的各个问题:

  • 哪些内容存储在给定 DocID 的给定属性中?

  • 给定属性在索引文档中的几率有多大?

  • 哪些文档确实包含给定属性? 如果查询给定的搜索属性时未返回您要查找的文档,则此视图很有用。

如果全文键列是建议的整数数据类型,则 document_id 直接映射到基表中的全文键值。

相反,如果全文键列使用非整数数据类型,document_id 并不表示基表中的全文键。 在这种情况下,若要标识dm_fts_index_keywords_by_property返回的基表中的行,需要将此视图与sp_fulltext_keymappings返回的结果联接在一起。 在联接它们之前,您必须将存储过程的输出存储在临时表中。 然后,可以将dm_fts_index_keywords_by_property document_id列与此存储过程返回的 DocId 列联接。 请注意, 时间戳 列在插入时无法接收值,因为它们是由 SQL Server 自动生成的。 因此, 时间戳 列必须转换为 varbinary(8) 列。 下面的示例说明了这些步骤。 在此示例中,table_id是表的 ID,database_name是数据库的名称,table_name是表的名称。

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  
  

权限

要求具有全文索引涵盖的列的 SELECT 权限以及 CREATE FULLTEXT CATALOG 权限。

示例

以下示例从 Author 示例数据库的 Production.Document 表的全文索引中的 AdventureWorks 属性中返回关键字。 该示例使用sys.dm_fts_index_keywords_by_property返回的表的别名KWBPOP。 该示例使用内部联接来合并来自sys.registered_search_propertiessys.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  

另请参阅

全文搜索
改进全文索引的性能
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)
使用搜索属性列表搜索文档属性