使用pymilvus 2.4.4进行Milvus Lite数组字段高级过滤时遇Invalid expr错误

问题场景 #

使用pymilvus 2.4.4版本，执行数组字段高级过滤代码时触发以下错误：

MilvusException: <MilvusException: (code=1100, message=Invalid expr: ARRAY_CONTAINS_ANY(color_coord, [7, 8, 9]): invalid parameter)>

原查询代码片段：

collection_name="test_collection",
filter="ARRAY_CONTAINS_ANY(color_coord, [7, 8, 9])",
output_fields=["id", "color", "color_tag", "color_coord"],
limit=3
)

解决方案 #

1. 修正过滤表达式的参数格式 #

在pymilvus 2.4.4中，ARRAY_CONTAINS_ANY的目标值集合需要用**大括号{}**包裹，而非原代码中的方括号[]。修正后的过滤表达式为：

filter="ARRAY_CONTAINS_ANY(color_coord, {7, 8, 9})"

2. 验证字段定义与数据类型 #

• 确保color_coord字段在集合创建时被定义为数组类型，示例定义如下：

  from pymilvus import FieldSchema, CollectionSchema, DataType
  
  field = FieldSchema(
      name="color_coord",
      dtype=DataType.ARRAY,
      element_type=DataType.INT64,
      max_capacity=10
  )
  

• 确认插入数据中color_coord的元素类型与过滤值类型完全匹配（比如均为int64，不能混合字符串或其他类型）。

3. 检查客户端与服务端版本一致性 #

确保Milvus服务端版本与pymilvus客户端版本均为2.4.4，版本不匹配可能导致函数语法兼容性问题。

完整可执行查询代码 #

from pymilvus import Collection

# 初始化集合
collection = Collection("test_collection")

# 执行查询
results = collection.query(
    collection_name="test_collection",
    filter="ARRAY_CONTAINS_ANY(color_coord, {7, 8, 9})",
    output_fields=["id", "color", "color_tag", "color_coord"],
    limit=3
)

# 打印结果
print(results)

内容的提问来源于stack exchange，提问作者rachel song