你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用模糊搜索来更正拼写错误

项目
10/31/2024

Azure AI 搜索支持模糊搜索 - 这是可以纠正输入字符串中的拼写错误和拼错的字词的一种查询。模糊搜索会扫描具有类似构成的字词。扩展搜索以包括近似匹配项，在差异只体现在几个字符放错了位置的情况下，这样做会自动更正拼写错误。

什么是模糊搜索？

模糊搜索是一种查询扩展措施，可以生成具有类似构成的字词匹配项。指定模糊搜索后，搜索引擎将为查询中的所有完整字词生成具有类似构成的字词的图（基于确定有限状态自动机理论）。例如，如果查询包含三个字词："university of washington"，则会为查询 search=university~ of~ washington~ 中的每个字词创建一张图（模糊搜索中不会删除非索引字，因此 "of" 也会获得一张图）。

图中最多包含每个字词的 50 个扩展（或排列），在过程中捕获正确和错误的变体。然后，引擎在响应中返回最相关的匹配项。

对于“university”这样的字词，该图可能包含 "unversty, universty, university, universe, inverse"。与图中的字词匹配的任何文档会包含在结果中。与对文本进行分析来处理同一单词的不同形式（“mice”和“mouse”）的其他查询不同，模糊查询中的比较是针对表面值进行的，不会对文本进行任何语言分析。语义不同的“universe”和“inverse”相互匹配，因为两者的句法差异很小。

如果差异限制为两个或更少的编辑（其中的编辑是指插入、删除、替换或转换的字符），则匹配成功。指定差异的字符串更正算法为 Damerau-Levenshtein 距离指标。它被描述为“将一个单词更改为另一个单词所需的最少操作次数（插入、删除、替换或调换两个相邻字符）”。

在 Azure AI 搜索中：

模糊查询适用于整个术语。不直接支持短语，但你可以通过 AND 构造对一个包含多个部分的短语的每个术语指定模糊匹配。例如，search=dr~ AND cleanin~。此查询表达式查找“干洗”的匹配项。
默认的编辑距离为 2。值 ~0 表示无扩展（仅将完全相同的字词视为匹配项），但你可以指定 ~1 表示一个差异程度或一个编辑。
模糊查询可将一个字词扩展到最多 50 个排列。此限制不可配置，但通过将编辑距离减至 1 可以有效减少扩展数目。
响应由包含相关匹配项的文档（最多 50 个）组成。

在处理查询期间，模糊查询不会进行词法分析。查询输入会直接添加到查询树中，并进行扩展以创建字词图。执行的唯一变换是将字词小写。

图是作为针对索引中的标记的匹配条件统一提交的。可以想象得出，模糊搜索的速度固有地比其他查询形式要慢。索引的大小和复杂性可以决定带来的优势是否足以抵消响应的延迟。

注意

由于模糊搜索的速度往往较慢，因此，可能有必要探索 n 元语法索引等采用短字符序列（由两到三个字符组成的双元和三元标记序列）的替代方案。 n 元语法可能会提高性能，具体取决于所用的语言和查询面。弊端是 n 元语法索引非常耗费存储，且生成的索引要大得多。

如果你只是想要处理最极端的情况，另一种替代方案是使用同义词映射。例如，将“search”映射到“serach, serch, sarch”，或者将“retrieve”映射到“retreive”。

模糊搜索的索引编制

属性为“可搜索”的字符串字段是模糊搜索的候选项。

不会使用分析器来创建扩展图，但这并不意味着在模糊搜索方案中应该忽略分析器。分析器对于索引过程中的词汇切分非常重要，其中倒排索引中的令牌用于匹配图形。

与往常一样，如果测试查询未生成预期的匹配项，请试验不同的索引分析器。例如，尝试使用语言分析器，看看是否获得更好的结果。某些语言（尤其是存在元音变化的语言）可以受益于 Microsoft 自然语言处理器生成的音调变化和不规则单词形式。在某些情况下，使用正确的语言分析器可能关系到术语是否能够以与用户提供的值兼容的方式进行标记化。

如何调用模糊搜索

模糊查询是使用完整的 Lucene 查询语法构造的，调用完整的 Lucene 查询分析器，并在用户输入的每个完整字词追加一个波形字符 ~。

下面是调用模糊搜索的查询请求示例。它包括四个字词，其中两个存在拼写错误：

POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-07-01
{
    "search": "seatle~ waterfront~ view~ hotle~",
    "queryType": "full",
    "searchMode": "any",
    "searchFields": "HotelName, Description",
    "select": "HotelName, Description, Address/City,",
    "count": "true"
}

将查询类型设置为完整的 Lucene 语法 (queryType=full)。
提供查询字符串，每个完整字词的末尾后添加一个波形 (~) 运算符 (search=<string>~)。会为查询输入中的每个字词创建一个扩展图。

若要指定编辑距离，请包含一个可选参数，其值介于 0 和 2（默认值）之间 (~1)。例如“blue~”或“blue~1”会返回“blue”、“blues”和“glue”。

（可选）可以通过将请求范围限定为特定字段来提高查询性能。使用 searchFields 参数指定要搜索的字段。还可以使用 select 属性指定查询响应中返回的字段。

测试模糊搜索

要进行简单测试，我们建议使用搜索浏览器或 REST 客户端来循环访问查询表达式。这两个工具都是交互式的，这意味着，可以快速分步测试某个字词的多个变体，并评估返回的响应。

当结果模糊时，命中项突出显示可以帮助你识别响应中的匹配项。

注意

使用命中项突出显示识别模糊匹配项存在局限性，仅适用于基本的模糊搜索。如果索引具有评分配置文件，或者使用附加语法将查询分层，则命中项突出显示可能无法识别匹配项。

示例 1：对完全匹配的字词进行模糊搜索

假设某个搜索文档的 "Description" 字段中存在以下字符串："Test queries with special characters, plus strings for MSFT, SQL and Java."

首先对“special”执行模糊搜索，并向 Description 字段添加命中项突出显示：

search=special~&highlight=Description

在响应中，由于添加了命中项突出显示，因此格式设置将应用于作为匹配字词的“special”。

"@search.highlights": {
    "Description": [
        "Test queries with <em>special</em> characters, plus strings for MSFT, SQL and Java."
    ]
}

删掉“special”中的几个字母 ("pe") 以将其误拼，然后再次尝试该请求：

search=scial~&highlight=Description

到目前为止，响应没有任何变化。使用默认的 2 度距离时，从 "pe" 中移除两个字符“pe”后，仍可成功匹配该字词。

"@search.highlights": {
    "Description": [
        "Test queries with <em>special</em> characters, plus strings for MSFT, SQL and Java."
    ]
}

再尝试一次请求，这次请如下所述进一步修改搜索字词：删除最后一个字符，也就是总共删除三个字符（使“special”变成 "scal"）：

search=scal~&highlight=Description

可以看到，返回了相同的响应，但匹配不是针对“special”进行的，而是针对“SQL”进行了模糊匹配。

"@search.score": 0.4232868,
"@search.highlights": {
    "Description": [
        "Mix of special characters, plus strings for MSFT, <em>SQL</em>, 2019, Linux, Java."
    ]
}

此扩展示例的要点是演示命中项突出显示可为模糊结果带来的明确性。在所有情况下，都将返回同一文档。如果你依赖于文档 ID 来验证匹配，则可能会漏掉从“special”到“SQL”的变动。

通过