Elasticsearch クエリから Milvus へ
Apache Lucene 上に構築された Elasticsearch は、主要なオープンソース検索エンジンです。しかし、高い更新コスト、低いリアルタイム性能、非効率なシャード管理、クラウドネイティブではない設計、過剰なリソース需要など、現代の AI アプリケーションでは課題に直面します。クラウドネイティブなベクトルデータベースである Milvus は、ストレージとコンピューティングの分離、高次元データ向けの効率的なインデックス作成、最新インフラとのシームレスな統合によって、これらの課題を克服します。AI ワークロードに優れたパフォーマンスとスケーラビリティを提供します。
この記事は、コードベースを Elasticsearch から Milvus へ移行しやすくすることを目的としており、両者間でクエリを変換するさまざまな例を示します。
概要
Elasticsearch では、クエリコンテキストでの操作は関連度スコアを生成しますが、フィルターコンテキストでの操作は生成しません。同様に、Milvus の検索は類似度スコアを生成しますが、フィルターに類するクエリは生成しません。コードベースを Elasticsearch から Milvus へ移行する際の基本原則は、Elasticsearch のクエリコンテキストで使用されるフィールドをベクトルフィールドに変換し、類似度スコアを生成できるようにすることです。
以下の表は、いくつかの Elasticsearch クエリパターンと、それに対応する Milvus での等価表現を示しています。
Elasticsearch クエリ | Milvus での等価表現 | 備考 |
|---|---|---|
全文検索クエリ | ||
全文検索 | どちらも類似した機能セットを提供します。 | |
タームレベルクエリ | ||
| これらの Elasticsearch クエリをフィルターコンテキストで使用する場合、どちらも同一または類似した機能セットを提供します。 | |
| ||
| ||
| ||
| ||
| ||
| フィルターコンテキストで使用する場合、どちらも類似した機能セットを提供します。 | |
ベクトルクエリ | ||
検索 | Milvus はより高度なベクトル検索機能を提供します。 | |
ハイブリッド検索 | Milvus は複数のリランキング戦略をサポートしています。 | |
全文検索クエリ
Elasticsearch では、全文検索クエリを使用すると、メール本文などの解析済みテキストフィールドを検索できます。クエリ文字列は、インデックス作成時にそのフィールドに適用されたものと同じアナライザーを使用して処理されます。
Match クエリ
Elasticsearch では、Match クエリは、指定されたテキスト、数値、日付、またはブール値に一致するドキュメントを返します。指定されたテキストは、照合の前に解析されます。
以下は、Match クエリを使用した Elasticsearch の検索リクエストの例です。
resp = client.search(
query={
"match": {
"message": {
"query": "this is a test"
}
}
},
)
Milvus は、全文検索機能を通じて同じ機能を提供します。上記の Elasticsearch クエリは、次のように Milvus に変換できます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
res = client.search(
collection_name="my_collection",
data=['How is the weather in Jamaica?'],
anns_field="message_sparse",
output_fields=["id", "message"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.SearchReq;
import io.milvus.v2.service.vector.request.data.EmbeddedText;
import io.milvus.v2.service.vector.response.SearchResp;
import java.util.*;
SearchReq searchReq = SearchReq.builder()
.collectionName("my_collection")
.data(Collections.singletonList(new EmbeddedText("How is the weather in Jamaica?")))
.annsField("message_sparse")
.outputFields(Arrays.asList("id", "message"))
.build();
SearchResp searchResp = client.search(searchReq);
// Note: this feature is not yet supported in milvus-sdk-go.
client
.search(
SearchRequest::builder()
.collection_name("my_collection")
.vector_field("message_sparse")
.vectors(SearchVectors::EmbeddedText(vec!["How is the weather in Jamaica?".to_string()]))
.output_fields(["id", "message"])
.build()?,
)
.await?;
auto request = milvus::SearchRequest()
.WithCollectionName("my_collection")
.WithAnnsField("message_sparse")
.AddEmbeddedText("How is the weather in Jamaica?")
.AddOutputField("id")
.AddOutputField("message");
milvus::SearchResponse response;
auto status = client->Search(request, response);
const res = await client.search({
collection_name: "my_collection",
data: ["How is the weather in Jamaica?"],
anns_field: "message_sparse",
output_fields: ["id", "message"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/search" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"data": ["How is the weather in Jamaica?"],
"annsField": "message_sparse",
"outputFields": ["id", "message"]
}'
上記の例では、message_sparse は、message という名前の VarChar フィールドから派生したスパースベクトルフィールドです。Milvus は BM25 埋め込みモデルを使用して、message フィールドの値をスパースベクトル埋め込みに変換し、message_sparse フィールドに保存します。検索リクエストを受信すると、Milvus は同じ BM25 モデルを使用してプレーンテキストのクエリペイロードを埋め込み、スパースベクトル検索を実行して、output_fields パラメーターで指定された id および message フィールドを、対応する類似度スコアとともに返します。
この機能を使用するには、message フィールドでアナライザーを有効にし、そこから message_sparse フィールドを派生させる関数を定義する必要があります。Milvus でアナライザーを有効にして派生関数を作成する詳細な手順については、全文検索 を参照してください。
タームレベルクエリ
Elasticsearch では、タームレベルクエリは、日付範囲、IP アドレス、価格、製品 ID など、構造化データ内の正確な値に基づいてドキュメントを検索するために使用されます。このセクションでは、一部の Elasticsearch タームレベルクエリに対応する可能性のある Milvus での等価表現を概説します。このセクションのすべての例は、Milvus の機能に合わせてフィルターコンテキスト内で動作するように調整されています。
IDs
Elasticsearch では、次のように、フィルターコンテキストで ID に基づいてドキュメントを検索できます。
resp = client.search(
query={
"bool": {
"filter": {
"ids": {
"values": [
"1",
"4",
"100"
]
}
}
}
},
)
Milvus では、次のように、ID に基づいてエンティティを検索することもできます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
# Use the filter parameter
res = client.query(
collection_name="my_collection",
filter="id in [1, 4, 100]",
output_fields=["id", "title"]
)
# Use the ids parameter
res = client.query(
collection_name="my_collection",
ids=[1, 4, 100],
output_fields=["id", "title"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("id in [1, 4, 100]")
.outputFields(Arrays.asList("id", "title"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("id in [1, 4, 100]").
WithOutputFields("id", "title"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("id in [1, 4, 100]")
.output_fields(["id", "title"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("id in [1, 4, 100]")
.AddOutputField("id")
.AddOutputField("title")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: 'id in [1, 4, 100]',
output_fields: ["id", "title"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "id in [1, 4, 100]",
"outputFields": ["id", "title"]
}'
Elasticsearch の例は こちらのページ にあります。Milvus でのクエリおよび get リクエストとフィルター式の詳細については、クエリ と フィルタリングの解説 を参照してください。
Prefix クエリ
Elasticsearch では、次のように、フィルターコンテキストで、指定されたフィールドに特定のプレフィックスを含むドキュメントを検索できます。
resp = client.search(
query={
"bool": {
"filter": {
"prefix": {
"user": {
"value": "ki"
}
}
}
}
},
)
Milvus では、次のように、値が指定されたプレフィックスで始まるエンティティを検索できます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
res = client.query(
collection_name="my_collection",
filter='user like "ki%"',
output_fields=["id", "user"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("user like \"ki%\"")
.outputFields(Arrays.asList("id", "user"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("user like \"ki%\"").
WithOutputFields("id", "user"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("user like \"ki%\"")
.output_fields(["id", "user"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("user like \"ki%\"")
.AddOutputField("id")
.AddOutputField("user")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: 'user like "ki%"',
output_fields: ["id", "user"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "user like \"ki%\"",
"outputFields": ["id", "user"]
}'
Elasticsearch の例は こちらのページ にあります。Milvus の like 演算子の詳細については、パターンマッチングに LIKE を使用する方法 を参照してください。
Range クエリ
Elasticsearch では、次のように、指定された範囲内のタームを含むドキュメントを検索できます。
resp = client.search(
query={
"bool": {
"filter": {
"range": {
"age": {
"gte": 10,
"lte": 20
}
}
}
}
},
)
Milvus では、次のように、特定のフィールドの値が指定された範囲内にあるエンティティを検索できます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
res = client.query(
collection_name="my_collection",
filter='10 <= age <= 20',
output_fields=["id", "user", "age"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("10 <= age <= 20")
.outputFields(Arrays.asList("id", "user", "age"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("10 <= age <= 20").
WithOutputFields("id", "user", "age"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("10 <= age <= 20")
.output_fields(["id", "user", "age"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("10 <= age <= 20")
.AddOutputField("id")
.AddOutputField("user")
.AddOutputField("age")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: '10 <= age <= 20',
output_fields: ["id", "user", "age"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "10 <= age <= 20",
"outputFields": ["id", "user", "age"]
}'
Elasticsearch の例は こちらのページ にあります。Milvus の比較演算子の詳細については、比較演算子 を参照してください。
Term クエリ
Elasticsearch では、次のように、指定されたフィールドに正確なタームを含むドキュメントを検索できます。
resp = client.search(
query={
"bool": {
"filter": {
"term": {
"status": {
"value": "retired"
}
}
}
}
},
)
Milvus では、次のように、指定されたフィールドの値が指定されたタームと完全に一致するエンティティを検索できます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
# use ==
res = client.query(
collection_name="my_collection",
filter='status=="retired"',
output_fields=["id", "user", "status"]
)
# use TEXT_MATCH
res = client.query(
collection_name="my_collection",
filter='TEXT_MATCH(status, "retired")',
output_fields=["id", "user", "status"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("status==\"retired\"")
.outputFields(Arrays.asList("id", "user", "status"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("status==\"retired\"").
WithOutputFields("id", "user", "status"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("status==\"retired\"")
.output_fields(["id", "user", "status"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("status==\"retired\"")
.AddOutputField("id")
.AddOutputField("user")
.AddOutputField("status")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: 'status=="retired"',
output_fields: ["id", "user", "status"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "status==\"retired\"",
"outputFields": ["id", "user", "status"]
}'
Elasticsearch の例は こちらのページ にあります。Milvus の比較演算子の詳細については、比較演算子 を参照してください。
Terms クエリ
Elasticsearch では、次のように、指定されたフィールドに 1つ以上の正確なタームを含むドキュメントを検索できます。
resp = client.search(
query={
"bool": {
"filter": {
"terms": {
"degree": [
"graduate",
"post-graduate"
]
}
}
}
}
)
Milvus には、これに完全に対応するものはありません。ただし、次のように、指定されたフィールドの値が指定されたタームのいずれかであるエンティティを検索できます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
# use in
res = client.query(
collection_name="my_collection",
filter='degree in ["graduate", "post-graduate"]',
output_fields=["id", "user", "degree"]
)
# use TEXT_MATCH
res = client.query(
collection_name="my_collection",
filter='TEXT_MATCH(degree, "graduate post-graduate")',
output_fields=["id", "user", "degree"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("degree in [\"graduate\", \"post-graduate\"]")
.outputFields(Arrays.asList("id", "user", "degree"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("degree in [\"graduate\", \"post-graduate\"]").
WithOutputFields("id", "user", "degree"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("degree in [\"graduate\", \"post-graduate\"]")
.output_fields(["id", "user", "degree"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("degree in [\"graduate\", \"post-graduate\"]")
.AddOutputField("id")
.AddOutputField("user")
.AddOutputField("degree")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: 'degree in ["graduate", "post-graduate"]',
output_fields: ["id", "user", "degree"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "degree in [\"graduate\", \"post-graduate\"]",
"outputFields": ["id", "user", "degree"]
}'
Elasticsearch の例は こちらのページ にあります。Milvus の範囲演算子の詳細については、範囲演算子 を参照してください。
Wildcard クエリ
Elasticsearch では、次のように、ワイルドカードパターンに一致するタームを含むドキュメントを検索できます。
resp = client.search(
query={
"bool": {
"filter": {
"wildcard": {
"user": {
"value": "ki*y"
}
}
}
}
},
)
Milvus はフィルタリング条件でワイルドカードをサポートしていません。ただし、次のように like 演算子を使用すると、同様の効果を得られます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
res = client.query(
collection_name="my_collection",
filter='user like "ki%" AND user like "%y"',
output_fields=["id", "user"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("user like \"ki%\" AND user like \"%y\"")
.outputFields(Arrays.asList("id", "user"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("user like \"ki%\" AND user like \"%y\"").
WithOutputFields("id", "user"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("user like \"ki%\" AND user like \"%y\"")
.output_fields(["id", "user"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("user like \"ki%\" AND user like \"%y\"")
.AddOutputField("id")
.AddOutputField("user")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: 'user like "ki%" AND user like "%y"',
output_fields: ["id", "user"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "user like \"ki%\" AND user like \"%y\"",
"outputFields": ["id", "user"]
}'
Elasticsearch の例は こちらのページ にあります。Milvus の範囲演算子の詳細については、範囲演算子 を参照してください。
Boolean クエリ
Elasticsearch では、Boolean クエリとは、他のクエリのブール結合に一致するドキュメントにマッチするクエリです。
次の例は、Elasticsearch ドキュメントの こちらのページ の例を基にしています。このクエリは、名前に kimchy を含み、production タグを持つユーザーを返します。
resp = client.search(
query={
"bool": {
"filter": {
"term": {
"user": "kimchy"
}
},
"filter": {
"term": {
"tags": "production"
}
}
}
},
)
Milvus では、次のように同様のことができます。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
res = client.query(
collection_name="my_collection",
filter='user like "%kimchy%" AND ARRAY_CONTAINS(tags, "production")',
output_fields=["id", "user", "age", "tags"]
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.QueryReq;
import io.milvus.v2.service.vector.response.QueryResp;
import java.util.*;
QueryReq queryReq = QueryReq.builder()
.collectionName("my_collection")
.filter("user like \"%kimchy%\" AND ARRAY_CONTAINS(tags, \"production\")")
.outputFields(Arrays.asList("id", "user", "age", "tags"))
.build();
QueryResp queryResp = client.query(queryReq);
client.Query(ctx, milvusclient.NewQueryOption("my_collection").
WithFilter("user like \"%kimchy%\" AND ARRAY_CONTAINS(tags, \"production\")").
WithOutputFields("id", "user", "age", "tags"))
client
.query(
QueryRequest::builder()
.collection_name("my_collection")
.filter("user like \"%kimchy%\" AND ARRAY_CONTAINS(tags, \"production\")")
.output_fields(["id", "user", "age", "tags"])
.build()?,
)
.await?;
auto request = milvus::QueryRequest()
.WithCollectionName("my_collection")
.WithFilter("user like \"%kimchy%\" AND ARRAY_CONTAINS(tags, \"production\")")
.AddOutputField("id")
.AddOutputField("user")
.AddOutputField("age")
.AddOutputField("tags")
;
milvus::QueryResponse response;
auto status = client->Query(request, response);
const res = await client.query({
collection_name: "my_collection",
filter: 'user like "%kimchy%" AND ARRAY_CONTAINS(tags, "production")',
output_fields: ["id", "user", "age", "tags"],
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"filter": "user like \"%kimchy%\" AND ARRAY_CONTAINS(tags, \"production\")",
"outputFields": ["id", "user", "age", "tags"]
}'
上記の例は、対象のコレクションに VarChar 型の user フィールドと Array 型の tags フィールドがあることを前提としています。このクエリは、名前に kimchy を含み、production タグを持つユーザーを返します。
ベクトルクエリ
Elasticsearch では、ベクトルクエリは、ベクトルフィールドを対象として効率的にセマンティック検索を実行するための専用クエリです。
kNN クエリ
Elasticsearch は、近似 kNN クエリと、厳密な総当たり方式の kNN クエリの両方をサポートしています。次のように、いずれの方法でも、類似度メトリクスで測定して、クエリベクトルに最も近い k 個のベクトルを見つけることができます。
resp = client.search(
index="my-image-index",
size=3,
query={
"knn": {
"field": "image-vector",
"query_vector": [
-5,
9,
-12
],
"k": 10
}
},
)
Milvus は専用のベクトルデータベースとして、インデックスタイプを使用してベクトル検索を最適化します。通常、高次元ベクトルデータには近似最近傍(ANN)検索を優先します。FLAT インデックスタイプを使用した総当たり kNN 検索は正確な結果を返しますが、時間とリソースの両方を消費します。これに対して、AUTOINDEX またはその他のインデックスタイプを使用した ANN 検索は速度と精度のバランスを取り、kNN よりも大幅に高速でリソース効率の高いパフォーマンスを提供します。インデックスタイプと AUTOINDEX の詳細については、インデックス と AUTOINDEX の解説 を参照してください。
上記のベクトルクエリに類似する Milvus での等価表現は次のとおりです。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
res = client.search(
collection_name="my_collection",
anns_field="image-vector",
data=[[-5, 9, -12]],
limit=10
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.SearchReq;
import io.milvus.v2.service.vector.request.data.FloatVec;
import io.milvus.v2.service.vector.response.SearchResp;
import java.util.*;
SearchReq searchReq = SearchReq.builder()
.collectionName("my_collection")
.data(Collections.singletonList(new FloatVec(new float[]{-5, 9, -12})))
.annsField("image-vector")
.topK(10)
.build();
SearchResp searchResp = client.search(searchReq);
// Note: this feature is not yet supported in milvus-sdk-go.
client
.search(
SearchRequest::builder()
.collection_name("my_collection")
.vector_field("image-vector")
.vectors(SearchVectors::Float(vec![vec![-5.0, 9.0, -12.0]]))
.limit(10)
.build()?,
)
.await?;
auto request = milvus::SearchRequest()
.WithCollectionName("my_collection")
.WithAnnsField("image-vector")
.WithLimit(10)
.AddFloatVector({-5, 9, -12});
milvus::SearchResponse response;
auto status = client->Search(request, response);
const res = await client.search({
collection_name: "my_collection",
data: [[-5, 9, -12]],
anns_field: "image-vector",
limit: 10,
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/search" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"data": [[-5, 9, -12]],
"annsField": "image-vector",
"limit": 10
}'
Elasticsearch の例は こちらのページ にあります。Milvus での ANN 検索の詳細については、基本ベクトル検索 を参照してください。
Reciprocal Rank Fusion
Elasticsearch は、関連性指標の異なる複数の結果セットを 1つのランク付けされた結果セットに統合するために、Reciprocal Rank Fusion(RRF)を提供しています。
次の例は、検索の関連性を高めるために、従来のタームベースの検索と k 近傍法(kNN)によるベクトル検索を組み合わせる方法を示しています。
client.search(
index="my_index",
size=10,
query={
"retriever": {
"rrf": {
"retrievers": [
{
"standard": {
"query": {
"term": {
"text": "shoes"
}
}
}
},
{
"knn": {
"field": "vector",
"query_vector": [1.25, 2, 3.5], # Example vector; replace with your actual query vector
"k": 50,
"num_candidates": 100
}
}
],
"rank_window_size": 50,
"rank_constant": 20
}
}
}
)
この例では、RRF は 2つのレトリーバーの結果を統合します。
-
textフィールドに"shoes"というタームを含むドキュメントを対象とする、標準的なタームベースの検索です。 -
指定されたクエリベクトルを使用した、
vectorフィールドに対する kNN 検索です。
各レトリーバーは最大 50 件の上位一致を提供し、それらは RRF によって再ランク付けされ、最終的な上位 10 件の結果が返されます。
Milvus では、複数のベクトルフィールドにまたがる検索を組み合わせ、リランキング戦略を適用し、統合されたリストから top-K 件の結果を取得することで、同様のハイブリッド検索を実現できます。Milvus は RRF と重み付きリランカーの両方の戦略をサポートしています。詳細については、Weighted Ranker とその関連ページを参照してください。
以下は、上記の Elasticsearch の例に対応する、Milvus での厳密ではない等価表現です。
- Python
- Java
- Go
- Rust
- C++
- NodeJS
- cURL
from pymilvus import AnnSearchRequest, RRFRanker
search_params_dense = {
"data": [[1.25, 2, 3.5]],
"anns_field": "vector",
"param": {"metric_type": "COSINE"},
"limit": 100
}
req_dense = AnnSearchRequest(**search_params_dense)
search_params_sparse = {
"data": ["shoes"],
"anns_field": "text_sparse",
"param": {"metric_type": "BM25"},
"limit": 100
}
req_sparse = AnnSearchRequest(**search_params_sparse)
res = client.hybrid_search(
collection_name="my_collection",
reqs=[req_dense, req_sparse],
ranker=RRFRanker(),
limit=10
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.vector.request.HybridSearchReq;
import io.milvus.v2.service.vector.request.ranker.RRFRanker;
import io.milvus.v2.service.vector.request.AnnSearchReq;
import io.milvus.v2.service.vector.request.data.EmbeddedText;
import io.milvus.v2.service.vector.request.data.FloatVec;
import io.milvus.v2.service.vector.response.SearchResp;
import java.util.*;
List<AnnSearchReq> searchRequests = new ArrayList<>();
searchRequests.add(AnnSearchReq.builder()
.vectors(Collections.singletonList(new FloatVec(new float[]{1.25f, 2.0f, 3.5f})))
.vectorFieldName("vector")
.topK(100)
.build());
searchRequests.add(AnnSearchReq.builder()
.vectors(Collections.singletonList(new EmbeddedText("shoes")))
.vectorFieldName("text_sparse")
.topK(100)
.build());
HybridSearchReq hybridSearchReq = HybridSearchReq.builder()
.collectionName("my_collection")
.searchRequests(searchRequests)
.ranker(new RRFRanker(60))
.limit(10)
.build();
SearchResp searchResp = client.hybridSearch(hybridSearchReq);
// See the hybrid search guide for the milvus-sdk-go equivalent.
use milvus::v2::prelude::*;
let res = client
.hybrid_search(
HybridSearchRequest::builder()
.collection_name("my_collection")
.sub_requests(vec![
SubSearchRequest::builder()
.vector_field("vector")
.vectors(SearchVectors::Float(vec![vec![1.25, 2.0, 3.5]]))
.limit(100)
.build()?,
SubSearchRequest::builder()
.vector_field("text_sparse")
.vectors(SearchVectors::EmbeddedText(vec!["shoes".to_string()]))
.limit(100)
.build()?,
])
.rerank(RRFRerank::new())
.build()?,
)
.await?;
milvus::HybridSearchResponse response;
milvus::HybridSearchRequest request;
request.WithCollectionName("my_collection");
request.WithLimit(10);
auto dense_sub = std::make_shared<milvus::SubSearchRequest>();
dense_sub->WithAnnsField("vector").WithLimit(100);
dense_sub->AddFloatVector({1.25f, 2.0f, 3.5f});
auto sparse_sub = std::make_shared<milvus::SubSearchRequest>();
sparse_sub->WithAnnsField("text_sparse").WithLimit(100);
sparse_sub->AddEmbeddedText("shoes");
request.AddSubRequest(dense_sub);
request.AddSubRequest(sparse_sub);
request.WithRerank(std::make_shared<milvus::RRFRerank>(60));
auto status = client->HybridSearch(request, response);
if (!status.IsOk()) {
std::cout << status.Message() << std::endl;
}
import { MilvusClient, RRFRanker } from "@zilliz/milvus2-sdk-node";
const client = new MilvusClient({ address: "YOUR_CLUSTER_ENDPOINT", token: "YOUR_CLUSTER_TOKEN" });
const res = await client.hybridSearch({
collection_name: "my_collection",
data: [
{ data: [[1.25, 2, 3.5]], anns_field: "vector", limit: 100 },
{ data: ["shoes"], anns_field: "text_sparse", limit: 100 },
],
rerank: RRFRanker(),
limit: 10,
});
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/hybrid_search" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--data '{
"collectionName": "my_collection",
"search": [
{ "data": [[1.25, 2, 3.5]], "annsField": "vector", "limit": 100 },
{ "data": ["shoes"], "annsField": "text_sparse", "limit": 100 }
],
"rerank": { "strategy": "rrf" },
"limit": 10
}'
この例は、以下を組み合わせた Milvus でのハイブリッド検索を示しています。
-
高密度ベクトル検索:
vectorフィールドに対する近似最近傍(ANN)検索に内積(IP)メトリクスを使用します。 -
スパースベクトル検索:
text_sparseフィールドで BM25 類似度メトリクスを使用します。
これらの検索の結果は個別に実行され、統合された後、Reciprocal Rank Fusion(RRF)ランカーを使用して再ランク付けされます。ハイブリッド検索は、再ランク付けされたリストから上位 10 件のエンティティを返します。
標準的なテキストベースのクエリと kNN 検索の結果を統合する Elasticsearch の RRF ランキングとは異なり、Milvus はスパースベクトル検索と高密度ベクトル検索の結果を組み合わせ、マルチモーダルデータに最適化された独自のハイブリッド検索機能を提供します。
まとめ
この記事では、タームレベルクエリ、Boolean クエリ、全文検索クエリ、ベクトルクエリなど、一般的な Elasticsearch クエリから Milvus での等価表現への変換について説明しました。他の Elasticsearch クエリの変換についてさらに質問がある場合は、お気軽にお問い合わせください。