Azure Cognitive Search：如何基于权限过滤自动补全建议？

针对你遇到的自动补全权限过滤需求，这里有两种可行的解决办法：

方案一：将权限字段改为集合类型（推荐） #

Azure Cognitive Search的OData过滤对集合类型（Collection(Edm.String)）支持更友好，你可以修改索引定义，把permissions/readitem的字段类型从Edm.String改成Collection(Edm.String)，然后重新导入数据时，把原来分号分隔的字符串拆分成数组格式，比如：

"permissions": {
    "readitem": ["test1@test.com", "test2@test.com", "test3@test.com"],
    "readlist": ["test1@test.com", "test2@test.com", "test3@test.com"]
}

之后就可以用any操作符编写过滤条件，精准匹配用户邮箱：

SuggestOptions sp = new SuggestOptions()
{
    UseFuzzyMatching = query.Fuzzy,
    Size = 10,
    Filter = "permissions/readitem/any(p: p eq 'test1@test.com')"
};

这种方式性能更优，也能避免字符串匹配带来的误判问题，是长期维护的最佳选择。

方案二：利用字符串包含进行精确匹配（无需修改索引） #

如果暂时无法修改索引结构，可以利用权限字符串的;;包裹格式，构造精确的包含过滤条件，避免部分邮箱的误匹配（比如区分test1@test.com和test11@test.com）：

var userEmail = "test1@test.com";
// 用;;包裹邮箱，确保匹配完整的权限条目
var filter = $"contains(permissions/readitem, ';;{userEmail};;')";

SuggestOptions sp = new SuggestOptions()
{
    UseFuzzyMatching = query.Fuzzy,
    Size = 10,
    Filter = filter
};

注意：如果你的权限字符串首尾可能没有分号（比如开头是test1@test.com;;或者结尾是;;test3@test.com），需要额外处理首尾的情况，比如同时判断startswith(permissions/readitem, '{userEmail};;')或者endswith(permissions/readitem, ';;{userEmail}')，再用or组合起来，确保所有场景都能匹配到。

内容的提问来源于stack exchange，提问作者M.bo.yazan