Elasticsearch 下载安装及使用总结

官网文档地点：Elasticsearch Guide [8.13]
官网下载地点：Download Elasticsearch
1. 下载安装

1、下载对应体系的版本
这里下载的 Elasticsearch 版本为 8.13.2，Elasticsearch 依赖 Java，因此要先在服务器上安装 JDK，不过高版本的 Elasticsearch 已经内置了 JDK

2、上传到服务器上，解压

1. tar -xzf elasticsearch-8.13.2-linux-x86_64.tar.gz

复制代码

3、创建新用户
Elasticsearch 不能在 root 用户下启动，因此需要创建一个新用户或者使用其他非 root 用户来启动，将 Elasticsearch 实行目录的所属更改为该用户

1. groupadd es && useradd es -g es
2. chown -R es:es elasticsearch-8.13.2

复制代码

4、修改内存巨细
默认分配的内存巨细为 4G，服务器内存不敷可以手动调整分配内存巨细，修改 /config/jvm.options 文件

5、修改 /config/elasticsearch.yml 设置文件
   

• cluster.name：集群名称，集群下全部节点保持一致
  
• node.name：节点名称
  
• path.data：数据目录，一样平常可默认，在实行目录下
  
• path.logs：日志目录，一样平常可默认，在实行目录下
  
• network.host：服务器地点，有几个特殊的预设值，详细可见 Networking | Elasticsearch Guide [8.13]，默认为 192.168.0.1
  
• http.port：端口，默认 9200
  
• discovery.seed_hosts：服务发现种子主机，用于设置集群中其他节点
  
• cluster.initial_master_nodes：初始主节点
  

  6、修改最大内存限制，修改 /etc/sysctl.conf 文件，这里的值为 Elasticsearch 要求的最小值

1. vm.max_map_count = 262144

复制代码

加载设置

1. sysctl -p

复制代码

7、使用非 root 用户启动 Elasticsearch，-d 表现背景启动

1. ./bin/elasticsearch -d

复制代码

一样平常默认会开启安全设置，会自动生成证书文件并在设置文件里自动添加相关设置

8、测试，访问 https://ip:9200，输入用户名密码，在启动时会输出到控制台或者去日志文件检察

1. Password for the elastic user (reset with `bin/elasticsearch-reset-password -u elastic`):
2.   r3m5YCt8V=OyGourmPYv

复制代码

或者直接实行 bin/elasticsearch-reset-password -u elastic 生成一个新密码，获取到如下信息即表现乐成

上面默认开启了 ssl，也就是 https 访问，在使用 Java 毗连时默认会去验证证书相关，可以将 xpack.security.http.ssl.enable 设置为 false，使用 http 访问
2. 使用

需要带上用户名密码

1、直接检察服务状态

1. GET https://ip:9200

复制代码

2、测试分词

1. POST https://ip:9200/_analyze

复制代码

  

• tokenizer：选择使用的分词器
  
• char_filter：过滤
  
• text：需要分词的文本
  

  

内置分词器
分词器描述分词对象结果standard标准分析器是默认的分析器，假如没有指定，则使用该分析器。它提供了基于文法的标记化(基于 Unicode 文本分割算法，如 Unicode 标准附件 # 29 所规定) ，并且对大多数语言都有用。The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.[ the, 2, quick, brown, foxes, jumped, over, the, lazy, dog’s, bone ]simple简单分析器将文本分解为任何非字母字符的标记，如数字、空格、连字符和撇号、放弃非字母字符，并将大写字母更改为小写字母。The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.[ the, quick, brown, foxes, jumped, over, the, lazy, dog, s, bone ]whitespace空格分析器在碰到空白字符时将文本分解为术语The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.[ The, 2, QUICK, Brown-Foxes, jumped, over, the, lazy, dog’s, bone. ]stop停止分析器与简单分析器相同，但增长了删除停止字的支持。默认使用的是_english_ 停止词。The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.[ quick, brown, foxes, jumped, over, lazy, dog, s, bone ]keyword不分词，把整个字段当做一个整体返回The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.[The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.]pattern模式分析器使用正则表达式将文本拆分为术语。正则表达式应该匹配令牌分隔符，而不是令牌本身。正则表达式默认为w+ (或全部非单词字符)。The 2 QUICK Brown-Foxes jumped over the lazy dog’s bone.[ the, 2, quick, brown, foxes, jumped, over, the, lazy, dog, s, bone ] 扩展，中文分词器
分词器描述分词对象结果ik_smartik 分词器中的简单分词器，支持自界说字典，远程字典学如逆水行舟，不进则退[学如逆水行舟,不进则退]ik_max_wordik_分词器的全量分词器，支持自界说字典，远程字典学如逆水行舟，不进则退[学如逆水行舟,学如逆水,逆水行舟,逆水,行舟,不进则退,不进,则,退] 下载地点：Releases · infinilabs/analysis-ik (github.com)
上传到服务器上 /plugins/ik 目录下，解压

1. unzip elasticsearch-analysis-ik-8.12.2.zip

复制代码

注意要设置 ik 分词器的 Elasticsearch 版本，修改 /plugins/ik/plugin-descriptor.properties 文件，然后重启服务

1.2.1 索引

相当于数据库表
1、创建索引，indexs 为对应的索引名称

1. POST https://ip:9200/indexs

复制代码

重复创建的话会报错

创建索引时可以指定 mapping，给字段设置类型和分词器等

2、查询索引，indexs 为对应的索引名称

1. GET https://ip:9200
2. /indexs

复制代码

这里没有 mapping，在文档写入 Elasticsearch 时，会根据文档字段自动辨认类型，这种机制称之为动态映射

3、删除索引，indexs 为对应的索引名称

1. DELETE https://ip:9200/indexs

复制代码

1.2.2 文档

1、添加文档，indexs 为对应的索引名称

1. POST https://ip:9200/indexs
2. /_doc         # 使用体系生成idPOST https://ip:9200/indexs
3. /_create/1    # 使用指定idPOST https://ip:9200/indexs
4. /_doc/1       # 使用指定id，不存在创建，存在更新

复制代码

再检察索引可以发现已经有了 mapping

2、查询文档，indexs 为对应的索引名称

1. GET https://ip:9200
2. /indexs/_doc/1  # 查询单个文档GET http://ip:9200/indexs/_search  # 查询全部文档

复制代码

条件查询

1. GET http://ip:9200/indexs/_search?q=content:test   # q=查询属性名:查询属性值

复制代码

3、删除文档，indexs 为对应的索引名称

1. DELETE http://ip:9200/indexs/_doc/1

复制代码

4、修改文档，indexs 为对应的索引名称
全量更新，相当于删除了原来的文档然后重新添加

1. PUT http://ip:9200/indexs/_doc/1

复制代码

部门更新，不对原始文档进行更新，而是对原始文档对象中的 doc 属性中的指定属性更新

1. POST http://ip:9200/indexs/_update/1

复制代码

3. 整合 Java

有以下几种通过 Java 操作 Elasticsearch 的方式

• ElasticsearchRepository：雷同 MyBatis-Plus 的操作
  
• ElasticsearchTemplate/ElasticSearchRestTemplate：雷同 Redistemplate 的操作
  
• RestHighLevelClient：Elasticsearch 官方提供的 Java 客户端，使用 DSL 的格式来操作，新版本已被弃用
  
• Elasticsearch Java API Client：替换 RestHighLevelClient
  

3.1 ElasticsearchRepository

3.1.1 引入依赖

1. <dependencies>
2.         <dependency>
3.             <groupId>org.springframework.boot</groupId>
4.             <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
5.         </dependency>
7.         <dependency>
8.             <groupId>org.springframework.boot</groupId>
9.             <artifactId>spring-boot-starter-web</artifactId>
10.         </dependency>
12.         <dependency>
13.             <groupId>org.projectlombok</groupId>
14.             <artifactId>lombok</artifactId>
15.         </dependency>
16. </dependencies>

复制代码

3.1.2 设置文件

设置 Elasticsearch 的服务器地点以及用户名密码

1. spring:
2.   elasticsearch:
3.     uris: http://127.0.0.1:9200
4.     username: elastic
5.     password: elastic

复制代码

3.1.3 文档实体类

1. import lombok.Data;
2. import org.springframework.data.annotation.Id;
3. import org.springframework.data.elasticsearch.annotations.Document;
5. @Data
6. @Document(indexName = "articles")
7. public class Article {
9.     @Id
10.     private String id;
12.     private String title;
14.     private String content;
15. }

复制代码

  

• @Document(indexName = "articles")：指定文档的索引名称
  
• @Id：指定该字段作为文档 ID
  

  3.1.4 数据访问层

继承 ElasticsearchRepository，它提供了一套标准的方法定名规范，符合规范的方法名在输入的时候就会有提示，好比 findByXxx(T xxx)，会自动为符合定名规范的方法生成对应的 DSL 语句

1. import fable.entity.Article;
2. import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
4. public interface ArticleRepository extends ElasticsearchRepository<Article, String> {
6.     Article findByContent(String content);
7. }

复制代码

3.1.5 Service

1. import fable.repository.ArticleRepository;
2. import fable.entity.Article;
3. import org.springframework.beans.factory.annotation.Autowired;
4. import org.springframework.stereotype.Service;
6. @Service
7. public class ArticleService {
9.     private final ArticleRepository articleRepository;
11.     @Autowired
12.     public ArticleService(ArticleRepository articleRepository) {
13.         this.articleRepository = articleRepository;
14.     }
16.     public Article findByContent() {
17.         return articleRepository.findByContent("test");
18.     }
20.     public void save() {
21.         Article article = new Article();
22.         article.setId("test");
23.         article.setTitle("test");
24.         article.setContent("test save");
25.         articleRepository.save(article);
26.     }
27. }

复制代码

3.1.6 Controller

1. import fable.entity.Article;
2. import fable.service.ArticleService;
3. import org.springframework.beans.factory.annotation.Autowired;
4. import org.springframework.web.bind.annotation.GetMapping;
5. import org.springframework.web.bind.annotation.RestController;
7. @RestController
8. public class ArticleController {
10.     private final ArticleService articleService;
12.     @Autowired
13.     public ArticleController(ArticleService articleService) {
14.         this.articleService = articleService;
15.     }
17.     @GetMapping("/findByContent")
18.     public Article findByContent() {
19.         return articleService.findByContent();
20.     }
22.     @GetMapping("/save")
23.     public void save() {
24.         articleService.save();
25.     }
26. }

复制代码

3.1.7 启动类

添加 @EnableElasticsearchRepositories 注解，设置包扫描

1. import org.springframework.boot.SpringApplication;
2. import org.springframework.boot.autoconfigure.SpringBootApplication;
3. import org.springframework.data.elasticsearch.repository.config.EnableElasticsearchRepositories;
5. @SpringBootApplication
6. @EnableElasticsearchRepositories(basePackages = "fable.repository")
7. public class FableApplication {
8.     public static void main(String[] args) {
9.         SpringApplication.run(FableApplication.class, args);
10.     }
11. }

复制代码

3.1.8 测试

访问 /save 接口，可以看到文档信息已经添加了进来

访问 /findByContent 接口，可以看到对应的文档信息

3.2 ElasticsearchTemplate/ElasticSearchRestTemplate

将 ElasticsearchTemplate/ElasticSearchRestTemplate 注入进来然后使用对应的方法即可，可自行相识

1. @Service
2. public class ArticleService {
4.     private final ArticleRepository articleRepository;
5.     private final ElasticsearchTemplate elasticsearchTemplate;
7.     @Autowired
8.     public ArticleService(ArticleRepository articleRepository, ElasticsearchTemplate elasticsearchTemplate) {
9.         this.articleRepository = articleRepository;
10.         this.elasticsearchTemplate = elasticsearchTemplate;
11.     }
12. }

复制代码

3.3 RestHighLevelClient

3.3.1 引入依赖

1. <dependencies>
2.         <dependency>
3.             <groupId>org.springframework.boot</groupId>
4.             <artifactId>spring-boot-starter-web</artifactId>
5.         </dependency>
7.         <dependency>
8.             <groupId>org.elasticsearch.client</groupId>
9.             <artifactId>elasticsearch-rest-high-level-client</artifactId>
10.         </dependency>
11. </dependencies>

复制代码

3.3.2 Controller

1. import org.apache.http.HttpHost;
2. import org.apache.http.auth.AuthScope;
3. import org.apache.http.auth.UsernamePasswordCredentials;
4. import org.apache.http.impl.client.BasicCredentialsProvider;
5. import org.elasticsearch.action.get.GetRequest;
6. import org.elasticsearch.action.get.GetResponse;
7. import org.elasticsearch.client.RequestOptions;
8. import org.elasticsearch.client.RestClient;
9. import org.elasticsearch.client.RestClientBuilder;
10. import org.elasticsearch.client.RestHighLevelClient;
11. import org.springframework.web.bind.annotation.GetMapping;
12. import org.springframework.web.bind.annotation.RestController;
14. import java.io.IOException;
16. @RestController
17. public class ArticleController {
19.     @GetMapping("/get")
20.     public GetResponse get() throws IOException {
21.         BasicCredentialsProvider provider = new BasicCredentialsProvider();
22.         provider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials("elastic", "elastic"));
24.         RestClientBuilder builder = RestClient.builder(new HttpHost("127.0.0.1", 9200, "http"))
25.                 .setHttpClientConfigCallback(httpAsyncClientBuilder -> httpAsyncClientBuilder.setDefaultCredentialsProvider(provider));
26.         RestHighLevelClient client = new RestHighLevelClient(builder);
28.         GetRequest getRequest = new GetRequest("articles", "test");
29.         return client.get(getRequest, RequestOptions.DEFAULT);
30.     }
31. }

复制代码

3.3.3 测试

访问 /get 接口，可以看到对应的文档信息

3.4 Elasticsearch Java API Client

3.4.1 引入依赖

1. <dependencies>
2.         <dependency>
3.             <groupId>org.springframework.boot</groupId>
4.             <artifactId>spring-boot-starter-web</artifactId>
5.         </dependency>
7.         <dependency>
8.             <groupId>co.elastic.clients</groupId>
9.             <artifactId>elasticsearch-java</artifactId>
10.         </dependency>
12.         <dependency>
13.             <groupId>org.projectlombok</groupId>
14.             <artifactId>lombok</artifactId>
15.         </dependency>
16. </dependencies>

复制代码

3.4.2 文档实体类

1. import lombok.Data;
3. @Data
4. public class Article {
6.     private String id;
8.     private String title;
10.     private String content;
11. }

复制代码

3.4.3 Controller

需要注意这里的文档实体类必须包含索引的全部字段，否则会报错无法解析

1. import co.elastic.clients.elasticsearch.ElasticsearchClient;
2. import co.elastic.clients.elasticsearch.core.GetResponse;
3. import co.elastic.clients.json.jackson.JacksonJsonpMapper;
4. import co.elastic.clients.transport.ElasticsearchTransport;
5. import co.elastic.clients.transport.rest_client.RestClientTransport;
6. import fable.entity.Article;
7. import org.apache.http.HttpHost;
8. import org.apache.http.auth.AuthScope;
9. import org.apache.http.auth.UsernamePasswordCredentials;
10. import org.apache.http.impl.client.BasicCredentialsProvider;
11. import org.elasticsearch.client.RestClient;
12. import org.springframework.web.bind.annotation.GetMapping;
13. import org.springframework.web.bind.annotation.RestController;
15. import java.io.IOException;
17. @RestController
18. public class ArticleController {
20.     @GetMapping("/get")
21.     public Article get() throws IOException {
22.         BasicCredentialsProvider provider = new BasicCredentialsProvider();
23.         provider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials("elastic", "UnF8lyv82vJarD=iAbcZ"));
25.         RestClient restClient = RestClient.builder(new HttpHost("124.222.118.90", 9200, "http"))
26.                 .setHttpClientConfigCallback(httpAsyncClientBuilder -> httpAsyncClientBuilder.setDefaultCredentialsProvider(provider))
27.                 .build();
28.         ElasticsearchTransport transport = new RestClientTransport(
29.                 restClient, new JacksonJsonpMapper()
30.         );
31.         ElasticsearchClient elasticsearchClient = new ElasticsearchClient(transport);
33.         GetResponse<Article> response = elasticsearchClient.get(builder -> builder.index("articles").id("test"), Article.class);
34.         System.out.println(response);
35.         return response.source();
36.     }
37. }

复制代码

3.4.4 测试

访问 /get 接口，可以看到文档信息如下

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。