同義語 API

      • 同義語管理 API は、内部システムインデックス内で同義語を定義および管理する便利な方法を提供します。関連する同義語は「同義語セット」にグループ化できます。必要に応じて、同義語セットをいくつでも作成できます。

これは次の代替手段を提供します:

  • マッピングサイズに影響を与え、パフォーマンスの問題を引き起こす可能性のある、アナライザー定義内でのインライン同義語の定義。
  • すべてのクラスター ノードでファイルの一貫性をアップロードおよび管理することを意味する同義語ファイルの使用。

同義語セットは、同義語グラフトークンフィルター および 同義語トークンフィルター を構成するために使用できます。これらのフィルターは、検索アナライザー によって 分析 プロセスの一部として適用されます。

同義語セットは、セットごとに最大 10,000 の同義語ルールに制限されています。より多くの同義語ルールを管理する必要がある場合は、複数の同義語セットを作成できます。

同義語セットは、インデックスに追加される前に存在する必要があります。存在しない同義語セットを参照してインデックスが作成されると、インデックスは部分的に作成され、操作不能な状態のままになります。このシナリオから回復する唯一の方法は、同義語セットが存在することを確認し、その後インデックスを削除して再作成するか、インデックスを閉じて再オープンすることです。

無効な同義語ルールは、アナライザーの変更を適用する際にエラーを引き起こす可能性があります。リロード可能なアナライザーの場合、これはリロードと変更の適用を妨げます。同義語ルールのエラーを修正し、アナライザーをリロードする必要があります。

無効な同義語ルールを持つインデックスは再オープンできず、次の状況で操作不能になります:

  • インデックスを含むノードが起動する
  • インデックスが閉じた状態からオープンされる
  • ノードの再起動が発生する（これにより、ノードに割り当てられたシャードが再オープンされる）

同義語セット API

これらの API を使用して、検索時に使用される同義語セットを動的に更新できます。検索結果は、同義語セットの変更を即座に反映します。

同義語セットを管理するには、次の API を使用します:

同義語ルール API

同義語セットは同義語ルールで構成されています。各同義語ルールは、同義語として機能する単語のグループを定義します。完全な同義語セットを更新するのではなく、特定の同義語セットの個々の同義語ルールを更新できます。

同義語セット内の個々の同義語ルールを管理するには、次の API を使用します: