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

OpenSearch:ブラックリストとホワイトリスト

最終更新日:Apr 01, 2026

ブラックリストとホワイトリストを使用して、どの検索クエリを検索候補、トレンド、ヒントワードとして表示するかをコントロールします。不要なクエリをブラックリストに追加してブロックしたり、高品質なクエリをホワイトリストに追加して結果の上位に表示したりできます。

仕組み

  • ブロッキング:ブラックリストは包含マッチング (部分文字列マッチングに相当) を使用します。候補となる検索クエリ内の分割された term のいずれかがブラックリストに登録されたキーワードと一致した場合、そのクエリ全体がブロックされます。たとえば、「garbage」がブラックリストにある場合、「garbage」という term を含むクエリはすべて結果から除外されます。

  • 優先表示:推奨条件を満たすホワイトリストのクエリは、候補となる検索クエリの結果で優先的に表示されます。

  • 競合の解決:同じクエリがブラックリストとホワイトリストの両方に一致する場合、ブラックリストが優先されます。

  • 正規表現のサポート:ブラックリストは正規表現をサポートしており、1 つのエントリで多くの類似パターンをカバーできます。これはエントリ数の上限内に収めるのに役立ちます。

  • 即時反映:変更はすぐに反映されます。モデルの再トレーニングは不要です。

リストタイプ別の動作

リストタイプアクティブな場合の動作
検索候補ブラックリスト一致するクエリは検索候補に表示されません
検索候補ホワイトリスト一致するクエリは検索候補で優先的に表示されます
トップ検索ブラックリスト一致するクエリはトレンドから除外されます
トップ検索ホワイトリストクエリはトレンドの指定された位置に表示されます。ある位置にクエリが設定されていない場合、結果はトレンドモデルのランキングに従います
ヒントワードブラックリスト一致するクエリはヒントワードから除外されます
ヒントワードホワイトリストクエリはヒントワード内の推奨検索クエリとしてローテーション表示されます

介入辞書の作成と適用

前提条件

開始する前に、以下を確認してください:

  • OpenSearch コンソールへのアクセス権

  • 辞書をアタッチするための既存の検索候補モデル

ブラックリストまたはホワイトリストの作成

  1. OpenSearch コンソールにログインします。左側のナビゲーションウィンドウで、[検索アルゴリズムセンター] > [検索案内] を選択します。

  2. [ドロップダウン候補] ページで、左側のペインにある [ブラックリストとホワイトリスト] をクリックします。

  3. [ブラックリストとホワイトリスト] ページで、[作成] をクリックします。

    image

  4. [ホワイトリストまたはブラックリストの作成] パネルで、以下を設定します:

    • 名前:介入辞書の名前を入力します。

    • タイプ:リストタイプを選択します。クエリを優先表示するには [検索候補ホワイトリスト] を、ブロックするには [検索候補ブラックリスト] を選択します。

    [保存] をクリックします。

    image

  5. [ブラックリストとホワイトリスト] ページで、作成した辞書を見つけ、[操作] 列の [エントリの管理] をクリックします。

    image

  6. 介入エントリを辞書に追加します。

    image

辞書をモデルにアタッチ

エントリを追加した後、介入辞書を検索候補モデルにアタッチして有効化します。

imageimageimage

制限事項

リストタイプ最大エントリ数
検索候補ブラックリスト500
検索候補ホワイトリスト500
トップ検索ブラックリスト500
トップ検索ホワイトリスト10
ヒントワードブラックリスト500
ヒントワードホワイトリスト3
注意:ブラックリストは正規表現をサポートしています。1 つの正規表現パターンを使用して複数の類似クエリをマッチングさせ、エントリ数の上限内に収めることができます。モデルから参照されているブラックリストとホワイトリストは削除できません。削除する前に、すべてのモデルから辞書をデタッチしてください。