メインコンテンツまでスキップ

範囲検索

範囲検索は、返されるエンティティの距離またはスコアを特定の範囲内に制限することで、検索結果の関連性を高めます。このページでは、範囲検索とは何か、および範囲検索を実行する手順について説明します。

概要​

範囲検索リクエストを実行するとき、Zilliz Cloud は ANN 検索結果からクエリベクトルに最も類似するベクトルを中心とし、検索リクエストで指定した radius を外側の円の半径、range_filter を内側の円の半径として、2 つの同心円を描きます。この 2 つの同心円によって形成される環状領域内に類似度スコアが収まるすべてのベクトルが返されます。ここで、range_filter を 0 に設定すると、指定した類似度スコア(radius)内のすべてのエンティティが返されることを示します。

範囲検索

上の図は、範囲検索リクエストに radius と range_filter の 2 つのパラメーターが含まれていることを示しています。範囲検索リクエストを受信すると、Zilliz Cloud は次の処理を行います。

  • 指定したメトリクスタイプ(COSINE)を使用して、クエリベクトルに最も類似するすべてのベクトル埋め込みを検索します。

  • クエリベクトルに対する distances または scores が、radius および range_filter パラメーターで指定された範囲内に収まるベクトル埋め込みをフィルタリングします。

  • フィルタリングされたエンティティから top-K のエンティティを返します。

radius と range_filter の設定方法は、検索のメトリクスタイプによって異なります。次の表に、メトリクスタイプごとにこれら 2 つのパラメーターを設定する際の要件を示します。

メトリクスタイプ

表記

radius と range_filter を設定するための要件

L2

L2 距離が小さいほど、類似度が高いことを示します。

最も類似するベクトル埋め込みを無視するには、次の条件を満たす必要があります。

range_filter <= distance < radius

IP

IP 距離が大きいほど、類似度が高いことを示します。

最も類似するベクトル埋め込みを無視するには、次の条件を満たす必要があります。

radius < distance <= range_filter

COSINE

COSINE 距離が大きいほど、類似度が高いことを示します。

最も類似するベクトル埋め込みを無視するには、次の条件を満たす必要があります。

radius < distance <= range_filter

JACCARD

Jaccard 距離が小さいほど、類似度が高いことを示します。

最も類似するベクトル埋め込みを無視するには、次の条件を満たす必要があります。

range_filter <= distance < radius

HAMMING

Hamming 距離が小さいほど、類似度が高いことを示します。

最も類似するベクトル埋め込みを無視するには、次の条件を満たす必要があります。

range_filter <= distance < radius

例​

このセクションでは、範囲検索を実行する方法を説明します。次のコードスニペットの検索リクエストにはメトリクスタイプが含まれていないため、デフォルトのメトリクスタイプ COSINE が適用されます。この場合、radius の値が range_filter の値より小さくなるようにしてください。

次のコードスニペットでは、radius を 0.4、range_filter を 0.6 に設定して、Zilliz Cloud がクエリベクトルに対する距離またはスコアが 0.4 から 0.6 の範囲内に収まるすべてのエンティティを返すようにします。

python
from pymilvus import MilvusClient

client = MilvusClient(
uri="YOUR_CLUSTER_ENDPOINT",
token="YOUR_CLUSTER_TOKEN"
)

query_vector = [0.3580376395471989, -0.6023495712049978, 0.18414012509913835, -0.26286205330961354, 0.9029438446296592]

res = client.search(
collection_name="my_collection",
data=[query_vector],
limit=3,
search_params={
"params": {
"radius": 0.4,
"range_filter": 0.6
}
}
)

for hits in res:
print("TopK results:")
for hit in hits:
print(hit)
📘Notes

クエリベクトルがターゲットコレクションにすでに存在する場合は、検索前に取得する代わりに ids を使用することを検討してください。詳細は、プライマリキー検索 を参照してください。

このページは役に立ちましたか?