当前位置:   article > 正文

一篇掌握Elasticsearch7.10集群搭建到实战_org.elasticsearch.client7.10版本

org.elasticsearch.client7.10版本

  目录

一、背景

二、内容概要

三、基础概念

四、ES版本选择

Elasticsearch版本选择

ES客户端SDK版本选择

五、Elasticsearch多租户

多租户下的架构

 租户的识别和路由

六、ES 集群搭建

  集群部署架构

 单集群示例

 多集群示例

ES集群搭建配置

安装中文分词插件 IK

七、ES SDK及增删改查Demo

八、ES管理工具

安装集群管理工具- Kibana

es-header插件安装使用

九、ES集群安全策略

X-pack安全策略开启及集群配置

十、ES运维

数据备份与恢复

索引重建

索引设置别名

十一、ES常用操作命令

十二、ES 相关资料


一、背景

  鉴于公司接下来很多业务场景需要用到搜索引擎,之后负责进行调研, 比较早的时候用过solr,现在来看显得有点过时了,不过它依然还是有自己的优势比如查询效率、同步延迟等。各个云厂商也有搜索引擎但是作为小厂肯定是用不起,现在主流都是ES也只有这一个选择,不过ES也有不少坑,比如最少1s的查询延迟,假如你的业务不允许有1s的查询延迟,那你还是选择别的方案吧。

二、内容概要

  • elasticsearch版本选择对比,包括sdk的选择
  • elasticsearch多租户设计方案,逻辑隔离与物理隔
  • elasticsearch集群搭建,安全设置
  • elasticsearch 增删改查Demo及sdk的封装
  • kibana介绍与搭建
  • elasticsearch常见运维方法及操作命令

三、基础概念

Elasticsearch是一个开源的分布式搜索引擎,可以用来存储您的数据,然后进行快速的搜索。
Elasticsearch是面向文档的,与关系型数据库对比,在数据概念上有些区别:
   
一个业务数据在关系数据库中往往会建一个表,在ES 7.x++中是建一个索引 (indies),无论是表还是索引都会包含一些字段。
数据库中一条记录往往称为一条记录用row来表示,在es中被称为一个文档document。在es中添加一条数据就是添加一个文档。
数据库中一个属性往往会叫做列column,在es中被称为一个field。
数据库创建表有标准的SQL语句,ES也有自己的创建索引语法,例如以下为创建一个名为 test001的索引,数据分成5片,一份副本,共有三个字段
  1. PUT test001
  2. {
  3. "settings": {
  4. "number_of_shards": 5,
  5. "number_of_replicas": 1
  6. },
  7. "mappings": {
  8. "properties": {
  9. "id": {
  10. "type": "long"
  11. },
  12. "name": {
  13. "type": "text",
  14. "analyzer": "ik_max_word"
  15. },
  16. "age": {
  17. "type": "integer"
  18. }
  19. }
  20. }
  21. }

四、ES版本选择

:由于elasticsearch各版本差异较大,所以在调研及给出具体的方案前我们需要确定使用的es版本

通过大量资料搜索对比了对各个版本差异,最终选择7.10比较稳定的版本来使用。 es从5.x、6.x、7.x、8.x设计及sdk差异都比较大,5和6版本比较老了,与现在spring boot 2.x版本集成存在问题,8.x比较新才出一两年也有比较多的license限制,所以最终选择了7.10版本。

elasticsearch版本选择

  • 结论 :优先选择 7.10.0
  • 原因对比如下
类型\版本6.x7.x8.x建议
Licence

Apache 2.0

7.0 ~ 7.10 Apache 2.0
7.11++ SSPL
SSPL
建议选择更友好的Apache2.0版本,sspl对于在云上想要让ES as a Service,将会面临es厂商的限制
云厂商支持程度

腾讯、阿里云均支持,

华为不支持 

腾讯云最高版 7.10.x
阿里云7.10.x,7.16.x
华为云7.6.x, 7.10.x
均不支持
各云厂商也主要在推广7.x版本,稳定性及占用率更高,建议选择7.x中的7.10.0版本
发版时间

初版2016

2019年
2021年底
建议选择 7.x版本,经历将近4年,稳定性已经经过验证,6.x和8.x一个太老一个太新
特性差异

/

集群配置简化,master选举进行了优化,

能够避免集群脑裂问题;

索引创建已经去除了type,更加简化;

索引查询算法升级,查询性能有优化;

提供安全策略;

Kibana更轻量化,更易用;

ES API进行了升级方便后续升级使用;
更加安全,es默认开启了一些安全功能;
新的搜索API 特性,比如支持NLP等;
7.x基本也能满足目前需求,稳定性也更有保障

2.1 ~ 2.2版本对6.x支持

2.3 ~ 2.7版本对7.x支持
/
基于目前应用中使用的spring boot版本,只能选择 7.x版本

ES客户端SDK版本选择

  • 结论使用spring官方提供的spring-boot-es-starter
客户端适用版本优点缺点建议
TransportClient5.x
6.x
启动速度快,轻量级,可创建极多连接,与应用程序解耦;推荐使用原生的,ES本身就很简单,灵活性很高分发或查询数据速度较慢,不能获取指定节点数据,高版本已经废弃不建议使用
JestClient5.x
6.x
7.x
提供Restful API, 原生ES API不具备;若ES集群使用不同的ES版本,使用原生ES API会有问题,而Jest不会;更安全(可以在Http层添加安全处理);JestClient是ElasticSearch的Java HTTP Rest客户端; JestClient填补了 ElasticSearch缺少HttpRest接口客户端的空白; JestClient可以跨版本18年已经停止更新,7.x、8.x版本兼容性存疑不建议使用
RestClient
low-level-rest-client
5.0++基于Http Client 进行的简单封装,RestClient可以跨版本,支持到目前8.x所有版本。HttpClient和Jsoup都不直接支持发送DELETE方法带参数的请求(官方高版本已经放弃使用)。使用成本较高不推荐
high-level-rest-client7.2.0 - 7.16.x官方基于RestClient进行的封装,提供一系列API方便对ES的使用在7.17版本后官方又废弃了7部分版本推荐使用
New ElasticsearchClient7.17++为最新官方提供的版本较高版本es适用8.x官方推荐使用
spring-boot-es-starter3.0++spring官方封装的ES api,使用起来相对简单,也spring兼容性也能保障,教程也比较多。需要与使用的es版本进行匹配推荐使用

五、Elasticsearch多租户

  • es本身没有租户的能力,对es来说都是一个一个独立索引,这些索引默认都存储在一个es集群上,考虑后面ES as a Service,即作为PaaS能力来提供服务时,就不得不加入租户设计,这也是云时代iaas、paas、saas所面临的共同问题。通过调研市面上并无较多可参考的设计及直接可用的es多租户plugin,基于此需要自行设计支持。

  多租户下的架构

  • 多租户架构往往我们要提供逻辑隔离和物理隔离两种能力,根据需求并可以灵活定制某一租户是独享集群还是共享集群,当独享集群则是物理隔离,当共享集群时就是逻辑隔离,无论哪种方式都要做到部署架构能够低成本支持,应用层对集群无感;

 租户的识别和路由

  • 逻辑隔离代表着所有索引在同一个ES集群上,此时可以通过在索引上加一个tenant字段,通过字段隔离业务数据
  • 物理隔离则可以前置一个负载均衡,比如使用Nginx来完成往不同的ES集群分发请求,不同的集群有不同的地址,应用发起请求时根据请求中的参数进行路由
    • 考虑方便路由及管理,团队内可以定制租户及索引名统一命名规范,比如租户cod: tenantxx,文章索引名为article,完整索引名为:tenantxx_article

六、ES 集群搭建

 注意
  • 生产环境linux下Es 不能使用root启动,需要给es创建独立用户

  集群部署架构

下面示例是以三个机器实例来搭建的,es集群搭建机器实例个数也要是单数避免选举master或脑裂问题。 

 单集群示例

  • 集群每个节点都可以设置为可参与master选举及是否是数据节点
 

 多集群示例

集群访问规范

  出于安全及后续维护综合考虑,es集群对外提供访问地址最好是一个 域名,这样能避免ip到处暴露,也避免IP较高频率变化而导致系统经常升级。

ES集群搭建配置

   es官方下载地址,es和kibana尽量下载同一版本

  • elasticsearch各版本下载地址

        https://www.elastic.co/cn/downloads/past-releases#elasticsearch

  • kibana (es的可视化管理工具)

        https://www.elastic.co/cn/downloads/past-releases/#kibana

     启动前需要修改一些配置,先在一台上进行修改运行验证,待验证通过后,再copy到其它实例上
     集群搭建前必读(以下配置验证于es7.10版本,不同的版本差异比较大请认准版本)

1、先搭建单个节点

  先找任一个节点修改elasticsearch.yml,并添加以下配置(此时不要添加集群和证书配置)

  1. path.data: /opt/data
  2. path.logs: /opt/logs
  3. #http访问端口,程序或kibana使用
  4. http.port: 9200
  5. xpack.security.enabled: true
  6. xpack.security.transport.ssl.enabled: true

2、启动ES

  • 观察启动是否ok,若ok进行第三步
./bin/elasticsearch

3、设置安全账号信息(ES要启动状态)

  • 执行以下命令,给各账号设置密码, 整个集群只需要设置一次即可
  • 警告:设置账户密码切记要在单实例非集群模式时配置,不能添加任何集群的配置,否则会设置失败
    bin/elasticsearch-setup-passwords interactive

4、添加配置集群配置信息

  • 集群搭建需要开启安全,开启安全需要用到证书,证书生成参考【ES集群安全策略步骤进行生成】,生成后进行以下配置
  • elasticsearch.yml加入以下配置
  1. #数据和日志存储路径
  2. path.data: /opt/data
  3. path.logs: /opt/logs
  4. #数据备份和恢复使用,可以一到多个目录
  5. path.repo: ["/opt/backup/es", "/opt/backup/es1"]
  6. #http访问端口,程序或kibana使用
  7. http.port: 9200
  8. #集群名称
  9. cluster.name: es001
  10. #节点名,每个节点名不能重复
  11. node.name: node1
  12. #是否可以参与选举主节点
  13. node.master: true
  14. #是否是数据节点
  15. node.data: true
  16. #允许访问的ip,4个0的话则允许任何ip进行访问
  17. network.host: 0.0.0.0
  18. #es各节点通信端口
  19. transport.tcp.port: 9300
  20. #集群每个节点IP地址。
  21. discovery.seed_hosts: ["xxx.xx.xx.xx:9300", "xx.xx.xx:9300", "xx.xx.xx:9300"]
  22. #es7.x新增的配置,初始化一个新的集群时需要此配置来选举master
  23. cluster.initial_master_nodes: ["node1", "node2", "node3"]
  24. #配置是否压缩tcp传输时的数据,默认为false,不压缩
  25. transport.tcp.compress: true
  26. # 是否支持跨域,es-header插件使用
  27. http.cors.enabled: true
  28. # *表示支持所有域名跨域访问
  29. http.cors.allow-origin: "*"
  30. http.cors.allow-headers: Authorization,X-Requested-With,Content-Type,Content-Length
  31. #集群模式开启安全 https://www.elastic.co/guide/en/elasticsearch/reference/7.17/security-minimal-setup.html
  32. xpack.security.enabled: true
  33. xpack.security.transport.ssl.enabled: true
  34. xpack.license.self_generated.type: basic
  35. xpack.security.transport.ssl.verification_mode: certificate
  36. xpack.security.transport.ssl.keystore.path: certs/elastic-certificates.p12
  37. xpack.security.transport.ssl.truststore.path: certs/elastic-certificates.p12
  38. #默认为1s,指定了节点互相ping的时间间隔。
  39. discovery.zen.fd.ping_interval: 1s
  40. #默认为30s,指定了节点发送ping信息后等待响应的时间,超过此时间则认为对方节点无响应。
  41. discovery.zen.fd.ping_timeout: 30s
  42. #ping失败后重试次数,超过此次数则认为对方节点已停止工作。
  43. discovery.zen.fd.ping_retries: 3

5 jvm.options

        设置占用的内存,根据机器配置设置,es还是需要比较多的内存
  1. -Xms6g
  2. -Xmx6g
 如果在linux下启动出现以错时需要修改linux系统配置
        max virtual memory areas vm.max_map_count [65530] is too low, increase to at
  1. sudo vim /etc/sysctl.conf
  2. #添加参数
  3. vm.max_map_count = 262144
  4. #重新加载配置
  5. sysctl -p

6、配置集群其它节点

    重复1、2、4、5等步骤,然后启动其它节点ES,看是否成功。搭建第2个节点时可以直接把第一个节点的配置和证书全copy过来。
     注意:启动第二个节点后最好先验证节点是否已经加到集群里了,验证方法有以下两种:
    
  • 使用系统命令查看集群节点数量
curl -XGET -u elastic:elastic123 "http://127.0.0.1:9200/_cluster/health?pretty"
  • 创建一个索引看集群中每个节点索引数据
    • 1、可以在任间一个节点执行创建索引命令
      curl -XPUT -u elastic:elastic123 "http://127.0.0.1:9200/test-index"
    • 2、查看所有节点索引是否一致
      curl -XGET -u elastic:elastic123  "http://localhost:9200/_cat/indices?pretty"
     在每个节点都执行以上命令看所有节点是否返回一致,如果集群搭建正常,在任意一个节点创建索引后都会自动同步到其它节点,如果返回不一致则认为集群搭建的是有问题的;

    7、关闭索引自动创建

  • 待es集群搭建完启动成功后,执行以下命令可以关闭索引自动创建功能,当然也可以不关闭,不关闭的话es sdk保存数据时候如果索引不存在则会自动创建索引,尽量还是关闭由专门负责人统一来管理索引
    1. PUT _cluster/settings
    2. {
    3. "persistent": {
    4. "action.auto_create_index": "false"
    5. }
    6. }
    PUT _cluster/settings { "persistent": { "action.auto_create_index": "false" } }
     注:如果后续装x-pak,可能需要修改 action.auto_create_index 值

    8、修改es集群索引默认分片数

  1. PUT _template/template_http_request_record
  2. {
  3. "index_patterns": [
  4. "*"
  5. ],
  6. "settings": {
  7. "number_of_shards": 5,
  8. "number_of_replicas": 1
  9. }
  10. }
      index_patterns = * 代表对所有索引生效
      number_of_shards 是索引主分片数.
      number_of_replicas 是备份数量.
     注: 7.x版本默认是1分片1备份,在集群3个节点情况设置为5分片较合适

  

  • ES集群模式数据分布原理
一个ES集群至少有一个节点,一个节点就是一个 elasricsearch 进程,每个节点可以有多个索引,如果创建索引时设置为5个分片,一个副本,那么索引数据将会均匀划分到 5 个分片上 (primary shard,又称主分片),每个分片有一个副本(replica shard,又称复制分片)。为了保证数据的稳定性es会把某个分片及副本存储在不同的实例上。

集群索引分片策略
  • 合理设置分片意义

    • es是一个分式式的搜索引擎,ES中默认为每个索引创建5个分片,每个分片提供一个备份。如果分片过小,当索引数据量非常大的话,每个分片上的数据就会比较多,导致检索时候效率较低,反之分片过多各节点之间的数据同步会过多消耗集群资源、检索时多分片数据归并也会影响效率,所以需要有一些标准来设置合理的分片避免上述问题。

  • 分片设置官方建议

    1. 1、分片过小会导致段过小,进而致使开销增加。您要尽量将分片的平均大小控制在至少几 GB 到几十 GB 之间。
    2. 对时序型数据用例而言,分片大小通常介于 20GB 至 40GB 之间。
    3. 2、由于单个分片的开销取决于段数量和段大小,所以通过 forcemerge 操作强制将
    4. 较小的段合并为较大的段能够减少开销并改善查询性能。理想状况下,
    5. 应当在索引内再无数据写入时完成此操作。请注意:这是一个极其耗费资源的操作,
    6. 所以应该在非高峰时段进行。
    7. 3、每个节点上可以存储的分片数量与可用的堆内存大小成正比关系,但是 Elasticsearch并未
    8. 强制规定固定限值。这里有一个很好的经验法则:确保对于节点上已配置的每个 GB,将分片数量
    9. 保持在 20 以下。如果某个节点拥有 30GB 的堆内存,那其最多可有 600 个分片,但是在此限值范围内,
    10. 您设置的分片数量越少,效果就越好。一般而言,这可以帮助集群保持良好的运行状态。
    11. (编者按:从 8.3 版开始,我们大幅减小了每个分片的堆使用量,
    12. 因此对本博文中的经验法则也进行了相应更新。请按照以下提示了解 8.3+ 版本的
    13. Elasticsearch。)
    • 其它网上使用经验

      • 每个分片的数据量不超过最大JVM堆空间设置,一般不超过32G。如果一个索引大概500G,那分片大概在16个左右比较合适。

      • 单个索引分片个数一般不超过节点数的3倍,推荐是1.5 ~ 3倍之间。假如一个集群3个节点,根据索引数据量大小分片数在5-9之间比较合适。

      • 主分片、副本和节点数,分配时也可以参考以下关系:节点数<= 主分片数 * (副本数 +1 )

  • 结论

    • 集群能承受的分片数

      单实例推荐最大分片数: (8G-2G-0.5G) * 20 = 110 个分片

      • 依目前3个4C8G实例规格举例来说明:

      • 单实例推荐最大分片数: (8G-2G-0.5G) * 20 = 110 个分片
      •  2G留给操作系统及其它软件内存使用,0.5G是留给ES本身做计算所需的内存资源。

        所以当前集群可以承载110 * 3 = 330 个分片,假如每个索引5个分片,整个集群可以容纳 330 / 5 = 66 个索引
        • 单个索引分片数

          • 依上面经验来计算3个节点的集群,索引分片为5-9个 比较合适

安装中文分词插件 IK

    ES 底层使用Lucene来构建的索引,Lucene历来对中文分词一直支持的不够好,所以需要使用更智能的中文分词。基于Lucene支持自定义分词的能力,ES也以Plugin方式提供了安装自定义分词的能力。目前使用最广泛的中文分词是IK,也提供了ES版本,直接安装使用即可。
  • IK分词git,上面有安装使用说明
    https://github.com/medcl/elasticsearch-analysis-ik/tree/v7.10.0
  • 安装命令-注意版本是否正确,一定要和es版本匹配
./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.10.0/elasticsearch-analysis-ik-7.10.0.zip
    测试分词效果,需要在kibana控制台测试
  1. POST _analyze
  2. {
  3. "analyzer": "ik_max_word",
  4. "text":"中国河南南阳"
  5. }

七、ES SDK及增删改查

 完整代码可以从github上下载 

https://github.com/caizi12/my-elasticsearch-starter.git

代码说明

封装了易于使用的elasticsearch starter,使用时可以先把代码Deploy到私有仓库中,然后应用程序中依赖使用,如果没有私有仓库可以把代码copy到应用中使用。

Deploy到仓库后使用方式

1、应用添加依赖

  1. <dependency>
  2. <groupId>com.my.es</groupId>
  3. <artifactId>elasticsearch-starter</artifactId>
  4. <version>1.0.0-SNAPSHOT</version>
  5. </dependency>

2、application.properties 添加es链接配置

  1. #es链接地址
  2. spring.elasticsearch.uris=http://localhost:9200
  3. #es账号密码,根据实际填写
  4. spring.elasticsearch.username=elastic
  5. spring.elasticsearch.password=123456
  6. #可省配置:连接es集群超时参数,默认毫秒
  7. spring.elasticsearch.connection-timeout=300
  8. spring.elasticsearch.read-timeout=300

3、Demo,(更多示例可以看单元测试部分)

  1. @SpringBootTest
  2. public class MyEsServiceTest {
  3. @Autowired
  4. private MyEsService myEsService;
  5. @Test
  6. public void delIndex() {
  7. boolean result = myEsService.deleteIndexIfExist(Student.class);
  8. Assert.assertTrue(result);
  9. }
  10. @Test
  11. public void delIndexDoc() {
  12. String result = myEsService.delIndexDoc("3007", Student.class);
  13. System.out.println("delIndexDoc:" + Student.class.getName());
  14. }
  15. @Test
  16. public void updateMapping() {
  17. boolean result = myEsService.updateIndexMapping(Student.class);
  18. Assert.assertTrue(result);
  19. }
  20. @Test
  21. public void updateIndexMapping() {
  22. boolean result = myEsService.updateIndexMapping(Shop.class);
  23. Assert.assertTrue(result);
  24. }
  25. @Test
  26. public void createIndex() {
  27. boolean exist = myEsService.existIndex(Student.class);
  28. boolean result = false;
  29. if (!exist) {
  30. result = myEsService.createIndexIfNotExist(Student.class);
  31. } else {
  32. System.out.println("index exist:" + Student.class.getName());
  33. }
  34. Assert.assertTrue(result);
  35. }
  36. @Test
  37. public void addIndexDoc() {
  38. Student student = new Student(1000, "张三", "测试索引添加", "哈哈", "三年二班刘", 10, new Date(), null);
  39. String documentId = myEsService.addIndexDoc(student);
  40. System.out.println("addIndexDoc result:" + documentId);
  41. Assert.assertNotNull(documentId);
  42. }
  43. }

ES SDK封装代码示例

接口定义

  1. package com.my.elasticsearch;
  2. import java.util.List;
  3. import javax.annotation.Nullable;
  4. import com.my.elasticsearch.model.MyEsSearchRequest;
  5. import org.elasticsearch.index.query.QueryBuilder;
  6. import org.springframework.data.domain.Pageable;
  7. import org.springframework.data.elasticsearch.core.IndexedObjectInformation;
  8. import org.springframework.data.elasticsearch.core.SearchHits;
  9. import org.springframework.data.elasticsearch.core.query.BulkOptions;
  10. import org.springframework.data.elasticsearch.core.query.NativeSearchQueryBuilder;
  11. import org.springframework.data.elasticsearch.core.query.UpdateResponse;
  12. /**
  13. * es服务接口,该接口提供对es的增删改查操作
  14. *
  15. * @authro nantian
  16. * @date 2022-10-08 15:19
  17. */
  18. public interface MyEsService {
  19. /**
  20. * 判断索引是否存在, 文档需标注@Document注解
  21. *
  22. * @param clazz
  23. * @return
  24. */
  25. boolean existIndex(Class<?> clazz);
  26. /**
  27. * 判断索引是否存在, 文档需标注@Document注解
  28. *
  29. * @param clazz
  30. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  31. * @return
  32. */
  33. boolean existIndex(Class<?> clazz, boolean nonTenantMode);
  34. /**
  35. * 创建索引并设置mapping,setting信息
  36. * 文档需标注@Document注解、包含@Id注解,其它属性字段需要添加@Field注解
  37. *
  38. * @param clazz
  39. * @return
  40. */
  41. boolean createIndexIfNotExist(Class<?> clazz);
  42. /**
  43. * 创建索引并设置mapping,setting信息
  44. * 文档需标注@Document注解、包含@Id注解,其它属性字段需要添加@Field注解
  45. *
  46. * @param clazz
  47. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  48. * @return
  49. */
  50. boolean createIndexIfNotExist(Class<?> clazz, boolean nonTenantMode);
  51. /**
  52. * 更新索引mapping信息,已存在的索引重复调用新加的字段会自动更新上去,老字段不会变化
  53. *
  54. * @param clazz
  55. * @return
  56. */
  57. boolean updateIndexMapping(Class<?> clazz);
  58. /**
  59. * 更新索引mapping信息,已存在的索引重复调用新加的字段会自动更新上去,老字段不会变化
  60. *
  61. * @param clazz
  62. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  63. * @return
  64. */
  65. boolean updateIndexMapping(Class<?> clazz, boolean nonTenantMode);
  66. /**
  67. * 删除索引,业务应用中不建议用,如果有必要联系管理员在Kibana控台进行操作
  68. *
  69. * @param clazz
  70. * @return
  71. */
  72. boolean deleteIndexIfExist(Class<?> clazz);
  73. /**
  74. * 删除索引,业务应用中不建议用,如果有必要联系管理员在Kibana控台进行操作
  75. *
  76. * @param clazz
  77. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  78. * @return
  79. */
  80. boolean deleteIndexIfExist(Class<?> clazz, boolean nonTenantMode);
  81. /**
  82. * 判断一个文档是否存在
  83. *
  84. * @param clazz
  85. * @param docId
  86. * @return
  87. */
  88. boolean existDocById(Class<?> clazz, String docId);
  89. /**
  90. * 判断一个文档是否存在
  91. *
  92. * @param clazz
  93. * @param docId
  94. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  95. * @return
  96. */
  97. boolean existDocById(Class<?> clazz, String docId, boolean nonTenantMode);
  98. /**
  99. * 添加一个数据到索引中,推荐使用@addIndexDoc(T model)
  100. *
  101. * @param indexName 索引名
  102. * @param model 索引数据,注解@Id的字段值不允许为空
  103. * @return 文档ID
  104. */
  105. <T> String addIndexDoc(String indexName, T model);
  106. /**
  107. * 添加一个数据到索引中,推荐使用@addIndexDoc(T model)
  108. *
  109. * @param indexName 索引名
  110. * @param model 索引数据,注解@Id的字段值不允许为空
  111. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  112. * @return 文档ID
  113. */
  114. <T> String addIndexDoc(String indexName, T model, boolean nonTenantMode);
  115. /**
  116. * 添加一个数据到索引中
  117. * 会自动获取类上的@Document(indexName)属性当索引名
  118. *
  119. * @param model 文档数据,注解@Id的字段值不允许为空
  120. * @return
  121. */
  122. <T> String addIndexDoc(T model);
  123. /**
  124. * 添加一个数据到索引中
  125. * 会自动获取类上的@Document(indexName)属性当索引名
  126. *
  127. * @param model 文档数据,注解@Id的字段值不允许为空
  128. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  129. * @return
  130. */
  131. <T> String addIndexDoc(T model, boolean nonTenantMode);
  132. /**
  133. * 添加一个数据到索引中,指定数据版本号
  134. *
  135. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  136. * @param version 数据版本号
  137. * @return
  138. */
  139. <T> String saveIndexDoc(T model, Long version);
  140. /**
  141. * 添加一个数据到索引中,指定数据版本号
  142. *
  143. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  144. * @param version 数据版本号
  145. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  146. * @return
  147. */
  148. <T> String saveIndexDoc(T model, Long version, boolean nonTenantMode);
  149. /**
  150. * 添加一个数据到索引中
  151. * 会自动获取类上的@Document(indexName)属性当索引名
  152. * 指定数据版本号
  153. *
  154. * @param indexName 索引名称
  155. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  156. * @param version 数据版本号
  157. * @return
  158. */
  159. <T> String saveIndexDoc(String indexName, T model, Long version);
  160. /**
  161. * 添加一个数据到索引中
  162. * 会自动获取类上的@Document(indexName)属性当索引名
  163. * 指定数据版本号
  164. *
  165. * @param indexName 索引名称
  166. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  167. * @param version 数据版本号
  168. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  169. * @return
  170. */
  171. <T> String saveIndexDoc(String indexName, T model, Long version, boolean nonTenantMode);
  172. /**
  173. * 批量添加索引,推荐使用@bulkAddIndexDoc(Class<?> clazz, List<T> docList)
  174. *
  175. * @param indexName
  176. * @param docList
  177. * @return
  178. */
  179. <T> List<IndexedObjectInformation> bulkAddIndexDoc(String indexName, List<T> docList);
  180. /**
  181. * 批量添加索引,推荐使用@bulkAddIndexDoc(Class<?> clazz, List<T> docList)
  182. *
  183. * @param indexName
  184. * @param docList
  185. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  186. * @return
  187. */
  188. <T> List<IndexedObjectInformation> bulkAddIndexDoc(String indexName, List<T> docList, boolean nonTenantMode);
  189. /**
  190. * 批量添加索引
  191. *
  192. * @param indexName 索引名称
  193. * @param docList es文档集合; 文档需标注@Document注解、包含@Id、@Version注解字段, 且@Id注解标注的文档ID字段值不能为空、@Version注解标注的文档数据版本字段值不能为空
  194. * @return
  195. */
  196. <T> List<IndexedObjectInformation> bulkSaveIndexDoc(String indexName, List<T> docList);
  197. /**
  198. * 批量添加索引
  199. *
  200. * @param indexName 索引名称
  201. * @param docList es文档集合; 文档需标注@Document注解、包含@Id、@Version注解字段, 且@Id注解标注的文档ID字段值不能为空、@Version注解标注的文档数据版本字段值不能为空
  202. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  203. * @return
  204. */
  205. <T> List<IndexedObjectInformation> bulkSaveIndexDoc(String indexName, List<T> docList, boolean nonTenantMode);
  206. /**
  207. * 批量添加索引,会自动获取类上的 @Document(indexName)属性当索引名
  208. *
  209. * @param clazz
  210. * @param docList
  211. * @return
  212. */
  213. <T> List<IndexedObjectInformation> bulkAddIndexDoc(Class<?> clazz, List<T> docList);
  214. /**
  215. * 批量添加索引,会自动获取类上的 @Document(indexName)属性当索引名
  216. *
  217. * @param clazz
  218. * @param docList
  219. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  220. * @return
  221. */
  222. <T> List<IndexedObjectInformation> bulkAddIndexDoc(Class<?> clazz, List<T> docList, boolean nonTenantMode);
  223. /**
  224. * 批量添加索引
  225. *
  226. * @param clazz 会自动获取类上的 @Document(indexName)属性当索引名
  227. * @param docList es文档集合; 文档需标注@Document注解、包含@Id、@Version注解字段, 且@Id注解标注的文档ID字段值不能为空、@Version注解标注的文档数据版本字段值不能为空
  228. * @return
  229. */
  230. <T> List<IndexedObjectInformation> bulkSaveIndexDoc(Class<?> clazz, List<T> docList);
  231. /**
  232. * 批量添加索引
  233. *
  234. * @param clazz 会自动获取类上的 @Document(indexName)属性当索引名
  235. * @param docList es文档集合; 文档需标注@Document注解、包含@Id、@Version注解字段, 且@Id注解标注的文档ID字段值不能为空、@Version注解标注的文档数据版本字段值不能为空
  236. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  237. * @return
  238. */
  239. <T> List<IndexedObjectInformation> bulkSaveIndexDoc(Class<?> clazz, List<T> docList, boolean nonTenantMode);
  240. /**
  241. * 更新文档,会自动获取类上的@Document(indexName)属性当索引名
  242. *
  243. * @param model 注解@Id的字段值不允许为空
  244. * @return
  245. */
  246. <T> UpdateResponse.Result updateDoc(T model);
  247. /**
  248. * 更新文档,会自动获取类上的@Document(indexName)属性当索引名
  249. *
  250. * @param model 注解@Id的字段值不允许为空
  251. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  252. * @return
  253. */
  254. <T> UpdateResponse.Result updateDoc(T model, boolean nonTenantMode);
  255. /**
  256. * 批量更新文档,会自动获取类上的@Document(indexName)属性当索引名
  257. *
  258. * @param clazz
  259. * @param <T> 注解@Id的字段值不允许为空
  260. * @return
  261. */
  262. <T> List<IndexedObjectInformation> bulkUpdateDoc(Class<?> clazz, List<T> modelList);
  263. /**
  264. * 批量更新文档
  265. *
  266. * @param clazz
  267. * @param <T> 注解@Id的字段值不允许为空
  268. * @param bulkOptions
  269. * @return
  270. */
  271. <T> List<IndexedObjectInformation> bulkUpdateDoc(Class<?> clazz, List<T> modelList, BulkOptions bulkOptions);
  272. /**
  273. * 根据ID删除一个索引文档
  274. *
  275. * @param id
  276. * @param clazz
  277. * @return
  278. */
  279. String delIndexDoc(String id, Class<?> clazz);
  280. /**
  281. * 根据ID删除一个索引文档
  282. *
  283. * @param id
  284. * @param clazz
  285. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  286. * @return
  287. */
  288. String delIndexDoc(String id, Class<?> clazz, boolean nonTenantMode);
  289. /**
  290. * 批量删除索引
  291. *
  292. * @param clazz
  293. * @param ids
  294. * @return
  295. */
  296. List<String> bulkDelIndexDoc(Class<?> clazz, List<String> ids);
  297. /**
  298. * 批量删除索引
  299. *
  300. * @param clazz
  301. * @param ids
  302. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  303. * @return
  304. */
  305. List<String> bulkDelIndexDoc(Class<?> clazz, List<String> ids, boolean nonTenantMode);
  306. /**
  307. * 删除一个索引文档,会自动从类上获取注解为@Id属性的value当作ID
  308. *
  309. * @param model
  310. * @param <T>
  311. * @return
  312. */
  313. <T> String delIndexDoc(T model);
  314. /**
  315. * 删除一个索引文档,会自动从类上获取注解为@Id属性的value当作ID
  316. *
  317. * @param model
  318. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  319. * @return
  320. */
  321. <T> String delIndexDoc(T model, boolean nonTenantMode);
  322. /**
  323. * @param docId
  324. * @param tClass
  325. * @param <T>
  326. * @return
  327. */
  328. <T> T findById(String docId, Class<T> tClass);
  329. /**
  330. * @param docId
  331. * @param clazz
  332. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  333. * @param <T>
  334. * @return
  335. */
  336. <T> T findById(String docId, Class<T> clazz, boolean nonTenantMode);
  337. /**
  338. * 根据ID批量查询
  339. *
  340. * 使用id查询数据实时性更好
  341. *
  342. * @param indexName
  343. * @param clazz
  344. * @param docIdList
  345. * @param nonTenantMode
  346. * @param <T>
  347. * @return
  348. */
  349. <T> List<T> findByIds(String indexName, Class<T> clazz, List<String> docIdList, boolean nonTenantMode) ;
  350. <T> List<T> findByIds(Class<T> clazz, List<String> docIdList) ;
  351. <T> List<T> findByIds(Class<T> clazz, List<String> docIdList,boolean nonTenantMode) ;
  352. /**
  353. * 更丰富灵活的索引查询,开放spring-boot-es-starter原生NativeSearchQueryBuilder
  354. *
  355. * @param clazz 自动获取类上的@Document(indexName)属性当索引名
  356. * @param queryBuilder
  357. * @return
  358. */
  359. <T> SearchHits<T> search(Class<T> clazz, NativeSearchQueryBuilder queryBuilder);
  360. /**
  361. * 更丰富灵活的索引查询,开放spring-boot-es-starter原生NativeSearchQueryBuilder
  362. *
  363. * @param clazz 自动获取类上的@Document(indexName)属性当索引名
  364. * @param queryBuilder
  365. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  366. * @return
  367. */
  368. <T> SearchHits<T> search(Class<T> clazz, NativeSearchQueryBuilder queryBuilder, boolean nonTenantMode);
  369. /**
  370. * 封装查询对象,简化NativeSearchQueryBuilder构造过程
  371. *
  372. * @param clazz 自动获取类上的@Document(indexName)属性当索引名
  373. * @param request
  374. * @return
  375. */
  376. <T> SearchHits<T> search(Class<T> clazz, MyEsSearchRequest request);
  377. /**
  378. * 封装查询对象,简化NativeSearchQueryBuilder构造过程
  379. *
  380. * @param clazz 自动获取类上的@Document(indexName)属性当索引名
  381. * @param request
  382. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  383. * @return
  384. */
  385. <T> SearchHits<T> search(Class<T> clazz, MyEsSearchRequest request, boolean nonTenantMode);
  386. /**
  387. * 精确查询类场景推荐使用,es不会计算文档相关性分值,性能更好
  388. *
  389. * @param clazz 自动获取类上的@Document(indexName)属性当索引名
  390. * @param filterBuilder
  391. * @param pageable
  392. * @return
  393. */
  394. <T> SearchHits<T> searchByFilter(Class<T> clazz, QueryBuilder filterBuilder, @Nullable Pageable pageable);
  395. /**
  396. * 精确查询类场景推荐使用,es不会计算文档相关性分值,性能更好
  397. *
  398. * @param clazz 自动获取类上的@Document(indexName)属性当索引名
  399. * @param filterBuilder
  400. * @param pageable
  401. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  402. * @return
  403. */
  404. <T> SearchHits<T> searchByFilter(Class<T> clazz, QueryBuilder filterBuilder, @Nullable Pageable pageable, boolean nonTenantMode);
  405. /**
  406. * 标题或文章内容检索类场景推荐使用,es会计算文档相关性,并按相关性自动排序
  407. *
  408. * @param clazz
  409. * @param queryBuilder
  410. * @param pageable
  411. * @return
  412. */
  413. <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, @Nullable Pageable pageable);
  414. /**
  415. * 标题或文章内容检索类场景推荐使用,es会计算文档相关性,并按相关性自动排序
  416. *
  417. * @param clazz
  418. * @param queryBuilder
  419. * @param pageable
  420. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  421. * @return
  422. */
  423. <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, @Nullable Pageable pageable, boolean nonTenantMode);
  424. /**
  425. * 索引数据查询
  426. *
  427. * @param clazz 索引类
  428. * @param queryBuilder
  429. * @param filterBuilder
  430. * @return
  431. */
  432. <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, QueryBuilder filterBuilder, @Nullable Pageable pageable);
  433. /**
  434. * 索引数据查询
  435. *
  436. * @param clazz 索引类
  437. * @param queryBuilder
  438. * @param filterBuilder
  439. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  440. * @return
  441. */
  442. <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, QueryBuilder filterBuilder, @Nullable Pageable pageable, boolean nonTenantMode);
  443. }

实现

  1. package com.my.elasticsearch.impl;
  2. import java.util.ArrayList;
  3. import java.util.List;
  4. import java.util.stream.Collectors;
  5. import com.my.elasticsearch.MyEsService;
  6. import com.my.elasticsearch.cache.EsIndexNameCache;
  7. import com.my.elasticsearch.util.EsReflectUtils;
  8. import com.my.elasticsearch.util.EsTenantUtil;
  9. import com.my.elasticsearch.model.MyEsSearchRequest;
  10. import com.fasterxml.jackson.annotation.JsonInclude;
  11. import com.fasterxml.jackson.core.JsonProcessingException;
  12. import com.fasterxml.jackson.databind.ObjectMapper;
  13. import org.apache.commons.lang3.StringUtils;
  14. import org.elasticsearch.index.query.BoolQueryBuilder;
  15. import org.elasticsearch.index.query.QueryBuilder;
  16. import org.elasticsearch.index.query.QueryBuilders;
  17. import org.elasticsearch.search.aggregations.AbstractAggregationBuilder;
  18. import org.springframework.data.domain.Pageable;
  19. import org.springframework.data.elasticsearch.core.ElasticsearchRestTemplate;
  20. import org.springframework.data.elasticsearch.core.IndexedObjectInformation;
  21. import org.springframework.data.elasticsearch.core.MultiGetItem;
  22. import org.springframework.data.elasticsearch.core.MyRestIndexTemplate;
  23. import org.springframework.data.elasticsearch.core.SearchHits;
  24. import org.springframework.data.elasticsearch.core.document.Document;
  25. import org.springframework.data.elasticsearch.core.index.Settings;
  26. import org.springframework.data.elasticsearch.core.mapping.IndexCoordinates;
  27. import org.springframework.data.elasticsearch.core.query.BulkOptions;
  28. import org.springframework.data.elasticsearch.core.query.FetchSourceFilter;
  29. import org.springframework.data.elasticsearch.core.query.IndexQuery;
  30. import org.springframework.data.elasticsearch.core.query.IndexQueryBuilder;
  31. import org.springframework.data.elasticsearch.core.query.NativeSearchQueryBuilder;
  32. import org.springframework.data.elasticsearch.core.query.StringQuery;
  33. import org.springframework.data.elasticsearch.core.query.UpdateQuery;
  34. import org.springframework.data.elasticsearch.core.query.UpdateResponse;
  35. import org.springframework.lang.Nullable;
  36. import org.springframework.util.Assert;
  37. import org.springframework.util.CollectionUtils;
  38. /**
  39. * es 公共组件服务实现
  40. *
  41. * 该实现提供了租户也非租户模式,租户模式会给索引名前自动加租户code前缀,如果不需要可以进行修改
  42. *
  43. * @authro nantian
  44. * @date 2022-10-08 15:19
  45. */
  46. public class MyEsServiceImpl implements MyEsService {
  47. private static ObjectMapper objectMapper;
  48. private ElasticsearchRestTemplate elasticsearchRestTemplate;
  49. private static final String PROPERTIES_KEY = "properties";
  50. public MyEsServiceImpl(ElasticsearchRestTemplate elasticsearchRestTemplate) {
  51. this.elasticsearchRestTemplate = elasticsearchRestTemplate;
  52. }
  53. static {
  54. //JavaTimeModule timeModule = new JavaTimeModule();
  55. //timeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer());
  56. //timeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer());
  57. 设置NULL值不参与序列化
  58. objectMapper = new ObjectMapper().setSerializationInclusion(JsonInclude.Include.NON_NULL);
  59. //.registerModule(timeModule);
  60. }
  61. /**
  62. * 根据使用的租户模式,决定是否对索引名添加租户标识
  63. *
  64. * @param index
  65. * @return
  66. */
  67. private String convertTenantIndex(String index) {
  68. return EsTenantUtil.getTenantIndex(index);
  69. }
  70. /**
  71. * 构建操作es的索引类
  72. *
  73. * @param index
  74. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  75. * @return
  76. */
  77. private IndexCoordinates buildIndexCoordinates(String index, boolean nonTenantMode) {
  78. if (!nonTenantMode) {
  79. index = convertTenantIndex(index);
  80. }
  81. return IndexCoordinates.of(index);
  82. }
  83. private IndexCoordinates buildIndexCoordinates(Class<?> clazz) {
  84. return buildIndexCoordinates(clazz, false);
  85. }
  86. private IndexCoordinates buildIndexCoordinates(Class<?> clazz, boolean nonTenantMode) {
  87. if (!nonTenantMode) {
  88. return IndexCoordinates.of(convertTenantIndex(getEsIndexName(clazz)));
  89. }
  90. return IndexCoordinates.of(getEsIndexName(clazz));
  91. }
  92. /**
  93. * 根据类@Document(indexName)属性获取索引名
  94. *
  95. * @param clazz
  96. * @return
  97. */
  98. private String getEsIndexName(Class<?> clazz) {
  99. return EsIndexNameCache.get(clazz);
  100. }
  101. /**
  102. * 判断索引是否存在
  103. *
  104. * @param indexName 索引名称
  105. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  106. * @return
  107. */
  108. public boolean existIndex(String indexName, boolean nonTenantMode) {
  109. if (StringUtils.isNotEmpty(indexName)) {
  110. return elasticsearchRestTemplate.indexOps(buildIndexCoordinates(indexName, nonTenantMode)).exists();
  111. }
  112. return Boolean.FALSE;
  113. }
  114. /**
  115. * 判断索引是否存在
  116. *
  117. * @param clazz
  118. * @return
  119. */
  120. @Override
  121. public boolean existIndex(Class<?> clazz) {
  122. return existIndex(clazz, false);
  123. }
  124. @Override
  125. public boolean existIndex(Class<?> clazz, boolean nonTenantMode) {
  126. if (clazz != null) {
  127. return existIndex(getEsIndexName(clazz), nonTenantMode);
  128. }
  129. return Boolean.FALSE;
  130. }
  131. /**
  132. * 索引不存在时创建索引[无分片及mapping信息,暂不开放使用]
  133. *
  134. * @param indexName 索引名称
  135. * @return 是否创建成功
  136. */
  137. private boolean createIndexIfNotExist(String indexName) {
  138. return createIndexIfNotExist(indexName, false);
  139. }
  140. /**
  141. * 索引不存在时创建索引[无分片及mapping信息,暂不开放使用]
  142. *
  143. * @param indexName 索引名称
  144. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  145. * @return 是否创建成功
  146. */
  147. private boolean createIndexIfNotExist(String indexName, boolean nonTenantMode) {
  148. if (!existIndex(indexName, nonTenantMode)) {
  149. return elasticsearchRestTemplate.indexOps(buildIndexCoordinates(indexName, nonTenantMode)).create();
  150. }
  151. return Boolean.FALSE;
  152. }
  153. /**
  154. * 索引不存在时创建索引并设置分片及mapping信息
  155. *
  156. * @param clazz 索引类信息
  157. * @return 是否创建成功
  158. */
  159. @Override
  160. public boolean createIndexIfNotExist(Class<?> clazz) {
  161. return createIndexIfNotExist(clazz, false);
  162. }
  163. @Override
  164. public boolean createIndexIfNotExist(Class<?> clazz, boolean nonTenantMode) {
  165. boolean result = existIndex(clazz, nonTenantMode);
  166. if (!result) {
  167. //不能直接用createWithMapping,会漏掉租户信息,改写索引类上租户实现比较复杂
  168. //elasticsearchRestTemplate.indexOps(clazz).createWithMapping();
  169. MyRestIndexTemplate esRestIndexTemplate = new MyRestIndexTemplate(elasticsearchRestTemplate, clazz);
  170. Document document = esRestIndexTemplate.createMapping();
  171. Settings settings = esRestIndexTemplate.createSettings();
  172. return esRestIndexTemplate.doCreate(buildIndexCoordinates(clazz, nonTenantMode), settings, document);
  173. }
  174. return Boolean.FALSE;
  175. }
  176. /**
  177. * 更新索引字段,会自动获取类上的索引注解信息进行更新索引mapping,已存在的字段不会更新
  178. *
  179. * @param clazz
  180. * @return
  181. */
  182. @Override
  183. public boolean updateIndexMapping(Class<?> clazz) {
  184. return updateIndexMapping(clazz, false);
  185. }
  186. @Override
  187. public boolean updateIndexMapping(Class<?> clazz, boolean nonTenantMode) {
  188. boolean result = existIndex(clazz, nonTenantMode);
  189. if (result) {
  190. MyRestIndexTemplate esRestIndexTemplate = new MyRestIndexTemplate(elasticsearchRestTemplate, clazz);
  191. Document document = esRestIndexTemplate.createMapping();
  192. return esRestIndexTemplate.doPutMapping(buildIndexCoordinates(clazz, nonTenantMode), document);
  193. }
  194. return Boolean.FALSE;
  195. }
  196. /**
  197. * 索引存在删除索引
  198. *
  199. * @param indexName 索引名称
  200. * @return 是否删除成功
  201. */
  202. public boolean deleteIndexIfExist(String indexName) {
  203. return deleteIndexIfExist(indexName, false);
  204. }
  205. /**
  206. * 索引存在删除索引
  207. *
  208. * @param indexName 索引名称
  209. * @return 是否删除成功
  210. */
  211. public boolean deleteIndexIfExist(String indexName, boolean nonTenantMode) {
  212. if (existIndex(indexName, nonTenantMode)) {
  213. return elasticsearchRestTemplate.indexOps(buildIndexCoordinates(indexName, nonTenantMode)).delete();
  214. }
  215. return Boolean.FALSE;
  216. }
  217. /**
  218. * 索引存在删除索引
  219. *
  220. * @param clazz 索引名称
  221. * @return 是否删除成功
  222. */
  223. @Override
  224. public boolean deleteIndexIfExist(Class<?> clazz) {
  225. if (existIndex(clazz)) {
  226. return deleteIndexIfExist(getEsIndexName(clazz));
  227. }
  228. return Boolean.FALSE;
  229. }
  230. @Override
  231. public boolean deleteIndexIfExist(Class<?> clazz, boolean nonTenantMode) {
  232. if (existIndex(clazz, nonTenantMode)) {
  233. return deleteIndexIfExist(getEsIndexName(clazz), nonTenantMode);
  234. }
  235. return Boolean.FALSE;
  236. }
  237. /**
  238. * 新增索引文档,根据类上的@Document获取索引名
  239. *
  240. * @param model elasticsearch文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  241. * @return 文档ID
  242. */
  243. @Override
  244. public <T> String addIndexDoc(T model) {
  245. return addIndexDoc(getEsIndexName(model.getClass()), model);
  246. }
  247. @Override
  248. public <T> String addIndexDoc(T model, boolean nonTenantMode) {
  249. return addIndexDoc(getEsIndexName(model.getClass()), model, nonTenantMode);
  250. }
  251. /**
  252. * 新增文档,指定索引名
  253. *
  254. * @param indexName 索引名称
  255. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  256. * @return 文档ID
  257. */
  258. @Override
  259. public <T> String addIndexDoc(String indexName, T model) {
  260. return addIndexDoc(indexName, model, false);
  261. }
  262. @Override
  263. public <T> String addIndexDoc(String indexName, T model, boolean nonTenantMode) {
  264. Assert.notNull(indexName, "addIndexDoc elasticsearch indexName is null");
  265. Assert.notNull(model, "addIndexDoc document is null");
  266. return elasticsearchRestTemplate.index(
  267. new IndexQueryBuilder().withId(getDocumentIdValue(model)).withObject(model).build(),
  268. buildIndexCoordinates(indexName, nonTenantMode));
  269. }
  270. /**
  271. * 保存文档,指定数据版本号
  272. *
  273. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  274. * @param version 数据版本号
  275. * @param <T>
  276. * @return
  277. */
  278. @Override
  279. public <T> String saveIndexDoc(T model, Long version) {
  280. return saveIndexDoc(model, version, false);
  281. }
  282. @Override
  283. public <T> String saveIndexDoc(T model, Long version, boolean nonTenantMode) {
  284. return saveIndexDoc(getEsIndexName(model.getClass()), model, version, nonTenantMode);
  285. }
  286. /**
  287. * 保存文档,指定索引名和数据版本号
  288. *
  289. * @param indexName 索引名称
  290. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  291. * @param version 数据版本号
  292. * @return 文档ID
  293. */
  294. @Override
  295. public <T> String saveIndexDoc(String indexName, T model, Long version) {
  296. return saveIndexDoc(indexName, model, version, false);
  297. }
  298. /**
  299. * 保存文档,指定索引名和数据版本号
  300. *
  301. * @param indexName 索引名称
  302. * @param model es文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  303. * @param version 数据版本号
  304. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  305. * @return 文档ID
  306. */
  307. @Override
  308. public <T> String saveIndexDoc(String indexName, T model, Long version, boolean nonTenantMode) {
  309. Assert.notNull(indexName, "addIndexDoc elasticsearch indexName is null");
  310. Assert.notNull(model, "addIndexDoc document is null");
  311. return elasticsearchRestTemplate.index(
  312. new IndexQueryBuilder().withId(getDocumentIdValue(model)).withVersion(version).withObject(model).build(),
  313. buildIndexCoordinates(indexName, nonTenantMode));
  314. }
  315. @Override
  316. public <T> List<IndexedObjectInformation> bulkAddIndexDoc(Class<?> clazz, List<T> docList) {
  317. return bulkAddIndexDoc(getEsIndexName(clazz), docList);
  318. }
  319. @Override
  320. public <T> List<IndexedObjectInformation> bulkAddIndexDoc(Class<?> clazz, List<T> docList, boolean nonTenantMode) {
  321. return bulkAddIndexDoc(getEsIndexName(clazz), docList, nonTenantMode);
  322. }
  323. @Override
  324. public <T> List<IndexedObjectInformation> bulkSaveIndexDoc(Class<?> clazz, List<T> docList) {
  325. return bulkSaveIndexDoc(clazz, docList, false);
  326. }
  327. @Override
  328. public <T> List<IndexedObjectInformation> bulkSaveIndexDoc(Class<?> clazz, List<T> docList, boolean nonTenantMode) {
  329. return bulkSaveIndexDoc(getEsIndexName(clazz), docList, nonTenantMode);
  330. }
  331. /**
  332. * 批量新增文档
  333. *
  334. * @param indexName 索引名称
  335. * @param docList es文档集合; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  336. * @return 文档ID
  337. */
  338. public <T> List<IndexedObjectInformation> bulkAddIndexDoc(String indexName, List<T> docList) {
  339. return bulkAddIndexDoc(indexName, docList, false);
  340. }
  341. /**
  342. * 批量新增文档
  343. *
  344. * @param indexName 索引名称
  345. * @param docList es文档集合; 文档需标注@Document注解、包含@Id注解字段, 且@Id注解标注的文档ID字段值不能为空
  346. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  347. * @return 文档ID
  348. */
  349. @Override
  350. public <T> List<IndexedObjectInformation> bulkAddIndexDoc(String indexName, List<T> docList, boolean nonTenantMode) {
  351. Assert.notNull(indexName, "bulkAddIndexDoc elasticsearch indexName is null");
  352. Assert.notNull(docList, "bulkAddIndexDoc document is null");
  353. List<IndexQuery> indexQueries = new ArrayList<>();
  354. docList.forEach(doc ->
  355. indexQueries.add(new IndexQueryBuilder().withId(getDocumentIdValue(doc)).withObject(doc).build()));
  356. return elasticsearchRestTemplate.bulkIndex(indexQueries, buildIndexCoordinates(indexName, nonTenantMode));
  357. }
  358. /**
  359. * 批量新增文档
  360. *
  361. * @param indexName 索引名称
  362. * @param docList es文档集合; 文档需标注@Document注解、包含@Id、@Version注解字段, 且@Id注解标注的文档ID字段值不能为空、@Version注解标注的文档数据版本字段值不能为空
  363. * @param <T>
  364. * @return
  365. */
  366. @Override
  367. public <T> List<IndexedObjectInformation> bulkSaveIndexDoc(String indexName, List<T> docList) {
  368. return bulkSaveIndexDoc(indexName, docList, false);
  369. }
  370. /**
  371. * 批量新增文档
  372. *
  373. * @param indexName 索引名称
  374. * @param docList es文档集合; 文档需标注@Document注解、包含@Id、@Version注解字段, 且@Id注解标注的文档ID字段值不能为空、@Version注解标注的文档数据版本字段值不能为空
  375. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  376. * @return
  377. */
  378. @Override
  379. public <T> List<IndexedObjectInformation> bulkSaveIndexDoc(String indexName, List<T> docList, boolean nonTenantMode) {
  380. Assert.notNull(indexName, "bulkAddIndexDoc elasticsearch indexName is null");
  381. Assert.notNull(docList, "bulkAddIndexDoc document is null");
  382. // 验证是否传version值
  383. docList.forEach(doc -> getDocumentVersionValue(doc));
  384. List<IndexQuery> indexQueries = new ArrayList<>();
  385. docList.forEach(doc ->
  386. indexQueries.add(new IndexQueryBuilder().withId(getDocumentIdValue(doc)).withVersion(getDocumentVersionValue(doc)).withObject(doc).build()));
  387. return elasticsearchRestTemplate.bulkIndex(indexQueries, buildIndexCoordinates(indexName, nonTenantMode));
  388. }
  389. /**
  390. * 根据ID查询文档
  391. *
  392. * @param indexName 索引名称
  393. * @param docId 文档ID
  394. * @param clazz 映射类Class
  395. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  396. * @param <T>
  397. * @return Elasticsearch 文档
  398. */
  399. public <T> T findById(String indexName, String docId, Class<T> clazz, boolean nonTenantMode) {
  400. if (StringUtils.isNotEmpty(docId) && clazz != null) {
  401. return elasticsearchRestTemplate.get(docId, clazz, buildIndexCoordinates(indexName, nonTenantMode));
  402. }
  403. return null;
  404. }
  405. public <T> T findById(String docId, Class<T> clazz) {
  406. return findById(docId, clazz, false);
  407. }
  408. @Override
  409. public <T> T findById(String docId, Class<T> clazz, boolean nonTenantMode) {
  410. return findById(getEsIndexName(clazz), docId, clazz, nonTenantMode);
  411. }
  412. /**
  413. * 根据多个ID查询文档
  414. *
  415. * @param indexName 索引名称
  416. * @param docIdList 文档ID
  417. * @param clazz 映射类Class
  418. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  419. * @param <T>
  420. * @return Elasticsearch 文档
  421. */
  422. @Override
  423. public <T> List<T> findByIds(String indexName, Class<T> clazz, List<String> docIdList, boolean nonTenantMode) {
  424. if (CollectionUtils.isEmpty(docIdList) || clazz == null || indexName == null) {
  425. return null;
  426. }
  427. StringQuery query = StringQuery.builder("stringQuery").withIds(docIdList).build();
  428. List<MultiGetItem<T>> result = elasticsearchRestTemplate.multiGet(query, clazz, buildIndexCoordinates(indexName, nonTenantMode));
  429. if(CollectionUtils.isEmpty(result)){
  430. return null;
  431. }
  432. List list = result.stream().map(o->o.getItem()).filter(item->item != null).collect(Collectors.toList());
  433. return list;
  434. }
  435. @Override
  436. public <T> List<T> findByIds(Class<T> clazz,List<String> docIdList) {
  437. return findByIds( clazz, docIdList,false);
  438. }
  439. @Override
  440. public <T> List<T> findByIds(Class<T> clazz, List<String> docIdList,boolean nonTenantMode) {
  441. return findByIds(getEsIndexName(clazz), clazz,docIdList, nonTenantMode);
  442. }
  443. /**
  444. * 根据ID判断文档是否存在
  445. *
  446. * @param indexName 索引名称
  447. * @param docId 文档ID
  448. * @return 存在与否
  449. */
  450. private boolean existDocById(String indexName, String docId, boolean nonTenantMode) {
  451. if (existIndex(indexName, nonTenantMode) && StringUtils.isNotEmpty(docId)) {
  452. return elasticsearchRestTemplate.exists(docId, buildIndexCoordinates(indexName, nonTenantMode));
  453. }
  454. return Boolean.FALSE;
  455. }
  456. public boolean existDocById(Class<?> clazz, String docId) {
  457. return existDocById(clazz, docId, false);
  458. }
  459. @Override
  460. public boolean existDocById(Class<?> clazz, String docId, boolean nonTenantMode) {
  461. return existDocById(getEsIndexName(clazz), docId, nonTenantMode);
  462. }
  463. public <T> UpdateResponse.Result updateDoc(T elasticsearchModel) {
  464. return updateDoc(elasticsearchModel, false);
  465. }
  466. @Override
  467. public <T> UpdateResponse.Result updateDoc(T elasticsearchModel, boolean nonTenantMode) {
  468. String indexName = getEsIndexName(elasticsearchModel.getClass());
  469. return updateDoc(indexName, elasticsearchModel, nonTenantMode);
  470. }
  471. /**
  472. * 更新文档
  473. *
  474. * @param indexName 索引名称
  475. * @param elasticsearchModel elasticsearch文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id标注的文档ID值不能为空
  476. * @return UpdateResponse.Result
  477. * @throws JsonProcessingException JsonProcessingException
  478. */
  479. private <T> UpdateResponse.Result updateDoc(String indexName, T elasticsearchModel, boolean nonTenantMode) {
  480. return updateDoc(indexName, elasticsearchModel, this.objectMapper, nonTenantMode);
  481. }
  482. /**
  483. * 更新文档
  484. *
  485. * @param indexName 索引名称
  486. * @param elasticsearchModel elasticsearch文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id标注的文档ID值不能为空
  487. * @param objectMapper objectMapper
  488. * @return UpdateResponse.Result
  489. */
  490. private <T> UpdateResponse.Result updateDoc(String indexName, T elasticsearchModel, ObjectMapper objectMapper) {
  491. return updateDoc(indexName, elasticsearchModel, objectMapper, false);
  492. }
  493. /**
  494. * 更新文档
  495. *
  496. * @param indexName 索引名称
  497. * @param elasticsearchModel elasticsearch文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id标注的文档ID值不能为空
  498. * @param objectMapper objectMapper
  499. * @param nonTenantMode 是否是租户模式,false表示非租户模式,即通用索引
  500. * @return UpdateResponse.Result
  501. */
  502. private <T> UpdateResponse.Result updateDoc(String indexName, T elasticsearchModel, ObjectMapper objectMapper, boolean nonTenantMode) {
  503. Assert.notNull(indexName, "bulkUpdateDoc clazz is null");
  504. Assert.notNull(elasticsearchModel, "bulkUpdateDoc modelList is null");
  505. try {
  506. String id = getDocumentIdValue(elasticsearchModel);
  507. Assert.isTrue(existDocById(indexName, id, nonTenantMode), "elasticsearch document is not exist.");
  508. objectMapper = objectMapper == null ? this.objectMapper : objectMapper;
  509. String json = objectMapper.writeValueAsString(elasticsearchModel);
  510. UpdateQuery updateQuery = UpdateQuery.builder(id).withDocument(Document.parse(json)).build();
  511. return elasticsearchRestTemplate.update(updateQuery, buildIndexCoordinates(indexName, nonTenantMode)).getResult();
  512. } catch (JsonProcessingException e) {
  513. e.printStackTrace();
  514. throw new RuntimeException(e);
  515. }
  516. }
  517. public <T> List<IndexedObjectInformation> bulkUpdateDoc(Class<?> clazz, List<T> modelList) {
  518. return bulkUpdateDoc(clazz, modelList, null);
  519. }
  520. public <T> List<IndexedObjectInformation> bulkUpdateDoc(Class<?> clazz, List<T> modelList, BulkOptions bulkOptions) {
  521. return bulkUpdateDoc(clazz, modelList, bulkOptions, objectMapper);
  522. }
  523. /**
  524. * 批量更新文档
  525. *
  526. * @param clazz 索引名称
  527. * @param modelList elasticsearch文档; 文档需标注@Document注解、包含@Id注解字段, 且@Id标注的文档ID值不能为空
  528. * @param objectMapper objectMapper
  529. * @return UpdateResponse.Result
  530. */
  531. private <T> List<IndexedObjectInformation> bulkUpdateDoc(Class<?> clazz, List<T> modelList, BulkOptions bulkOptions,
  532. ObjectMapper objectMapper) {
  533. Assert.notNull(clazz, "bulkUpdateDoc clazz is null");
  534. Assert.notNull(clazz, "bulkUpdateDoc modelList is null");
  535. try {
  536. List<UpdateQuery> queries = new ArrayList(modelList.size());
  537. UpdateQuery updateQuery = null;
  538. String id = null;
  539. for (T model : modelList) {
  540. id = getDocumentIdValue(model);
  541. Assert.notNull(id, clazz.getName() + " instance document id is null");
  542. String json = objectMapper.writeValueAsString(model);
  543. updateQuery = UpdateQuery.builder(getDocumentIdValue(model)).withDocument(Document.parse(json)).build();
  544. queries.add(updateQuery);
  545. }
  546. bulkOptions = bulkOptions == null ? BulkOptions.defaultOptions() : bulkOptions;
  547. return elasticsearchRestTemplate.doBulkOperation(queries, bulkOptions, buildIndexCoordinates(clazz));
  548. } catch (Exception e) {
  549. e.printStackTrace();
  550. throw new RuntimeException(e);
  551. }
  552. }
  553. private <T> String getDocumentIdValue(T elasticsearchModel) {
  554. return EsReflectUtils.getDocumentIdValue(elasticsearchModel);
  555. }
  556. private <T> Long getDocumentVersionValue(T elasticsearchModel) {
  557. return EsReflectUtils.getDocumentVersionValue(elasticsearchModel);
  558. }
  559. /**
  560. * 查询文档
  561. *
  562. * @param clazz 映射文档类 文档需标注@Document注解、包含@Id注解字段
  563. * @param queryBuilder 非结构化数据 QueryBuilder; queryBuilder与filterBuilder必须二者存在其一
  564. * @param filterBuilder 过滤查询
  565. * @param <T>
  566. * @return
  567. */
  568. public <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, QueryBuilder filterBuilder,
  569. Pageable pageable) {
  570. MyEsSearchRequest request = new MyEsSearchRequest(queryBuilder, filterBuilder, pageable);
  571. return search(clazz, request);
  572. }
  573. @Override
  574. public <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, QueryBuilder filterBuilder,
  575. Pageable pageable, boolean nonTenantMode) {
  576. MyEsSearchRequest request = new MyEsSearchRequest(queryBuilder, filterBuilder, pageable);
  577. return search(clazz, request, nonTenantMode);
  578. }
  579. public <T> SearchHits<T> searchByFilter(Class<T> clazz, QueryBuilder filterBuilder, Pageable pageable) {
  580. MyEsSearchRequest request = new MyEsSearchRequest(null, filterBuilder, pageable);
  581. return search(clazz, request);
  582. }
  583. @Override
  584. public <T> SearchHits<T> searchByFilter(Class<T> clazz, QueryBuilder filterBuilder, @javax.annotation.Nullable Pageable pageable, boolean nonTenantMode) {
  585. MyEsSearchRequest request = new MyEsSearchRequest(null, filterBuilder, pageable);
  586. return search(clazz, request, nonTenantMode);
  587. }
  588. public <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, Pageable pageable) {
  589. MyEsSearchRequest request = new MyEsSearchRequest(queryBuilder, null, pageable);
  590. return search(clazz, request);
  591. }
  592. @Override
  593. public <T> SearchHits<T> search(Class<T> clazz, QueryBuilder queryBuilder, @javax.annotation.Nullable Pageable pageable, boolean nonTenantMode) {
  594. MyEsSearchRequest request = new MyEsSearchRequest(queryBuilder, null, pageable);
  595. return search(clazz, request, nonTenantMode);
  596. }
  597. public <T> SearchHits<T> search(Class<T> clazz, MyEsSearchRequest request) {
  598. return search(clazz, request, false);
  599. }
  600. @Override
  601. public <T> SearchHits<T> search(Class<T> clazz, MyEsSearchRequest request, boolean nonTenantMode) {
  602. return search(getEsIndexName(clazz), clazz, request.getQueryBuilder(), request.getFilterBuilder(),
  603. request.getAggregationBuilder(), request.getPageable(), request.getQueryFields(), nonTenantMode);
  604. }
  605. public <T> SearchHits<T> search(Class<T> clazz, NativeSearchQueryBuilder queryBuilder) {
  606. return search(clazz, queryBuilder, false);
  607. }
  608. @Override
  609. public <T> SearchHits<T> search(Class<T> clazz, NativeSearchQueryBuilder queryBuilder, boolean nonTenantMode) {
  610. return elasticsearchRestTemplate.search(queryBuilder.build(), clazz, buildIndexCoordinates(clazz, nonTenantMode));
  611. }
  612. /**
  613. * 查询文档
  614. *
  615. * <p>
  616. * 查询的文档必须包含映射@Document的@Id字段
  617. * </p>
  618. *
  619. * @param indexName 索引名称
  620. * @param clazz 映射文档类 文档需标注@Document注解、包含@Id注解字段
  621. * @param queryBuilder 非结构化数据 QueryBuilder; queryBuilder与filterBuilder必须二者存在其一
  622. * @param filterBuilder 结构化数据 QueryBuilder; filterBuilder与queryBuilder必须二者存在其一
  623. * @param abstractAggregationBuilder 聚合查询Builder
  624. * @param pageable 分页/排序; 分页从0开始
  625. * @param fields 包含字段
  626. * @param nonTenantMode 是否是租户模式,false表示非租户模式,即通用索引
  627. * @return
  628. */
  629. private <T> SearchHits<T> search(String indexName, Class<T> clazz, @Nullable QueryBuilder queryBuilder,
  630. @Nullable QueryBuilder filterBuilder,
  631. @Nullable AbstractAggregationBuilder abstractAggregationBuilder,
  632. @Nullable Pageable pageable, @Nullable String[] fields, boolean nonTenantMode) {
  633. if (StringUtils.isNotBlank(indexName)) {
  634. // 查询的文档必须包含映射@Document的@Id字段(
  635. BoolQueryBuilder boolQueryBuilder = QueryBuilders.boolQuery().must(
  636. QueryBuilders.existsQuery(EsReflectUtils.getDocumentIdFieldName(clazz)));
  637. if (queryBuilder != null) {
  638. boolQueryBuilder.must(queryBuilder);
  639. }
  640. NativeSearchQueryBuilder nativeSearchQueryBuilder = new NativeSearchQueryBuilder().withQuery(
  641. boolQueryBuilder);
  642. if (filterBuilder != null) {
  643. nativeSearchQueryBuilder.withFilter(filterBuilder);
  644. }
  645. if (abstractAggregationBuilder != null) {
  646. nativeSearchQueryBuilder.withAggregations(abstractAggregationBuilder);
  647. }
  648. if (pageable != null) {
  649. nativeSearchQueryBuilder.withPageable(pageable);
  650. }
  651. if (fields != null && fields.length > 0) {
  652. nativeSearchQueryBuilder.withSourceFilter(new FetchSourceFilter(fields, null));
  653. //nativeSearchQueryBuilder.withFields(fields);
  654. }
  655. // nativeSearchQueryBuilder.withSorts(SortBuilders.fieldSort("id").order(SortOrder.ASC));
  656. return search(clazz, nativeSearchQueryBuilder, nonTenantMode);
  657. }
  658. return null;
  659. }
  660. @Override
  661. public String delIndexDoc(String id, Class<?> clazz) {
  662. return delIndexDoc(id, clazz, false);
  663. }
  664. @Override
  665. public String delIndexDoc(String id, Class<?> clazz, boolean nonTenantMode) {
  666. return elasticsearchRestTemplate.delete(id, buildIndexCoordinates(clazz, nonTenantMode));
  667. }
  668. @Override
  669. public <T> String delIndexDoc(T model) {
  670. return delIndexDoc(model, false);
  671. }
  672. @Override
  673. public <T> String delIndexDoc(T model, boolean nonTenantMode) {
  674. return delIndexDoc(EsReflectUtils.getDocumentIdValue(model), model.getClass(), nonTenantMode);
  675. }
  676. /**
  677. * 根据ID批量删除
  678. * 官方未提供根据id批量删除的,暂时就以循环删除的方式来操作,若有大批量操作存在性能问题考虑转为query delete方式
  679. *
  680. * @param clazz
  681. * @param ids
  682. * @return 返回每个ID删除后的返回结果
  683. */
  684. @Override
  685. public List<String> bulkDelIndexDoc(Class<?> clazz, List<String> ids) {
  686. return bulkDelIndexDoc(clazz, ids, false);
  687. }
  688. /**
  689. * 根据ID批量删除
  690. * 官方未提供根据id批量删除的,暂时就以循环删除的方式来操作,若有大批量操作存在性能问题考虑转为query delete方式
  691. *
  692. * @param clazz
  693. * @param ids
  694. * @param nonTenantMode 是否是租户模式,true表示非租户模式,即通用索引
  695. * @return 返回每个ID删除后的返回结果
  696. */
  697. @Override
  698. public List<String> bulkDelIndexDoc(Class<?> clazz, List<String> ids, boolean nonTenantMode) {
  699. if (clazz == null || CollectionUtils.isEmpty(ids)) {
  700. return null;
  701. }
  702. List delResutList = new ArrayList();
  703. for (String id : ids) {
  704. delResutList.add(elasticsearchRestTemplate.delete(id, buildIndexCoordinates(clazz, nonTenantMode)));
  705. }
  706. return delResutList;
  707. }
  708. }

 增删改查demo

  1. package com.my.es.test;
  2. import java.util.Date;
  3. import java.util.List;
  4. import com.my.elasticsearch.MyEsService;
  5. import com.my.es.test.model.Shop;
  6. import com.my.es.test.model.Student;
  7. import com.my.elasticsearch.model.MyEsSearchRequest;
  8. import com.fasterxml.jackson.core.JsonProcessingException;
  9. import net.minidev.json.JSONObject;
  10. import org.assertj.core.util.Lists;
  11. import org.elasticsearch.index.query.BoolQueryBuilder;
  12. import org.elasticsearch.index.query.MatchQueryBuilder;
  13. import org.elasticsearch.index.query.QueryBuilder;
  14. import org.elasticsearch.index.query.QueryBuilders;
  15. import org.elasticsearch.index.query.RangeQueryBuilder;
  16. import org.junit.Assert;
  17. import org.junit.jupiter.api.Test;
  18. import org.springframework.beans.factory.annotation.Autowired;
  19. import org.springframework.boot.test.context.SpringBootTest;
  20. import org.springframework.data.domain.PageRequest;
  21. import org.springframework.data.domain.Sort;
  22. import org.springframework.data.domain.Sort.Direction;
  23. import org.springframework.data.elasticsearch.core.ElasticsearchRestTemplate;
  24. import org.springframework.data.elasticsearch.core.IndexedObjectInformation;
  25. import org.springframework.data.elasticsearch.core.SearchHits;
  26. import org.springframework.data.elasticsearch.core.query.UpdateResponse;
  27. import org.springframework.data.elasticsearch.core.query.UpdateResponse.Result;
  28. /**
  29. * es demo
  30. *
  31. * @authro nantian
  32. * @date 2022-10-08 19:33
  33. */
  34. @SpringBootTest
  35. public class MyEsServiceTest {
  36. @Autowired
  37. private MyEsService myEsService;
  38. @Autowired
  39. private ElasticsearchRestTemplate elasticsearchRestTemplate;
  40. @Test
  41. public void delIndex() {
  42. boolean result = myEsService.deleteIndexIfExist(Student.class);
  43. Assert.assertTrue(result);
  44. }
  45. @Test
  46. public void delIndexDoc() {
  47. String result = myEsService.delIndexDoc("3007", Student.class);
  48. System.out.println("delIndexDoc:" + Student.class.getName());
  49. }
  50. @Test
  51. public void updateMapping() {
  52. boolean result = myEsService.updateIndexMapping(Student.class);
  53. Assert.assertTrue(result);
  54. }
  55. @Test
  56. public void updateIndexMapping() {
  57. boolean result = myEsService.updateIndexMapping(Shop.class);
  58. Assert.assertTrue(result);
  59. }
  60. @Test
  61. public void createIndex() {
  62. boolean exist = myEsService.existIndex(Student.class);
  63. boolean result = false;
  64. if (!exist) {
  65. result = myEsService.createIndexIfNotExist(Student.class);
  66. } else {
  67. System.out.println("index exist:" + Student.class.getName());
  68. }
  69. Assert.assertTrue(result);
  70. }
  71. @Test
  72. public void createIndex3() {
  73. boolean result = myEsService.createIndexIfNotExist(Shop.class);
  74. System.out.println("index exist:" + Shop.class.getName());
  75. Assert.assertTrue(result);
  76. }
  77. @Test
  78. public void addIndexDoc() {
  79. Student student = new Student(1000, "张三", "测试索引添加", "哈哈", "三年二班刘", 10, new Date(), null);
  80. String documentId = myEsService.addIndexDoc(student);
  81. System.out.println("addIndexDoc result:" + documentId);
  82. Assert.assertNotNull(documentId);
  83. }
  84. @Test
  85. public void saveIndexDocWithVersion() {
  86. Student student = new Student(1009, "张三1001", "测试索引添加1", "哈哈", "三年二班刘11", 10, new Date(), null);
  87. Student existOne = myEsService.findById(student.getId() + "", Student.class);
  88. Long _version = existOne != null ? existOne.getVersion() + 1 : null;
  89. String documentId = myEsService.saveIndexDoc(student, _version);
  90. System.out.println("addIndexDoc result:" + documentId);
  91. Assert.assertNotNull(documentId);
  92. }
  93. @Test
  94. public void existIndex() {
  95. boolean result1 = myEsService.existIndex(Student.class);
  96. boolean result2 = myEsService.existIndex(Student.class, true);
  97. System.out.println(result1 + "------" + result2);
  98. }
  99. @Test
  100. public void saveIndexDocWithNonTenantModel() {
  101. Student student = new Student(1001, "张三1001", "测试索引添加1", "哈哈", "三年二班刘11", 10, new Date(), null);
  102. boolean nonTenantModel = true;
  103. if (nonTenantModel) {
  104. if (!myEsService.existIndex(Student.class, nonTenantModel)) {
  105. myEsService.createIndexIfNotExist(Student.class, nonTenantModel);
  106. }
  107. }
  108. Student existOne = myEsService.findById(student.getId() + "", Student.class, nonTenantModel);
  109. Long _version = existOne != null ? existOne.getVersion() + 1 : null;
  110. String documentId = myEsService.saveIndexDoc(student, _version, nonTenantModel);
  111. System.out.println("addIndexDoc result:" + documentId);
  112. Assert.assertNotNull(documentId);
  113. }
  114. @Test
  115. public void bulkAddIndexDoc2() {
  116. Student student1 = new Student(1000, "zs0", "测试索引添加0", "哈哈33ss", "三年二班刘先生中国", 10, new Date(), null);
  117. Student student2 = new Student(1001, "zs", "测试索引添加1", "哈哈dd", "五年二班周先生美国", 20, new Date(), null);
  118. Student student3 = new Student(1002, "zs", "测试索引添加2", "哈哈aa", "10年二班刘女士中国", 0, new Date(), null);
  119. Student student4 = new Student(1003, "zs1003", "测试索引添加3", "哈哈aadd", "八年二班张女士北京", 50, new Date(), null);
  120. Student student5 = new Student(1004, "zs1004", "测试索引添加4", "哈哈bbaa", "三年二班刘重生北京", 60, new Date(), null);
  121. Student student6 = new Student(1006, "zs1006", "测试索引添加4", "哈哈bbaa", "三年二班刘重生北京", 60, new Date(), null);
  122. Student student7 = new Student(1007, "zs1007", "测试索引添加4", "哈哈bbaa", "三年二班刘重生北京", 60, new Date(), null);
  123. List list = Lists.newArrayList(student1, student2, student3, student4, student5, student6, student7);
  124. List<IndexedObjectInformation> result = myEsService.bulkAddIndexDoc(Student.class, list);
  125. System.out.println("bulkAddIndexDoc result:" + JSONObject.toJSONString(result));
  126. Assert.assertNotNull(result.size() > 0);
  127. }
  128. @Test
  129. public void bulkSaveIndexDoc() {
  130. Student student1 = new Student(1020, "zs0", "测试索引添加0", "哈哈33ss", "三年二班刘先生中国", 11, new Date(), null);
  131. Student student2 = new Student(1021, "zs", "测试索引添加1", "哈哈dd", "五年二班周先生美国", 12, new Date(), null);
  132. Student student3 = new Student(1022, "zs", "测试索引添加2", "哈哈aa", "10年二班刘女士中国", 13, new Date(), null);
  133. List<Student> list = Lists.newArrayList(student1, student2, student3);
  134. for (Student student : list) {
  135. Student existOne = myEsService.findById(student.getId() + "", Student.class);
  136. Long _version = existOne != null ? existOne.getVersion() + 1 : 1;
  137. student.setVersion(_version);
  138. }
  139. List<IndexedObjectInformation> result = myEsService.bulkSaveIndexDoc(Student.class, list);
  140. System.out.println("bulkAddIndexDoc result:" + JSONObject.toJSONString(result));
  141. Assert.assertNotNull(result.size() > 0);
  142. }
  143. @Test
  144. public void getByIdStudent() {
  145. Student student = myEsService.findById("1000", Student.class);
  146. System.out.println(JSONObject.toJSONString(student));
  147. }
  148. @Test
  149. public void updateDoc() throws JsonProcessingException {
  150. Student student = new Student();
  151. student.setId(1000);
  152. student.setAge(30);
  153. student.setText("lisi");
  154. UpdateResponse.Result result = myEsService.updateDoc(student);
  155. System.out.println("update result:" + JSONObject.toJSONString(result));
  156. Student student2 = myEsService.findById("1000", Student.class);
  157. System.out.println(JSONObject.toJSONString(student2));
  158. Assert.assertTrue(Result.UPDATED == result);
  159. }
  160. @Test
  161. public void searchAll() {
  162. SearchHits<Student> hits = myEsService.search(Student.class, QueryBuilders.matchAllQuery(), null);
  163. System.out.println(JSONObject.toJSONString(hits));
  164. }
  165. @Test
  166. public void searchBySingleField() {
  167. QueryBuilder queryBuilder = QueryBuilders.matchQuery("name", "zs0");
  168. SearchHits<Student> hits = myEsService.search(Student.class, queryBuilder, null);
  169. System.out.println(JSONObject.toJSONString(hits));
  170. }
  171. @Test
  172. public void searchByFilter() {
  173. MyEsSearchRequest request = new MyEsSearchRequest();
  174. request.setQueryFields(new String[]{"name", "id", "_version"});
  175. //1
  176. QueryBuilder queryBuilder = QueryBuilders.multiMatchQuery("zs", "name", "text");
  177. request.setQueryBuilder(queryBuilder);
  178. //2
  179. MatchQueryBuilder queryBuilder1 = QueryBuilders.matchQuery("name", "zs");
  180. RangeQueryBuilder queryBuilder2 = QueryBuilders.rangeQuery("age").gte("10").lte("60");
  181. MatchQueryBuilder fuzzyQueryBuilder = QueryBuilders.matchQuery("desc", "哈哈");
  182. BoolQueryBuilder boolQueryBuilder = QueryBuilders.boolQuery();
  183. boolQueryBuilder.should(queryBuilder1);
  184. boolQueryBuilder.should(queryBuilder2);
  185. boolQueryBuilder.should(fuzzyQueryBuilder);
  186. BoolQueryBuilder filterQueryBuilder = QueryBuilders.boolQuery();
  187. filterQueryBuilder.should(QueryBuilders.matchQuery("id", "1000"));
  188. request.setFilterBuilder(filterQueryBuilder);
  189. //3 分页及排序
  190. request.setQueryBuilder(boolQueryBuilder);
  191. Sort sort = Sort.by(Direction.DESC, "age");
  192. PageRequest pageRequest = PageRequest.of(0, 10, sort);
  193. request.setPageable(pageRequest);
  194. SearchHits<Student> hits = myEsService.search(Student.class, request);
  195. System.out.println(JSONObject.toJSONString(hits));
  196. }
  197. }

八、ES管理工具

推荐使用官方的kibana,功能更全面    

安装集群管理工具- Kibana

Kibanan安装比较简单,es集群搭建成功后,修改config/kibana.yml 加入以下配置,启动即可

  1. #设置为中文
  2. i18n.locale: "zh-CN"
  3. #允许其它IP可以访问
  4. server.host: "0.0.0.0"
  5. elasticsearch.username: "kibana_system"
  6. elasticsearch.password: "elastic123"
  7. #es集群地址,填写真实的节点地址
  8. elasticsearch.hosts: ["http://xxx.xx.xx.xx:9200","http://xxx.xx.xx.xx:9200","http://xxx.xx.xx.xx:9200"]
 启动命令
 
./bin/kibana

es-header插件安装使用

    es-header 插件是一个方便查看es集群、索引管理的一个工具,非官方提供,使用方式一般是安装chrome插件或下载安装header包进行本地安装(需要安装node),具体安装方式参考上面的文档, 以下是es-header图示:

  • 说明
    1. # 是否支持跨域,es-header插件使用
    2. http.cors.enabled: true
    3. # *表示支持所有域名跨域访问
    4. http.cors.allow-origin: "*"
    5. http.cors.allow-headers: Authorization,X-Requested-With,Content-Type,Content-Length
     http://localhost:9200/?auth_user=elastic&auth_password=elastic123
    • 开启跨域访问,使用es-header需要在es的配置文件中添加以下配置开启跨域访问
    • 添加口令访问,如果es集群开启了口令访问,es-header使用时需要在url后添加口令,示例如下:

九、ES集群安全策略

  ES 7以下默认几乎没有任何安全策略,如果IP、端口被暴露,在可访问的情况下任何用户都可以对索引进行管理,以及数据的查询、删除等,基于此需要考虑设置一定的安全策略, 目前常用几种方式如下 :
类别
优点
缺点
建议
nginx
对外屏蔽了ES集群的真实IP和端口,配置也较简单
只能做一些网络访问安全上面的防护,不能对索引及字段进行精确控制
选择X-pack
经验证在免费情况下X-Pack能满足基本诉求,对应用中使用影响也比较小
Search Guard
开源免费,基于RBAC权限模型设计,能够细粒度进行管控
配置复杂,需要安装证书及业务应用代码改造
X-Pack
官方提供,基于RBAC权限模型设计,能够细粒度进行管控,与client api及es集群兼容性较好
配置稍复杂,基础部分功能免费

X-pack安全策略开启及集群配置

  第一步:在ES的根目录生成CA证书
bin/elasticsearch-certutil ca
   步骤执行完会在elasticsearch根目录生成:elastic-stack-ca.p12
   注意
     1、提示输入输出文件,直接回车默认即可
     2、提示输入密码, 务必输入 ,第二步要用到,如果都是空密码后面启动es时会出password incorrect错误
  第二步: 使用第一步生成的证书,产生p12密钥
bin/elasticsearch-certutil cert --ca elastic-stack-ca.p12
  步骤执行完会在elasticsearch根目录生成: elastic-certificates.p12
   注意:这一步共有三个交互
  • Enter password for CA (elastic-stack-ca.p12)
   输入第一步中设置的的密码:
  • Please enter the desired output file [elastic-certificates.p12]:
   不用输入文件,直接回车默认即可
  • Enter password for elastic-certificates.p12 :
   不要输入密码,直接回车,否则还会出现es启动时报 password incorrect错误
  
  第三步: 配置证书
     1、将以上两个文件拷贝到config/certs目录,没有则新创建
     2、配置elasticsearch.yml
xpack.security.enabled: true xpack.license.self_generated.type: basic xpack.security.transport.ssl.enabled: true xpack.security.transport.ssl.verification_mode: certificate xpack.security.transport.ssl.keystore.path: certs/elastic-certificates.p12 xpack.security.transport.ssl.truststore.path: certs/elastic-certificates.p12
     注意
  • 第一步第二步整个集群只须执行一次,第一个节点配置完后把证书copy到其它节点共用即可
  • elasticsearch.yml 同样集群中每个es节点都需要配置
  第四步:重启ES
    重启ES看是否能正常启动,是否有ssl相关的错误信息,若无则一般说明配置没有问题
    重启成功再访问ES时则会提示输入用户名密码,此时说明es安全已经启用,此时由于没有设置密码是无法登录的,接下来按第5步进行操作
     注意
     先配置单个节点,重启ES看是否正常,如果正常其它节点再进行同样的操作
  

十、ES运维

 数据备份与恢复

   es官方提供了数据备份和恢复的方式,基本思路是用官方提供的API创建数据备份文件,然后再用恢复数据的API进行恢复,es默认情况下都是对整个集群的所有索引进行备份,也可进行定制只备份部分索引,恢复时也需要根据情况来恢复指定的索引数据,es均提供有相应的定制能力。
   官方文档
   https://www.elastic.co/guide/en/elasticsearch/reference/7.6/snapshots-register-repository.html
第一步:配置备份与恢复目录
   es规范要求必须先在 elasticsearch.yml中配置备份恢复目录,后续才可使用该目录进行备份和恢复,当然每个es节点都要进行配置。
     配置如下:
path.repo: ["/data/backups", "/data2/backups"]
  目录可以写一到多个,一般写一个即可,配置加上后需要重启es集群
  第二步:创建一个备份/快照
   创建备份的三种方式
  • 1、kibana上的dev_tools工具
    • 该工具就是手动在kibana,填写备份与恢复API、参数等进行数据的备份与恢复,能够灵活的定制一些备份和恢复策略,也可以借助此工具熟悉es数据备份和恢复的各种操作命令,但不能自动进行备份
  • 2、kibana提供的备份与恢复管理工具 [ 建议使用 ]
  •      提供了快照查看、备份目录管理、创建备份快照的策略(如:多长时间创建一次快照)、快照恢复等功能,基本能够满足日常的使用,但存在问题是kibana这个产品上很多数据也是存在ES集群中,如果ES集群出现问题比如数据丢失Kibana也可能无法使用,此时我们就需要使用curl等方式发送http请求来恢复数据
    • 工具路径,ip与port自行替换 http://127.0.0.1:5601/app/management/data/snapshot_restore/snapshots
  
  • 3、使用curl发送 http请求 方式 【 终极方式
         当kibanan不可用时可以采用此方式,算是个保留的救命手段,此方式在备份与恢复使用的API及请求参数与第1种方式一致,只是使用了不同的工具来发送请求而已。
        这种方式在发送请求时需要填写集群地址及集群的访问口令,例如查看一个快照状态:
    curl -u elastic:elastic123 -X POST 'http://ip:9200/_snapshot/jingkai_backup/snapshot/_status'
  快照创建操作命令
 以下api适用于第1、3两种方式
   (1) 创建一个备份仓库
  创建备份前需要先创建一个仓库,所有的备份都需要放在仓库中,一个es集群可以有多个备份仓库
PUT /_snapshot/backup1 { "type": "fs", "settings": { "location": "/data/backups", "compress": true, "max_snapshot_bytes_per_sec": "50mb", "max_restore_bytes_per_sec": "50mb" } }
  • 其它命令
    (1)查看所有仓库: GET /_snapshot
  • 属性说明
    • _snapshot 命令是指创建一个备份快照,后面的路径【backup1】可以认为是仓库的名字
    • type=fs: 代表是文件系统来存储备份,其它方式暂没有找到
    • location: 当前备份存放的目录
    • compress: 是否开启压缩
    • max_snapshot_bytes_per_sec:备份时最大写入数据速度,可以根据实际硬件配置进行填写
    • max_restore_bytes_per_sec:恢复时最大读取速度
(2)创建一个备份/快照
json属性参数也可不填
PUT /_snapshot/backup1/snapshot_20221013?wait_for_completion=true { "indices": "index_1,index_2", "ignore_unavailable": true, "include_global_state": false }
  • wait_for_completion=true 设置为true时,操作界面会等待快照备份的结果,当索引比较大备份时间很长也有可能看不到结果,此时可以设置为false然后用以下命令查看备份进度
    GET /_snapshot/backup1/snapshot_20221013/_status
    "indices": "index_1,index_2" : 可以使用该参数只对部分索引进行备份
  • ignore_unavailable=true: 忽略不可用的索引
  • include_global_state =false 可以防止将群集全局状态存储为快照的一部分。默认情况下,如果参与快照的一个或多个索引没有所有可用的主分片,则整个快照将失败。可以通过设置为partial来更改此行为true。
(3)查看某个快照
  • GET /_snapshot/backup1/snapshot_20221013
  • GET /_snapshot/backup1/snapshot_20221013/_status
(4)终止创建/删除快照
   当备份时执行则可以终止备份,当备份结束后执行可以删除快照
  • DELETE /_snapshot/backup1/snapshot_20221013
第三步:数据恢复
es集群上有比较多的索引数据,除了业务索引还有es和Kibana等一些配套工具生成的系统内置索引,备份时如果没有指定只对部分索引进行备份,那默认是全部备份,当整个集群出现问题也可以使用此进行恢复。但在实际场景中可能只会对某部分出现问题的索引进行恢复,或者是想重命名及重建索引,这时候就需要在恢复时设置相应的参数。
注意:集群中正在提供服务的索引【状态为open】,是无法直接进行恢复的,强行恢复会提示『because an open index with same name already exists in the cluster』,此时需要先把索引关闭,但关闭索引就会影响线上业务功能,所以恢复索引时需要慎重操作。如果集群已经不可用了,可以直接使用。如果不能停机恢复可能需要借助索引别名及索引重建方式来恢复索引。
   使用Kibana工具恢复
    具体步骤就不进行赘述了,按界面上提供的功能进行操作即可
  使用dev_tools、curl方式进行恢复
    (1) 执行恢复
POST /_snapshot/backup1/snapshot_20221013/_restore { "indices": "index_1,index_2", "ignore_unavailable": true, "include_global_state": true, "rename_pattern": "index_(.+)", "rename_replacement": "restored_index_$1", "include_aliases": false }
  • _restore : 为恢复快照命令
  • indices: 要恢复的索引,支持使用索引别名, 支持通配符表达式, 多个索引名称用逗号拼接,如果不指定 indices , 则表示恢复所有索引.
  • ignore_unavailable 为true则恢复时忽略不可用的索引
  • include_global_state:设置为false,则不把快照中的状态恢复到当前集群中
  • rename_pattern: 可省参数,重命名索引的匹配规则,使用此参数可以让A索引恢复到B索引上,有点类似重建或重命名的意思,无此参数则直接还原到当前索引【当前索引必须是close状态】,此参数与rename_replacement须一起使用,一般使用正则匹配
  • rename_replacement:可省参数,重命名恢复的索引,须与rename_pattern结合使用,【$1】为rename_pattern中匹配到的数据,restored_index_则为恢复的索引添加了一个新的前缀名
  • include_aliases: false 防止别名与关联索引一起还原
  (2) 终止恢复-慎用
     注意:es并未提供单独的停止恢复命令,而是通过删除快照操作来达到终止恢复,所以执行此命令有可能导致快照数据也会被删除
DELETE /_snapshot/backup1/snapshot_20221013

索引重建

索引重建不是对当前索引进行重建,而是把一个索引重建到一个新的索引上,新的索引mapping,setting可以单独设置,在某些场景比如一开始索引设置的是5个分片,当集群节点增加后我们可以创建一个新的索引把分片设置更大一点,然后使用以下命令把数据重建到新索引上,然后应用访问新索引
POST _reindex { "source": { "index": "app1_pay_order_index" }, "dest": { "index": "app1_pay_order_index_new" } }
:索引重建结合索引别名功能,可以实现不停机索引切换

索引设置别名

索引设置别名后,我们可以使用别名对索引进行操作,与原名一样,别名在数据恢复或者重建场景非常有用,程序中建议使用别名进行访问索引

添加&删除别名

remove 删除索引别名add 给索引添加别名
POST /_aliases { "actions": [ #删除别名 { "remove": { "index": "app1_pay_order", "alias": "app1_pay_order2" } }, #添加别名 { "add": { "index": "app1_pay_order_new", "alias": "app1_pay_order2" }} ] }
查询所有索引别名
GET _alias

查询指定索引别名

GET app1_pay_order/_alias

十一、ES常用操作命令

  • es启动
    • 命令:./bin/elasticsearch
    • 访问地址:http://localhost:9200/ 默认9200端口
  • Kibana 启动
  • 查看集群状态
      检查集群运行情况: GET -> localhost:9200/_cat/health?v
      查看集群节点列表: GET -> localhost:9200/_cat/nodes
      查看所有索引:       GET -> localhost:9200/_cat/indices?v
  • 索引操作API
    • es集群所的操作都可以http方式进行操作,当然也可以使用kibana上的开发工具操作,kibana操作更简单些。
      1. //1.查询查看分片状态-Authorization方式(postman通过账密获取token)
      2. curl -XGET ‘http://127.0.0.1:9200/_cluster/allocation/explain?pretty’ --header ‘Authorization’: Basic ZWxhc3RpYzphcDIwcE9QUzIw’
      3. //2.查询查看分片状态-账密方式
      4. curl -XGET -u elastic "http://127.0.0.1:9200/_cluster/allocation/explain?pretty" -H ‘Content-Type:application/json’
      5. //3.查询集群状态命令
      6. curl -XGET -u elastic:elastic123 "http://127.0.0.1:9200/_cluster/health?pretty"
      7. //4.查询Es全局状态
      8. curl -XGET -u elastic:elastic123 "http://127.0.0.1:9200/_cluster/stats?pretty"
      9. //5.查询集群设置
      10. curl -XGET -u elastic:elastic123 "http://127.0.0.1:9200/_cluster/settings?pretty"
      11. //6.查询集群文档总数
      12. curl -XGET -u elastic:elastic123 "http://127.0.0.1:9200/_cat/count?v"
      13. //7.查看当前集群索引分片信息
      14. curl -XGET -u elastic:elastic123 "http://127.0.0.1:9200/_cat/shards?v"
      15. //8.查看集群实例存储详细信息
      16. curl -XGET -u elastic "http://127.0.0.1:9200/_cat/allocation?v"
      17. //9.查看当前集群的所有实例
      18. curl -XGET -u elastic "http://127.0.0.1:9200/_cat/nodes?v"
      19. //10.查看当前集群等待任务
      20. curl -XGET -u elastic "http://127.0.0.1:9200/_cat/pending_tasks?v"
      21. //11.查看集群查询线程池任务
      22. curl -XGET -u elastic "http://127.0.0.1:9200/_cat/thread_pool/search?v"
      23. //12.查看集群写入线程池任务
      24. curl -XGET -u elastic "http://127.0.0.1:9200/_cat/thread_pool/bulk?v"
      25. //13.清理ES所有缓存
      26. curl -XPOST "http://127.0.0.1:9200/_cache/clear"
      27. //14.查询索引信息
      28. curl -XGET -u : ‘https://127.0.0.1:9200/licence_info_test?pretty’
      29. //15.关闭索引
      30. curl -XGET -u : ‘https://127.0.0.1:9200/my_index/_close?pretty’
      31. //16.打开索引
      32. curl -XGET -u : ‘https://127.0.0.1:9200/my_index/_open?pretty’

      kibana工具

十二、ES 相关资料

  • gitHub地址
https://github.com/elastic/elasticsearch/

 官方文档 

https://www.elastic.co/cn/downloads/past-releases/#kibana
  • wiki
    • Elasticsearch 集群协调迎来新时代
      • https://www.elastic.co/cn/blog/a-new-era-for-cluster-coordination-in-elasticsearch
    • Elasticsearch 集群内应该设置多少个分片?
      • https://www.elastic.co/cn/blog/how-many-shards-should-i-have-in-my-elasticsearch-cluster
    • Es spring-boot-starter wiki
      • https://docs.spring.io/spring-data/elasticsearch/docs/4.3.7/reference/html/#reference
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/爱喝兽奶帝天荒/article/detail/953633
推荐阅读
相关标签
  

闽ICP备14008679号