sys.dm_fts_index_keywords_by_document (Transact-SQL)
傳回與指定資料表相關聯之全文檢索索引之文件層級內容的相關資訊。
sys.dm_fts_index_keywords_by_document 是動態管理函數。
若要檢視較高層級的全文檢索索引資訊
若要檢視與文件屬性相關之屬性層級內容的相關資訊
語法
sys.dm_fts_index_keywords_by_document
(
DB_ID('database_name'), OBJECT_ID('table_name')
)
引數
db_id('database_name')
DB_ID() 函數的呼叫。 這個函數會接受資料庫名稱並傳回資料庫識別碼，然後 sys.dm_fts_index_keywords_by_document 就會使用此識別碼來尋找指定的資料庫。 如果省略了 database_name，則會傳回目前資料庫識別碼。object_id('table_name')
OBJECT_ID() 函數的呼叫。 此函數會接受資料表名稱並傳回資料表的資料表識別碼 (包含所要檢查的全文檢索索引)。
傳回的資料表
資料行 |
資料類型 |
說明 |
|---|---|---|
keyword |
nvarchar(4000) |
儲存在全文檢索索引內部之關鍵字的十六進位表示法。
|
display_term |
nvarchar(4000) |
關鍵字的可讀取格式。 這個格式衍生自儲存在全文檢索索引中的內部格式。
|
column_id |
int |
從中針對目前關鍵字進行全文檢索索引之資料行的識別碼。 |
document_id |
int |
從中針對目前詞彙進行全文檢索索引之文件或資料列的識別碼。 這個識別碼會對應至該文件或資料列的全文檢索索引鍵值。 |
occurrence_count |
int |
目前關鍵字在 document_id 所指出之文件或資料列中出現的次數。 當指定 'search_property_name' 時，occurrence_count 只會顯示目前關鍵字出現在文件或資料列內指定之搜尋屬性中的次數。 |
備註
sys.dm_fts_index_keywords_by_document 所傳回的資訊可用於了解下列項目 (以及其他項目)：
全文檢索索引包含之關鍵字的總數。
關鍵字是否屬於給定文件或資料列的一部分。
關鍵字出現在整個全文檢索索引中的次數，亦即：
(SUM(occurrence_count) WHERE keyword=keyword_value )
關鍵字出現在給定文件或資料列中的次數。
給定文件或資料列所包含的關鍵字數目。
而且，您也可以使用 sys.dm_fts_index_keywords_by_document 所提供的資訊來擷取屬於給定文件或資料列的所有關鍵字。
當全文檢索索引鍵資料行為整數資料類型時，建議您將 document_id 直接對應到基底資料表內的全文檢索索引鍵值。
相反地，當全文檢索索引鍵資料行使用非整數資料類型時，document_id 就不表示基底資料表內的全文檢索索引鍵。 在此情況下，若要識別基底資料表內 dm_fts_index_keywords_by_document 所傳回的資料列，您需要將這個檢視表聯結到 sp_fulltext_keymappings 所傳回的結果。 在您可以聯結之前，必須先將預存程序的輸出儲存到暫存資料表。 接著，您可以連結 dm_fts_index_keywords_by_document 的 document_id 資料行與這個預存程序傳回的 DocId 資料行。 請注意，timestamp 資料行無法在插入時接收值，因為它們是由 SQL Server 自動產生。 因此，timestamp 資料行必須轉換成 varbinary(8) 資料行。 下列範例會示範這些步驟。 在此範例中，table_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_document
( @db_id, @table_id ) kbd
INNER JOIN #MyTempTable tt ON tt.[docid]=kbd.document_id;
GO
權限
需要全文檢索索引和 CREATE FULLTEXT CATALOG 權限所涵蓋之資料行的 SELECT 權限。
範例
A.顯示位於文件層級的全文檢索索引內容
下列範例會在 AdventureWorks 範例資料庫的 HumanResources.JobCandidate 資料表中顯示位於文件層級之全文檢索索引的內容。
[!附註]
您可以建立這個索引，建立方式是執行針對＜CREATE FULLTEXT INDEX (Transact-SQL)＞中的 HumanResources.JobCandidate 資料表所提供的範例。
SELECT * FROM sys.dm_fts_index_keywords_by_document(db_id('AdventureWorks'),
object_id('HumanResources.JobCandidate'));
GO
請參閱
參考
全文檢索搜尋與語意搜尋動態管理檢視和函數 (Transact-SQL)
sys.dm_fts_index_keywords (Transact-SQL)
sys.dm_fts_index_keywords_by_property (Transact-SQL)
sp_fulltext_keymappings (Transact-SQL)