sys.dm_fts_index_keywords_by_property (Transact-SQL)

项目
03/25/2014

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

sys.dm_fts_index_keywords_by_property 是一个动态管理函数，通过它可以查看 IFilters 在索引时发出了哪些已注册属性，以及每个属性在每个索引文档中的确切内容。

查看所有文档级内容（包括属性相关的内容）

sys.dm_fts_index_keywords_by_document (Transact-SQL)

查看高级全文索引信息

sys.dm_fts_index_keywords (Transact-SQL)

备注

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

适用范围：SQL Server（SQL Server 2008 到当前版本）。

语法

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 使用此 ID 来查找指定的数据库。如果省略 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 列联接在一起。请注意，timestamp 列无法在插入时检索值，因为它们是由 SQL Server 自动生成的。因此，必须将 timestamp 列转换为 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 权限。

示例

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