Azure AI 検索 でクエリを実行する

Azure AI 検索 では、フリーフォーム テキスト検索から高度に指定されたクエリ パターンやベクトル検索まで、さまざまなシナリオのクエリ コンストラクトがサポートされます。 すべてのクエリは、検索可能なコンテンツを格納する検索インデックスに対して実行されます。

クエリの種類

この記事の残りの部分では、最後のカテゴリに焦点を当てます。プレーン テキストと人間が判読できるコンテンツで動作するクラシック クエリは、元のソースからそのまま抽出され、フィルターやその他の特殊なクエリ フォームに使用されます。 AI を使用していない従来の検索アプリケーションを作成する場合、このセクションでは、クライアント コードに実装できるクエリメソッドについて説明します。

オートコンプリートとクエリ候補

オートコンプリートや結果候補は、search の代替手段です。これは、部分文字列の入力 (各文字の後) に基づいて一連のクエリ要求を入力につれて検索する方式で行います。 autocompleteで説明しているように、suggestions と パラメーターは一緒に使用することも、個別に使用することもできますが、search と一緒に使用することはできません。 完成した用語とクエリ候補はどちらもインデックスの内容から派生されます。 このエンジンは、インデックスに存在しない文字列や候補を返しません。 詳細については、「オートコンプリート (REST API)」と「検索候補 (REST API)」をご覧ください。

フィルター検索

フィルターは、Azure AI 検索 を元に構築したアプリで広く使用されています。 アプリケーション ページでは、フィルターは多くの場合、ユーザー向けのフィルター処理のためにリンク ナビゲーション構造のファセットとして視覚化されます。 フィルターは、インデックス付きコンテンツのスライスを公開するために、内部的にも使用されます。 たとえば、製品カテゴリに対してフィルターを使用して検索ページを初期化したり、インデックスに英語とフランス語の両方のフィールドが含まれている場合は、言語を初期化したりすることができます。

次の表に示すように、特殊なクエリ フォームを呼び出すフィルターが必要な場合もあります。 指定されていない検索 (search=*) を含むフィルターを使用することも、用語、語句、演算子、およびパターンを含むクエリ文字列を含むフィルターを使用することもできます。

地理空間検索

地理空間検索では、場所の緯度と経度の座標に基づき、“近くを検索” またはマップベースの検索体験を提供します。 Azure AI 検索 では、次の手順に従って地理空間検索を実装できます。

1. Edm.GeographyPoint または Collection(Edm.GeographyPoint) 型のフィルター可能なフィールドを定義します。
2. 受信ドキュメントに適切な座標が含まれていることを確認します。
3. インデックス作成が完了したら、フィルターと地理空間関数を使用するクエリを作成します。

地理空間検索では、距離にキロメートルを使用します。 座標は (longitude, latitude) の形式で指定されます。

地理空間検索のフィルターの例を次に示します。 このフィルターでは、地理的なポイント (この例ではワシントン D.C.) から半径 300 キロ以内に座標を持つ他の Location フィールドを検索インデックスから見つけます。 結果にアドレス情報を返し、場所による自己ナビゲーションのためにオプションの facets 句を含めます。

POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2026-04-01
{
    "count": true,
    "search": "*",
    "filter": "geo.distance(Location, geography'POINT(-77.03241 38.90166)') le 300",
    "facets": [ "Address/StateProvince"],
    "select": "HotelId, HotelName, Address/StreetAddress, Address/City, Address/StateProvince",
    "top": 7
}

詳細および例については、地理空間検索の例に関するページをご覧ください。

ドキュメントの検索

前述のクエリ フォームとは対照的に、このフォームでは、対応するインデックス検索またはスキャンを行わずに、ID による検索ドキュメントを 1 つ取得します。 1 つのドキュメントのみが要求され、返されます。 ユーザーが検索結果で項目を選択する場合、ドキュメントの取得と詳細ページでのフィールドの設定が典型的な応答になり、ドキュメントの検索はこれをサポートする操作になります。

高度な検索: あいまい、ワイルドカード、近接、正規表現

高度なクエリ フォームは、特定のクエリ動作をトリガーする完全な Lucene パーサーと演算子に依存します。

次のステップ

クエリの実装について詳しく見るには、構文ごとに例を確認します。 フルテキスト検索を初めて使用する場合は、クエリ エンジンの機能の詳細を確認することもできます。

• 簡易クエリの例
• 高度なクエリを作成するための Lucene 構文のクエリの例
• Azure AI 検索 でのフルテキスト検索のしくみ