フルテキスト検索でのクエリ

[アーティクル]
05/11/2023

適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance

述語の CONTAINS および FREETEXT と、行セット値関数の CONTAINSTABLE と FREETEXTTABLE を SELECT ステートメントと使用し、フルテキストクエリを記述します。この記事では、各述語と関数の例と、使用に最適なものを選択する方法を説明します。

単語や語句と一致させるには、CONTAINS と CONTAINSTABLE を使用します。
単語そのものではなく意味と一致させるには、FREETEXT と FREETEXTTABLE を使用します。

各述語と関数の例

次の例では、AdventureWorks サンプルデータベースを使用します。 AdventureWorks の最終リリースについては、「AdventureWorks Databases and Scripts for SQL Server 2016 CTP3」(SQL Server 2016 CTP3 の AdventureWorks データベースとスクリプト) をご覧ください。サンプルクエリを実行するには、フルテキスト検索も設定する必要があります。詳細については、「Query with Full-Text Search」 (フルテキスト検索でのクエリ) を参照してください。

例: CONTAINS

次の例では、"Mountain" という単語を含み、価格が $80.99 であるすべての製品を検索します。

USE AdventureWorks2022  
GO  
  
SELECT Name, ListPrice  
FROM Production.Product  
WHERE ListPrice = 80.99  
   AND CONTAINS(Name, 'Mountain')  
GO

例: FREETEXT

次の例では、vital safety components に関連する単語を含むドキュメントをすべて検索します。

USE AdventureWorks2022  
GO  
  
SELECT Title  
FROM Production.Document  
WHERE FREETEXT (Document, 'vital safety components')  
GO

例: CONTAINSTABLE

次の例では、Description 列の "light" または "lightweight" という語の近くに "aluminum" という語があるすべての製品の説明 ID と説明を返します。ランク 2 以上の行のみが返されます。

USE AdventureWorks2022  
GO  
  
SELECT FT_TBL.ProductDescriptionID,  
   FT_TBL.Description,   
   KEY_TBL.RANK  
FROM Production.ProductDescription AS FT_TBL INNER JOIN  
   CONTAINSTABLE (Production.ProductDescription,  
      Description,   
      '(light NEAR aluminum) OR  
      (lightweight NEAR aluminum)'  
   ) AS KEY_TBL  
   ON FT_TBL.ProductDescriptionID = KEY_TBL.[KEY]  
WHERE KEY_TBL.RANK > 2  
ORDER BY KEY_TBL.RANK DESC;  
GO

例 - FREETEXTTABLE

次の例では、FREETEXTTABLE クエリを拡張して、順位の高いものから順に行を返し、各行の順位を選択リストに追加します。類似のクエリを記述するには、ProductDescriptionID が ProductDescription テーブルの一意なキー列であることを知っている必要があります。

USE AdventureWorks2022  
GO  
  
SELECT KEY_TBL.RANK, FT_TBL.Description  
FROM Production.ProductDescription AS FT_TBL   
     INNER JOIN  
     FREETEXTTABLE(Production.ProductDescription, Description,  
                    'perfect all-around bike') AS KEY_TBL  
     ON FT_TBL.ProductDescriptionID = KEY_TBL.[KEY]  
ORDER BY KEY_TBL.RANK DESC  
GO

以下に、同じクエリを拡張して、順位が 10 以上の行だけを返す例を示します。

USE AdventureWorks2022  
GO  
  
SELECT KEY_TBL.RANK, FT_TBL.Description  
FROM Production.ProductDescription AS FT_TBL   
     INNER JOIN  
     FREETEXTTABLE(Production.ProductDescription, Description,  
                    'perfect all-around bike') AS KEY_TBL  
     ON FT_TBL.ProductDescriptionID = KEY_TBL.[KEY]  
WHERE KEY_TBL.RANK >= 10  
ORDER BY KEY_TBL.RANK DESC  
GO

単語の一致または意味の一致

CONTAINS/CONTAINSTABLE と FREETEXT/FREETEXTTABLE は、別種の照合に役立ちます。次の情報は、クエリに適した述語または関数の選択に役立ちます。

CONTAINS/CONTAINSTABLE

完全一致またはあいまい一致 (より低い精度での一致) する単語または語句を照合できます。
次の操作を行うこともできます。
- 単語が互いに特定の範囲内でどれくらい近いかを指定する。
- 一致するものを重み付きで返す。
- 論理演算子で検索条件を結合する。詳しくは、この記事の後半の「ブール演算子 AND、OR、および NOT の使用」をご覧ください。

FREETEXT/FREETEXTTABLE

指定した単語、語句、または文章 ("freetext 文字列") の正確な文字列の並びではなく、意味を照合できます。
指定した列のフルテキストインデックスに、用語または一定の形式の用語が見つかった場合は、一致すると判断されます。

述語と関数を比較する

述語 CONTAINS/FREETEXT と行セット値関数 CONTAINSTABLE/FREETEXTTABLE の構文とオプションは異なります。次の情報は、クエリに適した述語または関数の選択に役立ちます。

述語 CONTAINS と FREETEXT

使用状況。 CONTAINS と FREETEXT のフルテキスト述語は、SELECT ステートメントの WHERE 句または HAVING 句で使用します。

結果。 CONTAINS 述語と FREETEXT 述語では、特定の行がフルテキストクエリと一致するかどうかを示す TRUE または FALSE の値が返されます。一致する行は結果セットで返されます。

その他のオプション。述語は、LIKE や BETWEEN など他の Transact-SQL 述語と組み合わせて使用できます。

テーブルの単一の列、一連の列、すべての列のいずれかを検索対象として指定できます。

また、フルテキストクエリで単語区切りとステミング、類義語辞典の検索、およびノイズワードの削除を行うために使用されるリソースの言語を指定することもできます。

CONTAINS または FREETEXT 述語に 4 つの要素で構成される名前を使用して、リンクサーバー上にある対象テーブルのフルテキストインデックス列にクエリを実行できます。フルテキストクエリを受け取るようリモートサーバーを準備するには、リモートサーバー上の検索対象のテーブルおよび列にフルテキストインデックスを作成し、リモートサーバーをリンクサーバーとして追加します。

詳細情報。これらの述語の構文および引数の詳細については、「CONTAINS」と「FREETEXT」を参照してください。

行セット値関数 CONTAINSTABLE と FREETEXTTABLE

使用状況。 CONTAINSTABLE 関数と FREETEXTTABLE 関数のフルテキスト関数は、SELECT ステートメントの FROM 句で通常のテーブル名と同じように使用します。

これらのいずれかの関数を使用する場合には、検索するベーステーブルを指定する必要があります。述語と同様に、検索するテーブルの単一の列、一連の列、またはすべての列を指定できます。また、必要に応じて、指定したフルテキストクエリで使用される言語リソースの言語を指定することもできます。

通常、CONTAINSTABLE または FREETEXTTABLE の結果をベーステーブルと結合する必要があります。テーブルを結合するには、キー列の一意の名前を把握している必要があります。この列は、フルテキスト処理に対応する各テーブルに含まれ、テーブルの行を一意にするために使用されます ("一意なキー列")。キー列の詳細については、「フルテキストインデックスの作成と管理」をご覧ください。

結果。 これらの関数では、フルテキストクエリと一致する 0 行、1 行、または 2 行以上で構成されるテーブルが返されます。返されたテーブルには、ベーステーブルの行のうち、関数のフルテキスト検索条件に指定した選択基準に一致する行のみが含まれます。

このいずれかの関数を使用するクエリでは、次のように、返される各行の関連順位値 (RANK) とフルテキストキー (KEY) も返されます。

KEY 列。 KEY 列には、返された行の一意の値が格納されます。 KEY 列は、選択基準を指定する際に使用できます。
RANK 列。 RANK 列は、各行が選択条件にどの程度一致しているかを示す 順位値 を返します。行内のテキストまたはドキュメントの順位値が高いほど、指定したフルテキストクエリとその行との関連性が高いことを示します。複数の行に同じ順位が付けられる可能性があります。 top_n_by_rank パラメーター (省略可能) を指定して、返される一致の数を制限することもできます。詳細については、「 RANK を使用して検索結果を制限する方法」を参照してください。

詳細情報。これらの関数の構文および引数の詳細については、「CONTAINSTABLE」と「FREETEXTTABLE」を参照してください。

特定の種類の検索

特定の語または句 (単純語句) の検索

CONTAINS、CONTAINSTABLE、 FREETEXT、または FREETEXTTABLE を使用すると、テーブルで特定の語または句を検索できます。たとえば、AdventureWorks2022 データベースの ProductReview テーブルで、製品に関する記述から "learning curve" という句が含まれるすべてのコメントを検索するには、次のように CONTAINS 述語を使用します。

USE AdventureWorks2022  
GO  
  
SELECT Comments  
FROM Production.ProductReview  
WHERE CONTAINS(Comments, '"learning curve"')  
GO

検索条件 (この場合は "learning curve") には、1 つ以上の語で構成される複雑な条件を指定できます。

単純語句検索に関する詳細情報

フルテキスト検索において、語 (または トークン) とは、指定された言語の規則に従って適切なワードブレーカーによって境界が識別された文字列です。有効な句は、複数の語から構成されます。句読点を含む場合も含まない場合もあります。

たとえば、"croissant" は語、"café au lait" は句です。このような語や句は単純語句と呼ばれています。

CONTAINS および CONTAINSTABLE は、句に完全一致するものを検索します。 FREETEXT および FREETEXTTABLE は、句を個々の語に分解します。

プレフィックス付きの語 (プレフィックス語句) の検索

CONTAINS または CONTAINSTABLE を使用すると、指定したプレフィックスを持つ語または句を検索することができます。指定したプレフィックスで始まるテキストが含まれる列のすべてのエントリが返されます。たとえば、 topというプレフィックス ( top``ple、 top``ping、 topなど) が含まれるすべての行を検索する場合、クエリは次の例のようになります。

USE AdventureWorks2022  
GO  
  
SELECT Description, ProductDescriptionID  
FROM Production.ProductDescription  
WHERE CONTAINS (Description, '"top*"' )  
GO

アスタリスク (*) より前のテキストに一致するすべてのテキストが返されます。 CONTAINS (DESCRIPTION, 'top*')のように、テキストとアスタリスクを二重引用符で囲まなかった場合、フルテキスト検索ではアスタリスクはワイルドカードとして認識されません。

プレフィックス語句が句の場合、句を構成する各トークンは、それぞれ独立したプレフィックス語句と見なされます。それらのプレフィックス語句で始まる語を持つすべての行が返されます。たとえば、"light bread*" というプレフィックス語句を使用すると、"light breaded"、"lightly breaded"、または "light bread" というテキストを含む行が検索されますが、"lightly toasted bread" は対象から除外されます。

プレフィックス検索に関する詳細情報

プレフィックス語句とは、派生語または変化形を生成するために語の前に付けられる文字列です。

1 つのプレフィックス語句の場合、指定したプレフィックス語句で始まるすべての語が、結果セットに含まれます。たとえば、"auto*" は、"automatic"、"automobile" などに一致します。
句の場合、句を構成する各語がプレフィックス語句と見なされます。たとえば、"auto tran" は "automatic transmission" や "automobile transducer" に一致しますが、"automatic motor transmission" には一致しません。

プレフィックス検索は CONTAINS と CONTAINSTABLE でサポートされます。

特定の語の変化形 (生成語) の検索

CONTAINS、 CONTAINSTABLE、 FREETEXT、または FREETEXTTABLE を使用すると、動詞のさまざまな時制および活用、または名詞の単数形と複数形 (変化形検索)、または特定の語のシノニム形 (類義語辞典検索) を検索できます。

次の例は AdventureWorks データベースの ProductReview テーブルの Comments 列にある "foot" のすべての語形 ("foot"、"feet" など) を検索します。

USE AdventureWorks2022  
GO  
  
SELECT Comments, ReviewerName  
FROM Production.ProductReview  
WHERE CONTAINS (Comments, 'FORMSOF(INFLECTIONAL, "foot")')  
GO

フルテキスト検索では、動詞のさまざまな時制および活用または名詞の単数形と複数形の検索を可能にするステマーが使用されます。ステマーの詳細については、「検索用のワードブレーカーとステミング機能の構成と管理」を参照してください。

生成語検索に関する詳細情報

変化形は、動詞のさまざまな時制および活用、または名詞の単数形と複数形です。

たとえば、"drive" という単語の活用形を検索します。テーブルのさまざまな行に、"drive"、"drives"、"drove"、"driving"、および "driven" が含まれている場合、これらはどれも drive という語から変化して生成されているので結果セットに入ります。

FREETEXT および FREETEXTTABLE は、指定されたすべての語の変化形の語句を既定で検索します。 CONTAINS および CONTAINSTABLE は、省略可能な INFLECTIONAL 引数をサポートしています。

特定の語のシノニムの検索

類義語辞典は、ユーザー指定の用語のシノニムを定義します。類義語辞典ファイルの詳細については、「フルテキスト検索に使用する類義語辞典ファイルの構成と管理」を参照してください。

たとえば、類義語辞典にエントリ "{car, automobile, truck, van}" が追加された場合、"car" という単語の類義語辞典の形式を検索できます。"automobile"、"truck"、"van"、または "car" という単語が含まれるテーブル内のすべての行が結果セットに表示されます。これらの各単語は、"car" という単語を含むシノニム拡張セットに属しているためです。

FREETEXT と FREETEXTTABLE は、類義語辞典を既定で使用します。 CONTAINS および CONTAINSTABLE は、省略可能な THESAURUS 引数をサポートしています。

近接する語の検索

"近接語句" は、相互に近い語句を示します。最初の検索語句と最後の検索語句を分離する非検索用語の最大数を指定することもできます。さらに、任意の順序で語や句を検索したり、指定した順序で語や句を検索したりすることができます。

たとえば、"ice" という語の近くに "hockey" という語がある行や、"ice skating" という句の近くに "ice hockey" という句がある行を検索できます。

CONTAINS および CONTAINSTABLE

近接検索の詳細については、「NEAR による他の単語の近くにある単語の検索」を参照してください。

重み付け値を使用する語または句 (重み付け語句) の検索

CONTAINSTABLE を使用すると、重み付け値を指定して語または句を検索することができます。重みは 0.0 ～ 1.0 の数値で指定し、一連の語句内における各語句の重要度を示します。重み 0.0 は最低値であり、重み 1.0 は最高値です。

次の例のクエリは、重みを使用して、文字列 "Bay" で始まるテキストに "Street" または "View" が含まれる顧客住所をすべて検索します。結果では、指定された単語をより多く含む行に高いランクが与えられます。

USE AdventureWorks2022  
GO  
  
SELECT AddressLine1, KEY_TBL.RANK   
FROM Person.Address AS Address INNER JOIN  
CONTAINSTABLE(Person.Address, AddressLine1, 'ISABOUT ("Bay*",   
         Street WEIGHT(0.9),   
         View WEIGHT(0.1)  
         ) ' ) AS KEY_TBL  
ON Address.AddressID = KEY_TBL.[KEY]  
ORDER BY KEY_TBL.RANK DESC  
GO

重み付け語句は、単純語句、プレフィックス語句、生成語、または近接語句と組み合わせて使用できます。

重み付け語句検索に関する詳細情報

重み付け語句検索において、重み付け値は、一連の語句内における各語句の重要度を示します。重み付け値 0.0 は最低値であり、重み付け値 1.0 は最高値です。

たとえば、複数の語句を検索するクエリでは、検索条件の各検索語に、他の語との相対的な重要性を示す重み付け値を割り当てることができます。この種のクエリ結果では、検索語に割り当てた相対的な重みに従って、最も関連性の高い行が最初に返されます。結果セットには、指定した語句 (またはそれらの間のコンテンツ) のいずれかを含むドキュメントまたは行が含まれます。ただし、各検索語句に関連付けられている重み付け値の違いにより、一部の結果が他の結果より関連性が高いと見なされます。

重み付け語句検索は CONTAINSTABLE でサポートされます。

AND、OR、および NOT (ブール演算子) の使用

CONTAINS 述語と CONTAINSTABLE 関数は、同じ検索条件を使用します。どちらも、ブール演算子 AND、OR、AND NOT を使用して複数の検索語句を結合した論理演算をサポートします。たとえば、AND を使用して、"latte" と "New York スタイルのベーグル" の両方を含む行を検索できます。たとえば、AND NOT を使用して、"bagel" が含まれているが"クリームチーズ" が含まれていない行を見つけることができます。

一方、FREETEXT と FREETEXTTABLE では、ブール演算子は検索対象の語として扱われます。

CONTAINS を、論理演算子 AND、OR、および NOT を使用する他の述語と組み合わせる方法については、「検索条件 (Transact-SQL)」を参照してください。

例

次の例では、CONTAINS 述語を使用して、説明 ID が 5 以外で、説明に "Aluminum" と "spindle" という両方の単語が含まれている説明を検索します。検索条件には AND ブール演算子を使用します。この例では、AdventureWorks2022 データベースの ProductDescription テーブルを使用します。

USE AdventureWorks2022  
GO  
  
SELECT Description  
FROM Production.ProductDescription  
WHERE ProductDescriptionID <> 5 AND  
   CONTAINS(Description, 'aluminum AND spindle')  
GO

大文字と小文字、ストップワード、言語、および類義語辞典

フルテキストクエリを記述する場合は、次のオプションも指定できます。

大文字と小文字の区別」を参照してください。フルテキスト検索クエリでは大文字と小文字は区別されません。ただし、日本語の場合は、同じ発音を複数の方法で表記できます。この表記方法を正規化することは、大文字と小文字の区別をなくすことに似ています。たとえば、「かな」で検索することで、大文字小文字を区別しない検索に近い検索を実現できます。しかし、このような正規化はサポートされていません。
ストップワード」を参照してください。フルテキストクエリを定義する際に、Full-Text Engine でストップワード (ノイズワードとも呼ばれます) が検索基準から除外されます。ストップワードとは、"a"、"and"、"is"、"the" などの頻出する単語で、特定のテキストの検索には通常役立ちません。ストップワードはストップリストに列挙されています。各フルテキストインデックスには特定のストップリストが関連付けられ、それによってクエリから、またはインデックス作成時にインデックスから除外されるストップワードが決まります。詳細については、「フルテキスト検索に使用するストップワードとストップリストの構成と管理」を参照してください。
LANGUAGE オプションを使用した Language。クエリ用語の多くは、ワードブレーカーの動作に大きく依存します。適切なワードブレーカー (およびステミング機能) および類義語辞典ファイルを使用するために、LANGUAGE オプションを指定することをお勧めします。詳細については、「フルテキストインデックス作成時の言語の選択」を参照してください。
類義語辞典。 FREETEXT クエリと FREETEXTTABLE クエリでは、類義語辞典を既定で使用します。 CONTAINS および CONTAINSTABLE は、省略可能な THESAURUS 引数をサポートしています。詳細については、「フルテキスト検索に使用する類義語辞典ファイルの構成と管理」を参照してください。

トークン化の結果の確認

特定のワードブレーカー、類義語辞典、ストップリストの組み合わせをクエリに適用した後に、sys.dm_fts_parser 動的管理ビューを使用すると、フルテキスト検索によって結果がどのようにトークン化されるかを確認できます。詳細については、「sys.dm_fts_parser (Transact-SQL)」を参照してください。

参照

CONTAINS (Transact-SQL)
CONTAINSTABLE (Transact-SQL)
FREETEXT (Transact-SQL)
FREETEXTTABLE (Transact-SQL)
フルテキスト検索クエリの作成 (Visual Database Tools)
フルテキストクエリのパフォーマンスの向上

次の方法で共有

フルテキスト検索でのクエリ

各述語と関数の例

例: CONTAINS

例: FREETEXT

例: CONTAINSTABLE

例 - FREETEXTTABLE

単語の一致または意味の一致

CONTAINS/CONTAINSTABLE

FREETEXT/FREETEXTTABLE

述語と関数を比較する

述語 CONTAINS と FREETEXT

行セット値関数 CONTAINSTABLE と FREETEXTTABLE

特定の種類の検索

特定の語または句 (単純語句) の検索

単純語句検索に関する詳細情報

プレフィックス付きの語 (プレフィックス語句) の検索

プレフィックス検索に関する詳細情報

特定の語の変化形 (生成語) の検索

生成語検索に関する詳細情報

特定の語のシノニムの検索

近接する語の検索

重み付け値を使用する語または句 (重み付け語句) の検索

重み付け語句検索に関する詳細情報

AND、OR、および NOT (ブール演算子) の使用

例

大文字と小文字、ストップワード、言語、および類義語辞典

トークン化の結果の確認

参照

フィードバック

その他のリソース

次の方法で共有

フルテキスト検索でのクエリ

各述語と関数の例

例: CONTAINS

例: FREETEXT

例: CONTAINSTABLE

例 - FREETEXTTABLE

単語の一致または意味の一致

CONTAINS/CONTAINSTABLE

FREETEXT/FREETEXTTABLE

述語と関数を比較する

述語 CONTAINS と FREETEXT

行セット値関数 CONTAINSTABLE と FREETEXTTABLE

特定の種類の検索

特定の語または句 (単純語句) の検索

単純語句検索に関する詳細情報

プレフィックス付きの語 (プレフィックス語句) の検索

プレフィックス検索に関する詳細情報

特定の語の変化形 (生成語) の検索

生成語検索に関する詳細情報

特定の語のシノニムの検索

近接する語の検索

重み付け値を使用する語または句 (重み付け語句) の検索

重み付け語句検索に関する詳細情報

AND、OR、および NOT (ブール演算子) の使用

例

大文字と小文字、ストップ ワード、言語、および類義語辞典

トークン化の結果の確認

参照

フィードバック

その他のリソース

大文字と小文字、ストップワード、言語、および類義語辞典