Azure Cognitive Search拼写检查器C#实现方案咨询

由于Azure Cognitive Search的.NET SDK中SearchParameters类并未直接封装拼写检查相关的speller和queryLanguage参数，你可以通过AdditionalParameters字典来传递这些自定义查询参数，以下是具体实现方案：

步骤1：确保安装正确的NuGet包 #

使用Azure.Search.Documents包（推荐使用最新稳定版），可通过NuGet包管理器或命令行安装：

Install-Package Azure.Search.Documents

步骤2：修改搜索代码，添加拼写检查参数 #

基于你已有的基础实现，修改SearchParameters的配置，通过AdditionalParameters注入拼写检查参数：

using Azure.Search.Documents;
using Azure.Search.Documents.Models;

// 初始化SearchClient（替换为你的服务信息）
SearchClient searchClient = new SearchClient(
    new Uri("https://<你的搜索服务名称>.search.windows.net"),
    "<你的索引名称>",
    new AzureKeyCredential("<你的管理员密钥>")
);

// 构建搜索参数，包含拼写检查配置
SearchParameters searchParams = new SearchParameters
{
    // 保留你的原有配置，例如返回字段、筛选条件等
    Select = new[] { "id", "title", "content" },
    // 添加拼写检查相关的自定义参数
    AdditionalParameters = new Dictionary<string, object>
    {
        { "speller", "lexicon" },
        { "queryLanguage", "en-us" }
    }
};

// 执行搜索（示例使用错误拼写的查询词）
string rawQuery = "exmaple search query";
Response<SearchResults<YourDocumentModel>> searchResponse = await searchClient.SearchAsync<YourDocumentModel>(rawQuery, searchParams);

// 获取并输出拼写修正结果
if (searchResponse.Value.QueryContext?.AlteredQuery != null)
{
    Console.WriteLine($"原始查询: {rawQuery}");
    Console.WriteLine($"拼写修正后查询: {searchResponse.Value.QueryContext.AlteredQuery}");
}

// 遍历处理搜索结果
await foreach (SearchResult<YourDocumentModel> result in searchResponse.Value.GetResultsAsync())
{
    Console.WriteLine($"文档ID: {result.Document.id}, 标题: {result.Document.title}");
}

关键说明 #

• AdditionalParameters是SDK提供的扩展入口，用于传递所有未被封装的REST API查询参数，完全符合Azure Cognitive Search的API规范
• QueryContext.AlteredQuery会返回拼写修正后的查询字符串；若原始查询无拼写错误，该值为null
• queryLanguage参数需与你的索引内容语言匹配，例如中文内容可使用zh-cn，英文内容使用en-us
• 拼写检查功能无需预先配置索引，仅需在查询时传递对应参数即可生效

内容的提问来源于stack exchange，提问作者Rahul - Systematix