resource_id

str

二选一

Collection 的资源 ID。

collection_name

str

Collection 名称。

index_name

str

是

索引名称。

output_fields

Optional[List[str]]

否

要返回的标量字段列表。

1. 未设置时返回集合内所有标量字段。
2. 传入空列表表示不返回任何标量字段。
3. 字段名必须存在于 collection schema，否则请求报错。

filter

Optional[Dict[str, Any]]

否

标量过滤条件，格式见下文，默认不设置。

limit

Optional[int]

否

返回结果上限，默认 10，最大值 100000。

offset

Optional[int]

否

分页偏移量，默认 0，过大时会触发深分页性能损耗。

advance（SearchAdvance）

Optional[SearchAdvance]

否

dense_weight

Optional[float]

混合向量场景下 dense / sparse 权重，默认 0.5，范围 [0.2, 1]。

ids_in

Optional[List[Any]]

仅在该主键集合范围内检索。

ids_not_in

Optional[List[Any]]

排除指定主键列表。

post_process_ops

Optional[List[Dict[str, Any]]]

后置处理算子列表，串行执行，详见《检索后处理算子-PostProcess》。

post_process_input_limit

Optional[int]

进入后处理阶段的候选条数。

scale_k

Optional[float]

分配给后续 rerank 的候选倍率。

filter_pre_ann_limit

Optional[int]

先执行标量过滤时的最大候选条数。

filter_pre_ann_ratio

Optional[float]

先执行标量过滤时的候选比例。

must

string、int64、bool、list、list

针对指定字段名生效，语义为必须在 [...] 之中，即 "must in"

{
  "op": "must",
  "field": "region",
  "conds": ["cn", "sg"]
}

must_not

string、int64、bool、list、list

针对指定字段名生效，语义为必须不在 [...] 之中，即 "must not in"

{
          "op": "must_not",
          "field": "data_type",
          "conds": [1,2,3]
}

and

/

逻辑算子，针对逻辑查询需求，对多个条件取交集

{
  "op": "and",         // 算子名
  "conds": [           // 条件列表，支持嵌套逻辑算子和 must/must_not 算子
    {
      "op": "must",
      "field": "type",
      "conds": [1]
    },
    {
        ...            // 支持>=1的任意数量的条件进行组合
    }
  ]
}

or

/

逻辑算子，针对逻辑查询需求，对多个条件取并集

{
  "op": "or",         // 算子名
  "conds": [           // 条件列表，支持嵌套逻辑算子和 must/must_not 算子
    {
      "op": "must",
      "field": "type",
      "conds": [1]
    },
    {
        ...            // 支持>=1的任意数量的条件进行组合
    }
  ]
}

range

int64、float32

针对指定字段名生效，语义为必须在指定范围内。配置使用gte（大于等于）, gt（大于）, lte（小于等于）, lt（小于），用以圈定一维范围。

// price在[100.0, 500.0)
{
  "op": "range",
  "field": "price",
  "gte": 100.0,
  "lt": 500.0
}

//price >= 100.0
{
  "op": "range",
  "field": "price",
  "gte": 100.0
}

time_range

date_time

时间点筛选，配置使用gte（大于等于）, gt（大于）, lte（小于等于）, lt（小于），用以圈定一维范围。

{
    // 检索北京时间 2025-08-12 00:00:00 ~ 2025-08-13 00:00:00 之间的数据
    "op": "time_range",
    "field": "f_date_time",
    "gt": "2025-08-12T00:00:00+08:00",
    "lt": "2025-08-13T00:00:00+08:00",
}

geo_range

geo_point

地理距离筛选，使用 center为中心点，radius为距离半径。

{
    "op": "geo_range",
    "field": "f_geo_point",
    "center": "116.412138,39.914912",
    "radius": "10000m"
}

string_contain

string

关键词匹配过滤算子。表示该字段内容包含pattern。

{
   "op": "string_contain",
   "field": "name",
   "pattern": "bar"
}

string_match

string

正则匹配过滤算子。

{
   "op": "string_match",
   "field": "name",
   "pattern": "^[0-9A-Za-z_]+$"
}

enum_freq_limiter

string

频控算子。用于保证一次召回的结果中, 一个特定取值出现的总数不超过 threshold 次。

{
  "op": "enum_freq_limiter",
  "field": "city"
  "threshold": 5
}