アナライザを使用して、 MongoDB Search がstring フィールドの内容を検索可能なタームに変換する方法を制御できます。アナライザは、テキストからトークンを抽出するトークナイザポリシー と、定義した フィルター を組み合わせたものです。MongoDB Search は フィルター をトークンに適用して、句読点、大文字、埋め込み単語などにおける差異を修正する索引可能なタームを作成します。
インデックスを構築するときやデータベースを検索するときにMongoDB Search が使用する アナライザ をインデックス定義で指定できます。また、個々のフィールドのインデックスを作成するときに使用する代替(マルチ)アナライザを指定したり、独自のカスタムアナライザを定義したりすることもできます。
構文
次のタブは、インデックス定義で設定できるアナライザオプションの構文を示しています。
MongoDB Search のインデックス定義で analyzer オプションを使用してインデックスを構築するときに、string フィールドに適用するMongoDB Search のインデックスアナライザを指定できます。
MongoDB Search は、フィールドの mappings.fields 定義内のフィールドに別のアナライザを指定しない限り、インデックス定義内のすべてのフィールドに最上位のアナライザを適用します。
analyzer オプションを省略すると、 MongoDB Search はデフォルトで 標準アナライザを使用します。
{ "analyzer": "<analyzer-for-index>", "mappings": { "fields": { "<string-field-name>": { "type": "string", "analyzer": "<analyzer-for-field>" } } }}MongoDB Searchインデックス定義で searchAnalyzer オプションを使用して、クエリ テキストに適用するMongoDB Search の検索アナライザを指定できます。
searchAnalyzer オプションを省略すると、 MongoDB Search はデフォルトで、analyzer オプションに指定したアナライザを使用します。両方のオプションを省略すると、 MongoDB Search はデフォルトで 標準 アナライザを使用します。
{ "searchAnalyzer": "<analyzer-for-query>", "mappings": { "dynamic": <boolean>, "fields": { <field-definition> } }}MongoDB Search のインデックス定義で multi オプションを使用してインデックスを構築するときに、 MongoDB Search が string フィールドに適用する代替アナライザを指定できます。
MongoDB Search クエリで代替アナライザを使用するには、クエリ演算子のクエリパスの multiフィールドに代替アナライザの名前を指定する必要があります。
詳しくは、「 マルチアナライザ 」を参照してください。
{ "mappings": { "fields": { "<string-field-name>": { "type": "string", "analyzer": "<default-analyzer-for-field>", "multi": { "<alternate-analyzer-name>": { "type": "string", "analyzer": "<alternate-analyzer-for-field>" } } } } }}MongoDB Searchインデックスの analyzers オプションを使用して、文字シーケンスを変換、フィルタリング、グループ化するための 1 つ以上のカスタムアナライザを定義できます。
定義したカスタムアナライザを使用するには、インデックス定義の analyzer、searchAnalyzer、または multi.analyzer オプションにそのname値を指定します。
詳細については、カスタムアナライザを参照してください。
{ "mappings": { "dynamic": <boolean>, "fields": { <field-definition> } }, "analyzers": [ { "name": "<custom-analyzer-name>", "tokenizer": { "type": "<tokenizer-type>" } } ]}Tip
参照: ビデオで学ぶ
このビデオでは、 MongoDB Search が アナライザ を使用してドキュメントを検索可能なユニットに分割し、 逆インデックスを構築する方法を確認します。
所要時間: 8分
アナライザ
MongoDB Search は、次の組み込みアナライザを提供します。
analyzer | 説明 |
|---|---|
すべてのMongoDB Search インデックスとクエリにデフォルトのアナライザを使用します。 | |
文字以外の文字が見つかった場合、テキストを検索可能なタームに分割します。 | |
空白文字が見つかった場合は、テキストを検索可能なタームに分割します。 | |
テキスト フィールドを単一の用語としてインデックスします。 | |
言語固有のテキスト アナライザ のセットを提供します。 |
インデックス定義でアナライザを指定しない場合、MongoDBはデフォルトの標準アナライザを使用します。
正規化
正規表現は、分析の最後に 1 つのトークンのみを生成します。正規表現は、 MongoDB Search トークン タイプのフィールド定義でのみ構成できます。MongoDB Search は次の正規表現を提供します。
正規表現 | 説明 |
|---|---|
| string フィールド内のテキストを小文字に変換し、string 全体に対して単一のトークンを作成します。 |
| 変換は実行されませんが、単一のトークンが作成されます。 |