sys.dm_fts_index_keywords (Transact-SQL)

適用対象: SQL サーバー

指定されたテーブルのフルテキスト インデックスのコンテンツに関する情報を返します。

sys.dm_fts_index_keywords は動的管理機能です。

Note

下位レベルのフルテキスト インデックス情報を表示するには、ドキュメント レベルで sys.dm_fts_index_keywords_by_document 動的管理機能を使用します。

構文

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

引数

db_id('database_name')
DB_ID()関数の呼び出し。 この関数はデータベース名を受け取り、指定したデータベースを検索するために使用 sys.dm_fts_index_keywords データベース ID を返します。 場合 database_name は省略すると、現在のデータベース ID が返されます。

object_id('table_name')
OBJECT_ID()関数の呼び出し。 この関数はテーブル名を受け取り、検査するフルテキスト インデックスを含むテーブルのテーブル ID を返します。

返されるテーブル

列名	データ型	説明
keyword	nvarchar (4000)	フルテキスト インデックス内に格納されているキーワードの 16 進数表現。 注: OxFF は、ファイルまたはデータセットの末尾を示す特殊文字を表します。
display_term	nvarchar (4000)	人間が判読できるキーワードの形式。 この形式は、16 進形式から派生します。 注: OxFF の display_term 値は "END OF FILE" です。
column_id	int	現在のキーワードのインデックスが作成された列の ID。
document_count	int	現在の用語を含むドキュメントまたは行の数。

解説

sys.dm_fts_index_keywordsによって返される情報は、次のような情報を見つけるのに役立ちます。

• キーワードがフルテキスト インデックスの一部であるかどうかを示します。

• 特定のキーワードを含むドキュメントまたは行の数。

• フルテキスト インデックスの最も一般的なキーワード:

  • 各keyword_valueのdocument_count、合計document_countと比較して、0xFFのドキュメント数。

  • 通常、ストップワードとして宣言するには、一般的なキーワードが適している可能性があります。

Note

sys.dm_fts_index_keywordsによって返されるdocument_countは、sys.dm_fts_index_keywords_by_documentまたは CONTAINS クエリによって返される数よりも、特定のドキュメントの精度が低い場合があります。 この潜在的な不正確さは、1% 未満であると推定されます。 この誤りは、インデックス フラグメント内の複数の行間で継続する場合、または同じ行に複数回出現する場合に、 document_id が 2 回カウントされる可能性があるために発生する可能性があります。 特定のドキュメントのより正確な数を取得するには、 sys.dm_fts_index_keywords_by_document または CONTAINS クエリを使用します。

アクセス許可

sysadmin 固定サーバー ロールのメンバーシップが必要です。

例

A. 高レベルのフルテキスト インデックス コンテンツの表示

次の使用例は、 HumanResources.JobCandidate テーブルのフルテキスト インデックスの高レベルコンテンツに関する情報を表示します。

SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2022'), object_id('HumanResources.JobCandidate'))  
GO  

参照

フルテキスト検索とセマンティック検索の動的管理ビューと関数 (Transact-SQL)
フルテキスト検索
sys.dm_fts_index_keywords_by_document (Transact-SQL)