すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:アナライザー句

最終更新日:Jun 18, 2026

概要

アナライザー句では、フィールドのトークン化方法を指定できます。システムは、指定したトークン化方法に基づいて、指定したフィールド内のテキストをタームに変換します。すべてのフィールドまたは特定のフィールドにトークン化方法を指定できます。また、値のターム変換を行わないフィールドを指定することも可能です。

構文

analyzer=analyzer_description[{',' analyzer_description}]

複数の analyzer_description パラメータは、カンマ (,) で区切ります。次の表に、使用可能なパラメータを示します。

パラメータ

有効な値

デフォルト値

説明

no_tokenize_indexes

index_name1;index_name2

なし

値のターム変換を行わないフィールドを指定します。複数のフィールドを指定する場合は、セミコロン (;) で区切ります。このパラメータは、指定したフィールドの値に対する正規化やストップワード除去など、他の操作には影響しません。

specific_index_analyzer

index_name#analyzer_name

なし

指定したフィールドに対してアナライザーを指定します。このパラメータで指定したアナライザーは、global_analyzer パラメータで指定したアナライザーおよびスキーマで指定されたアナライザーよりも優先されます。複数のフィールドを指定する場合は、セミコロン (;) で区切ります。例:index1#analyzer1;index2#analyzer2。このパラメータで指定するアナライザーは、analyzer.json ファイルに定義されている必要があります。

global_analyzer

IDENTIFIER

なし

すべてのフィールドに使用できるグローバルアナライザーを指定します。このパラメータで指定したアナライザーは、スキーマで指定されたアナライザーよりも優先されます。このパラメータで指定するアナライザーは、analyzer.json ファイルに定義されている必要があります。global_analyzer パラメータを設定しない場合、または specific_index_analyzer パラメータと no_tokenize_indexes パラメータを使用してフィールドの解析方法を指定しない場合、システムはスキーマで指定されたアナライザーを使用してフィールド内のテキストをタームに変換します。

例:

  • 特定のフィールドに対してトークン化を無効にする (no_tokenize_indexes):

    analyzer=no_tokenize_indexes:default

    注:クエリでは、default フィールドはトークン化されません。ただし、正規化やストップワード除去などの他の解析処理は引き続き適用されます。複数のフィールドを指定する場合は、セミコロン (;) で区切ります。例:no_tokenize_indexes:index1;index2

  • 特定のフィールドに対してアナライザーを指定する (specific_index_analyzer):

    analyzer=specific_index_analyzer:index2#aliws

    注:index2 フィールドは aliws アナライザーを使用します。この設定は、global_analyzer で定義されているアナライザーまたはスキーマで指定されたアナライザーよりも優先されます。複数のフィールドを指定する場合は、セミコロン (;) で区切ります。例:specific_index_analyzer:index1#extend_analyzer;index2#aliws。アナライザーは analyzer.json 設定ファイルに定義されている必要があります。

  • グローバルアナライザーを指定する (global_analyzer):

    analyzer=global_analyzer:singlews_analyzer

    注:これは singlews_analyzer をグローバルアナライザーとして設定します。これにより、スキーマで指定されたアナライザーが上書きされます。ただし、この設定は no_tokenize_indexes および specific_index_analyzer で指定されているフィールドには影響しません。アナライザーは analyzer.json 設定ファイルに定義されている必要があります。

  • 複数のパラメータを組み合わせる (カンマで区切る):

    analyzer=global_analyzer:singlews_analyzer,no_tokenize_indexes:default,specific_index_analyzer:default#extend_analyzer;index2#aliws

注意事項

  • アナライザー句は省略可能です。

  • フィールドの解析設定は、次の優先順位に従って決定されます:no_tokenize_indexes > specific_index_analyzer > global_analyzer > スキーマで指定されたアナライザー。たとえば、index1 フィールドが no_tokenize_indexesspecific_index_analyzer の両方で指定されている場合、no_tokenize_indexes の方が優先されるため、そのフィールドに対してトークン化は無効になります。

  • クエリ文にアナライザー句を含めない場合、システムはスキーマで指定されているアナライザーを使用します。