asp.net core集成ElasticSearch+实现全文检索功能

战族狼魂

已于 2024-07-15 22:35:57 修改

阅读量1k

点赞数 22

分类专栏： Elasticsearch 全文检索 asp.net 文章标签：全文检索 elasticsearch 大数据

于 2024-07-15 22:33:53 首次发布

本文链接：https://blog.csdn.net/nndsb/article/details/140450869

版权

asp.net 同时被 3 个专栏收录

8 篇文章 0 订阅

订阅专栏

Elasticsearch

1 篇文章 0 订阅

订阅专栏

全文检索

1 篇文章 0 订阅

订阅专栏

ASP.NET Core中集成Elasticsearch以实现全文检索功能通常涉及几个关键步骤：

三、在ASP.NET Core项目中安装NEST库

四、配置Elasticsearch连接

五.、索引数据

六、实现全文检索

七、在你的ASP.NET Core应用程序中使用全文检索

一. 安装Elasticsearch

1. 准备环境

确保你的电脑已安装JDK 1.8或更高版本，因为Elasticsearch基于Java开发。

2. 下载Elasticsearch

访问Elastic官网（https://www.elastic.co/cn/）

在官网上找到适合你操作系统的Elasticsearch版本，并下载Windows安装包。请注意，你需要选择与你的JDK版本兼容的Elasticsearch版本。

3. 解压安装包

下载完成后，将压缩包解压到你选择的目录。

4. 运行Elasticsearch

进入解压后的目录，找到bin文件夹下的elasticsearch.bat文件。

双击运行elasticsearch.bat文件启动Elasticsearch。

5. 验证安装

打开浏览器，输入localhost:9200。如果看到JSON格式的响应信息，说明Elasticsearch已成功安装并运行。

6. 常见问题及解决方案

浏览器无法得到返回的结果：

修改config/elasticsearch.yml文件，设置xpack.security.enabled: false和xpack.security.enrollment.enabled: false，然后重启Elasticsearch。

运行点击elasticsearch.bat页面闪退：

通过cmd命令进入Elasticsearch的bin目录，执行elasticsearch.bat，查看运行报错信息，并根据报错信息进行相应修改。

7. 安装为Windows服务（可选）

如果你希望Elasticsearch在Windows启动时自动运行，可以将它安装为Windows服务。具体的安装步骤可能会因Elasticsearch版本而异，你可以查阅官方文档或相关教程来获取详细指导。

二、创建Elasticsearch索引

在Elasticsearch中，你需要创建一个或多个索引来存储你的数据。索引是Elasticsearch中用于存储文档的容器。你可以使用Elasticsearch的REST API、官方客户端库（如NEST）或Kibana等工具来创建和管理索引。

1. 选择并连接REST客户端

使用一个REST客户端，如Kibana或Postman，以便与Elasticsearch进行交互。

打开REST客户端并连接到Elasticsearch服务器。

如果使用Kibana，则不需要手动连接，因为Kibana和Elasticsearch是一体化的。

2. 指定索引名称和参数

在REST客户端中，使用PUT方法指定索引名称和参数。

例如，如果要创建一个名为“my_index”的索引，

可以使用类似以下的URL：PUT /my_index

3. 定义索引映射
在请求体中，指定索引的映射。索引映射定义了索引中包含的字段及其属性。

例如，定义一个包含两个字段（field_1和field_2）的索引，其中field_1是文本字段，field_2是关键词字段：
{
  "mappings": {
    "properties": {
      "field_1": {
        "type": "text"
      },
      "field_2": {
        "type": "keyword"
      }
    }
  }
}
4. 发送PUT请求创建索引

使用REST客户端向Elasticsearch服务器发送包含上述映射的PUT请求。

如果一切顺利，Elasticsearch服务器会响应一个JSON格式的确认消息。

5. 在Kibana中创建索引（可选）

如果你使用的是Kibana，可以直接在Kibana的DevTools界面中执行上述步骤来创建索引。

在Kibana中，你不需要手动连接到Elasticsearch服务器，因为它们是集成的。

6. 注意事项

确保在创建索引之前，已经连接到正确的Elasticsearch集群（如果有多个集群）。

索引名称应该是唯一的，并且满足Elasticsearch的命名规范。

索引映射定义了索引的结构和字段类型，它对于索引的性能和查询效率有重要影响。因此，在定义映射时，应该仔细考虑字段的类型和属性。

7. 其他操作

除了创建索引外，Elasticsearch还支持索引的删除、更新、读写权限管理、别名配置等操作。这些操作都可以通过类似的REST API接口进行。

三、在ASP.NET Core项目中安装NEST库

NEST是Elasticsearch的.NET客户端库，它提供了与Elasticsearch交互的便捷方式。你可以使用NuGet包管理器在你的ASP.NET Core项目中安装NEST库。

在Visual Studio中，右键点击你的项目 -> 选择“管理NuGet程序包” -> 搜索“NEST” -> 点击“安装”。

四、配置Elasticsearch连接

在ASP.NET Core项目中，你需要配置与Elasticsearch的连接，默认端口9200。这通常是在Startup.cs文件的ConfigureServices方法中完成的。你可以使用依赖注入来注册一个ElasticClient实例，并配置其连接设置。

以下是一个示例配置：

public void ConfigureServices(IServiceCollection services)
{
    // ... 其他服务配置 ...

    var settings = new ConnectionSettings(new Uri("http://localhost:9200"))
        .DefaultIndex("your-index-name"); // 设置默认索引名

    services.AddSingleton(settings);
    services.AddSingleton(new ElasticClient(settings));
}

五.、索引数据

现在，你可以使用ElasticClient实例将数据索引到Elasticsearch中。你可以将你的数据转换为Elasticsearch可以理解的JSON格式，并使用NEST的API来索引它。

以下是一个示例，展示如何使用ElasticClient来索引一个简单的文档：

public async Task IndexDocumentAsync(ElasticClient client, YourDocumentType document)
{
    var indexResponse = await client.IndexDocumentAsync(document);

    if (!indexResponse.IsValid)
    {
        // 处理错误
    }
}

六、实现全文检索

一旦你的数据被索引到Elasticsearch中，你就可以使用全文检索功能来搜索它。你可以使用Elasticsearch的查询DSL（Domain Specific Language）来构建复杂的查询，并使用NEST的API来执行它们。

以下是一个示例，展示如何使用ElasticClient来执行一个简单的全文搜索：

public async Task<ISearchResponse<YourDocumentType>> SearchDocumentsAsync(ElasticClient client, string searchTerm)
{
    var searchResponse = await client.SearchAsync<YourDocumentType>(s => s
        .Query(q => q
            .Match(m => m
                .Field(f => f.YourFieldName) // 指定要搜索的字段名
                .Query(searchTerm) // 指定搜索词
            )
        )
    );

    return searchResponse;
}