sys.dm_fts_parser(Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL データベース

特定の ワード ブレーカー、 類義語辞典、および ストップリスト の組み合わせをクエリ文字列入力に適用した後、最終的なトークン化の結果を返します。 トークン化の結果は、指定されたクエリ文字列のフルテキスト エンジンの出力と同じです。

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

Syntax

sys.dm_fts_parser (
    'query_string'
    , lcid
    , stoplist_id
    , accent_sensitivity
)

引数

query_string

解析するクエリ。 query_stringは、CONTAINS 構文サポートを文字列チェーンにすることができます。 たとえば、変化形、類義語辞典、および論理演算子を含めることができます。

lcid

query_stringの解析に使用するワード ブレーカーのロケール識別子 (LCID)。

stoplist_id

ストップリストの ID (存在する場合) は、 lcid で識別されるワード ブレーカーによって使用されます。 stoplist_id知力です。「NULL」と指定すると、ストップリストは使われません。 0を指定する場合は、システム STOPLIST が使われます。

ストップリスト ID は、データベース内で一意です。 特定のテーブルのフルテキスト インデックスのストップリスト ID を取得するには、 sys.fulltext_indexes カタログ ビューを使用します。

accent_sensitivity

フルテキスト検索で分音文字を区別するかしないかを制御するブール値です。 accent_sensitivity は ビットで、次のいずれかの値があります。

返されるテーブル

¹0xFF ファイルやデータセットの終わりを示す特殊文字を表します。

注釈

sys.dm_fts_parserでは、CONTAINS、FREETEXT、CONTAINSTABLEFREETEXTTABLE などの関数など、フルテキスト述語の構文と機能がサポート。

特殊文字の解析に Unicode を使用する

クエリ串を解析する際、 sys.dm_fts_parser 接続しているデータベースの照合を使います。ただし、クエリ文字列をUnicodeで指定しない限り。 したがって、ü や ç などの特殊文字を含む Unicode 以外の文字列の場合、データベースの照合順序によっては、出力が予期しない可能性があります。 クエリ文字列をデータベースの整合とは独立して処理するには、文字列の前に N、すなわち N'<query_string>' を付けます。

詳細については、 C を参照してください。特殊文字を含む文字列の出力を表示します この記事の後半で説明します。

sys.dm_fts_parserを使用するタイミング

sys.dm_fts_parser は、デバッグの目的で強力である可能性があります。 主な使用シナリオには、次のようなものがあります。

• 特定のワード ブレーカーが特定の入力をどのように処理するかを理解するには

  クエリから予期しない結果が返されると、ワード ブレーカーがデータを解析して中断する方法が原因である可能性があります。 sys.dm_fts_parserを使用すると、ワード ブレーカーがフルテキスト インデックスに渡される結果を検出できます。 さらに、フルテキスト インデックスで検索されないストップワードの用語を確認できます。 ある言語のストップワードであるかどうかは、関数で宣言されるストップ stoplist_id リストに含まれているかどうかによって決まります。

  アクセントの秘密度フラグを使用すると、ワード ブレーカーが入力を解析する方法を確認できます。アクセントの秘密度情報を念頭に置きます。

• 特定の入力でステマーがどのように機能するかを理解するには

  ワードブレーカーとステマーがクエリ語とその語幹形式をどのように解析するかは、以下の FORMSOF 節を含むCONTAINSまたはCONTAINSTABLEクエリを指定することでわかります。

  FORMSOF ( INFLECTIONAL, <query_term> )
  

  この結果から、フルテキスト インデックスに渡されている用語がわかります。

• 類義語辞典が入力の全部または一部を拡張または置換する方法を理解するには

  次を指定することもできます。

  FORMSOF ( THESAURUS, <query_term> )
  

  このクエリの結果は、ワード ブレーカーと類義語辞典がクエリ用語に対してどのように対話するかを示しています。 類義語辞典から拡張または置換を確認し、フルテキスト インデックスに対して実際に発行されているクエリを特定することができます。

  ユーザーが発行した場合:

  FORMSOF ( FREETEXT, <query_term> )
  

  変曲および類義語辞典の機能は自動的に行われます。

上記の使用シナリオに加えて、 sys.dm_fts_parser はフルテキスト クエリに関する他の多くの問題を理解し、トラブルシューティングするのに大きく役立ちます。

Permissions

CREATE FULLTEXT CATALOG許可と指定されたストップリストへのアクセス権が必要です。

Examples

A. キーワードまたは語句の特定のワード ブレーカーの出力を表示する

次の例では、LCID が 1033 で、次のクエリ文字列にストップリストがない英語のワード ブレーカーを使用して出力を返します。

The Microsoft business analysis

アクセントの区別は無効になっています。

SELECT *
FROM sys.dm_fts_parser(' "The Microsoft business analysis" ', 1033, 0, 0);

B. ストップリスト フィルター処理のコンテキストで特定のワード ブレーカーの出力を表示する

次の例では、次のクエリ文字列で、LCID が 1033 の英語ワード ブレーカーと、ID が 77 の英語ストップリストの使用からの出力を返します。

"The Microsoft business analysis" OR "MS revenue"

アクセントの区別は無効になっています。

SELECT *
FROM sys.dm_fts_parser(' "The Microsoft business analysis"  OR " MS revenue" ', 1033, 77, 0);

C. 特殊文字を含む文字列の出力を表示する

次の例では、Unicode を使用して次のフランス語の文字列を解析します。

français

この例では、フランス語の LCID として 1036 と、ユーザー定義のストップリストの ID として 5 を指定します。 アクセントの秘密度が有効になっています。

SELECT *
FROM sys.dm_fts_parser(N'français', 1036, 5, 1);

関連するコンテンツ

• 全文および意味的検索の動的管理ビューと機能
• フルテキスト検索
• Securables
• ワード ブレーカーとステミング機能の構成と管理
• フルテキスト検索に使用する類義語辞典ファイルの構成と管理
• フルテキスト検索に使用するストップワードとストップリストの構成と管理
• フルテキスト検索でのクエリ