文档中心

向量数据库VikingDB

请输入

检索过滤能力

后置处理算子

后置处理算子是 VikingDB 提供的一种检索后处理能力，用于在向量召回之后，对候选数据进行进一步的过滤和优化，确保最终返回的搜索结果更加精准、高效。
在 VikingDB 中，后置处理算子可用于：

结果精准筛选：基于业务需求通过正则匹配设定筛选规则，如筛选包含某种特征文字信息的商品，确保用户获得有效的检索结果。
数据质量提升：使用正则匹配对检索结果进行格式校验，过滤包含特殊字符、非法内容或广告信息的数据，确保返回内容符合标准，提高数据规范性。
检索结果均衡：对特定字段设置出现频率限制，防止某些值占据过多搜索结果，如热门品牌、热门作者或特定分类过度曝光，保证检索结果的多样性和公平性。

后置处理算子是通用检索能力，您可以将其应用在基本向量检索、稠密稀疏混合检索中。

参数说明

参数	类型	是否必选	默认值	参数说明
post_process_ops	list	否		后置处理算子列表。在向量或标量召回阶段后，对候选数据进行进一步过滤处理，如字符串匹配、频控等。每个算子为一个map，串行执行。默认为空。详见下文后置处理算子。
post_process_input_limit	int	否	1000	当设置了 post_process_ops 时，进入后置处理阶段的候选数量。必须大于 0，实际候选数不超过 `min(10000, limit × 10)`。

后置处理算子

算子	说明	示例
string_match	正则匹配算子。仅限string类型字段使用。正则匹配规则请参考：Syntax	`JSON <br> { <br> "op": "string_match", <br> "field": "name", <br> "pattern": "^[0-9A-Za-z_]+$" <br> } <br>`
string_contain	关键词匹配算子。仅限string类型字段使用。表示该字段内容包含pattern。	`JSON <br> { <br> "op": "string_contain", <br> "field": "name", <br> "pattern": "bar" <br> } <br>`
enum_freq_limiter	频控算子。仅限string类型字段使用。用于保证一次召回的结果中, 一个特定取值出现的总数不超过 `threshold` 次。	`JSON <br> { <br> "op": "enum_freq_limiter", <br> "field": "city", <br> "threshold": 5 <br> } <br>`

示例

# 获取指定索引，程序初始化时调用即可，无需重复调用
index = vikingdb_service.get_index("example_text", "example_index_text")

datas = index.search(order=None, limit=5, post_process_input_limit=5,
                         post_process_ops=[
                             {'op': 'string_like', 'field':'f_string', 'pattern':'%doc9%'},
                             {'op': 'enum_freq_limiter', 'field':'f_string', 'threshold': 1}
                         ])
for data in datas:
        print(data.id, data.fields, data.score)

参数说明补充

算子字段

字段	类型	必填	含义
`op`	string	是	算子名称。
`field`	string	是	参与后处理的字段名。
`pattern`	string	字符串匹配算子必填	匹配模式或待匹配文本。
`threshold`	number	阈值类算子必填	过滤或截断阈值。

示例修正

已将 enum_freq_limiter 示例修正为合法 JSON："field": "city", 后再书写下一字段。

使用说明修正

string_like 是支持的字符串后处理算子，适用于 string/text 字段；pattern 为必填字符串，% 匹配任意长度字符，_ 匹配单个字符。

最近更新时间：2026.09.08 15:30:03

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

后置处理算子 #

参数说明补充 #

算子字段 #

示例修正 #

使用说明修正 #

后置处理算子

参数说明补充

算子字段

示例修正

使用说明修正