在 PyMilvus 中，若需查询 JSON 字段中某个数组是否包含指定元素（如 ["A", "B", "C"] 是否含 "A"），应使用 json_contains_any() 而非 json_contains()，后者仅支持整体值匹配，无法对数组内单个元素生效。
在 pymilvus 中，若需查询 json 字段中某个数组是否包含指定元素（如 `["a", "b", "c"]` 是否含 `"a"`），应使用 `json_contains_any()` 而非 `json_contains()`，后者仅支持整体值匹配，无法对数组内单个元素生效。
当使用 Milvus 2.2+ 的 JSON 字段（如 metadata）存储嵌套结构时，常见误区是误用 json_contains 进行数组元素检索。例如，给定如下数据：
{"field_a": "x", "list_field": ["A", "B", "C"]}
若执行以下查询：
self.collection.query(
expr='json_contains(metadata["list_field"], "A")',
output_fields=['metadata']
)
将抛出 Milvus 错误——因为 json_contains 仅判断 JSON 值是否完全等于目标字符串（即要求 metadata["list_field"] == "A"），而实际字段值是一个数组，类型与值均不匹配。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
✅ 正确做法是使用 json_contains_any，它专为“数组/列表中是否存在任意一个匹配元素”设计：
self.collection.query(
expr='json_contains_any(metadata["list_field"], ["A"])',
output_fields=['metadata', 'vector'] # 可按需添加向量或其他字段
)
⚠️ 注意事项：
- json_contains_any 的第二个参数必须是 JSON 数组字面量（如 ["A"], ["A", "B"]），不可传入 Python 列表对象；字符串需严格遵循 JSON 格式（双引号、无尾逗号）；
- 若需匹配多个候选值（如 "A" 或 "C"），可写为 json_contains_any(metadata["list_field"], ["A", "C"])；
- 确保 metadata 字段在建表时已正确定义为 DataType.JSON 类型，且对应索引（如 JSON 类型字段无需额外索引即可用于过滤，但复杂路径建议结合 auto_id=False 和合理 schema 设计）；
- PyMilvus 2.2.13 已完整支持该语法，无需升级客户端，但服务端需为 Milvus 2.2.0+。
? 小结：json_contains → 全值匹配（适合查整个 JSON 对象或字符串）；json_contains_any → 成员存在性检查（适合查数组元素）。善用二者语义差异，是高效操作 JSON 字段的关键。
