AggregationBucket

公测版

AggregationBucket 表示 Search Aggregation 返回的一个 bucket。PyMilvus 会根据服务器响应创建这些对象；应用程序不会直接构造它们。

python

class pymilvus.AggregationBucket

属性

• key (list[dict[str, Any]]) -

  bucket 键的组成部分。每一项都包含 field_name、field_id 和 value。

• count (int) -

  分配到该 bucket 的通过 ANN 检索到的 Entity 数量。

• metrics (dict[str, Any]) -

  以 SearchAggregation.metrics 中定义的别名为键的指标值。

• hits (list[AggregationHit]) -

  由 TopHits 选择的代表性 Entity。当此级别未配置 top_hits 时，该列表为空。

• sub_groups (list[AggregationBucket]) -

  由 sub_aggregation 生成的嵌套 bucket。在叶子级别，该列表为空。

返回的 Collection 类型属性都是副本，因此更改返回的列表或字典不会修改 bucket 对象。

示例

python

result = client.search(
    collection_name="products",
    data=[query_vector],
    anns_field="embedding",
    search_aggregation=aggregation,
)

for bucket in result.agg_buckets[0]:
    print(bucket.key, bucket.count, bucket.metrics)
    for hit in bucket.hits:
        print(hit.pk, hit.score, hit.fields)