フルテキストインデックスのキーワードごとのドキュメントの一覧を出力する：SQL Server動的管理ビューレファレンス（96）

「Microsoft SQL Server」が稼働するデータベースシステムを運用する管理者に向け、「動的管理ビュー」の活用を軸にしたトラブル対策のためのノウハウを紹介していきます。今回は、フルテキストインデックスのキーワードごとのドキュメントの一覧を出力する方法について解説します。

[伊東敏章，＠IT]

SQL Server動的管理ビュー一覧

　本連載では、「Microsoft SQL Server（以下、SQL Server）」で使用可能な動的管理ビューについて、動作概要や出力内容などを紹介していきます。今回は動的管理ビュー「sys.dm_fts_index_keywords_by_document」における、フルテキストインデックスのキーワードごとのドキュメントの一覧を出力する方法について解説します。対応バージョンは、SQL Server（サポートされている全てのバージョン）です。

概要

　SQL Serverではフルテキスト検索の機能を使用して、英語や日本語など、特定の言語の規則に基づいた言語検索を実行できます。フルテキスト関数を使用して大量のテキストデータを対象として検索する場合、全文検索をするLIKE句と比較して高速に実行できます。フルテキスト検索では、フォーマットされたバイナリデータ（Microsoft Wordドキュメントなど）を対象とすることもできます。

　フルテキスト検索を使用するには、SQL Serverインスタンスに「検索のためのフルテキスト抽出とセマンティック抽出」機能を追加する必要があります。また、データベースにフルテキストカタログを作成し、対象のテーブルに対してフルテキストインデックスを作成する必要があります。

　「sys.dm_fts_index_keywords_by_document」動的管理関数を使用することで、フルテキストインデックスに含まれるキーワードごとに、そのキーワードを含むドキュメントの一覧を出力できます。

• sys.dm_fts_index_keywords_by_document（Transact-SQL）

構文と引数

構文　sys.dm_fts_index_keywords_by_document(database_id, object_id)

列名	データ型	説明
database_id	int	対象のデータベースID DB_ID関数を使用することで、データベース名からデータベースIDを取得できる
object_id	int	対象のテーブルのオブジェクトID OBJECT_ID関数を使用することで、テーブル名からオブジェクトIDを取得できる

出力内容

列名	データ型	説明
keyword	nvarchar（4000）	キーワードの16進数表現 ※0xFFは、ファイルまたはデータセットの末尾を示す
display_term	nvarchar（4000）	キーワードの人間が判読できる形式 ※※「END OF FILE」は、ファイルまたはデータセットの末尾を示す
column_id	int	このキーワードが作成された列のID
document_id	int	このキーワードを含んでいるドキュメントまたは行のID。ドキュメントまたは行のフルテキストキー値に対応する
occurrence_count	int	このキーワードを含んでいたドキュメントまたは行での、このキーワードの出現回数

動作例