SpringBoot 2.1.x整合Elasticsearch 5.6.8
ElasticSearch相关概念
- Centos 7.4下使用Docker容器技术搭建ES集群【推荐】
ES概述
- Elasticsearch是面向文档(document oriented)的，这意味着它可以存储整个对象或文档(document)。然而它不仅仅是存储，还会索引(index)每个文档的内容使之可以被搜索。在Elasticsearch中，你可以对文档（而非成行成列的数据）进行索引、搜索、排序、过滤。Elasticsearch比传统关系型数据库如下：
Relational DB -> Databases -> Tables -> Rows -> Columns
Elasticsearch -> Indices -> Types -> Documents -> Fields
索引【index】
- 一个索引就是一个拥有几分相似特征的文档的集合。比如说，你可以有一个客户数据的索引，另一个产品目录的索引，还有一个订单数据的索引。一个索引由一个名字来标识（必须全部是小写字母的），并且当我们要对对应于这个索引中的文档进行索引、搜索、更新和删除的时候，都要使用到这个名字。在一个集群中，可以定义任意多的索引。
类型【type】
- 在一个索引中，你可以定义一种或多种类型。一个类型是你的索引的一个逻辑上的分类/分区，其语义完全由你来定。通常，会为具有一组共同字段的文档定义一个类型。比如说，我们假设你运营一个博客平台并且将你所有的数据存储到一个索引中。在这个索引中，你可以为用户数据定义一个类型，为博客数据定义另一个类型，当然，也可以为评论数据定义另一个类型。
字段【Field】
- 相当于是数据表的字段，对文档数据根据不同属性进行的分类标识。
映射【mapping】
- mapping是处理数据的方式和规则方面做一些限制，如某个字段的数据类型、默认值、分析器、是否被索引等等，这些都是映射里面可以设置的，其它就是处理es里面数据的一些使用规则设置也叫做映射，按着最优规则处理数据对性能提高很大，因此才需要建立映射，并且需要思考如何建立映射才能对性能更好。
文档【document】
- 一个文档是一个可被索引的基础信息单元。比如，你可以拥有某一个客户的文档，某一个产品的一个文档，当然，也可以拥有某个订单的一个文档。文档以JSON（Javascript Object Notation）格式来表示，而JSON是一个到处存在的互联网数据交互格式。在一个index/type里面，你可以存储任意多的文档。注意，尽管一个文档，物理上存在于一个索引之中，文档必须被索引/赋予一个索引的type。
接近实时【NRT】
- Elasticsearch是一个接近实时的搜索平台。这意味着，从索引一个文档直到这个文档能够被搜索到有一个轻微的延迟（通常是1秒以内）。
集群【cluster】
- 一个集群就是由一个或多个节点组织在一起，它们共同持有整个的数据，并一起提供索引和搜索功能。一个集群由一个唯一的名字标识，这个名字默认就是“elasticsearch”。这个名字是重要的，因为一个节点只能通过指定某个集群的名字，来加入这个集群。
节点【node】
- 一个节点是集群中的一个服务器，作为集群的一部分，它存储数据，参与集群的索引和搜索功能。和集群类似，一个节点也是由一个名字来标识的，默认情况下，这个名字是一个随机的漫威漫画角色的名字，这个名字会在启动的时候赋予节点。这个名字对于管理工作来说挺重要的，因为在这个管理过程中，你会去确定网络中的哪些服务器对应于Elasticsearch集群中的哪些节点。
- 一个节点可以通过配置集群名称的方式来加入一个指定的集群。默认情况下，每个节点都会被安排加入到一个叫做“elasticsearch”的集群中，这意味着，如果你在你的网络中启动了若干个节点，并假定它们能够相互发现彼此，它们将会自动地形成并加入到一个叫做“elasticsearch”的集群中。
- 在一个集群里，只要你想，可以拥有任意多个节点。而且，如果当前你的网络中没有运行任何Elasticsearch节点，这时启动一个节点，会默认创建并加入一个叫做“elasticsearch”的集群。
分片和复制【shard&replicas】
- 一个索引可以存储超出单个结点硬件限制的大量数据。比如，一个具有10亿文档的索引占据1TB的磁盘空间，而任一节点都没有这样大的磁盘空间；或者单个节点处理搜索请求，响应太慢。默认情况下，Elasticsearch中的每个索引被分片5个主分片和1个复制，这意味着，如果你的集群中至少有两个节点，你的索引将会有5个主分片和另外5个复制分片（1个完全拷贝），这样的话每个索引总共就有10个分片。
##使用Jest操作ES
- pom.xml
<dependencies>
<dependency>
<groupId>io.searchboxgroupId>
<artifactId>jestartifactId>
<version>5.3.3version>
dependency>
dependencies>
- application.yml
spring:
elasticsearch:
jest:
uris: http://192.168.44.113:9200
- Article实体
package com.hf.boot.entity;
import io.searchbox.annotations.JestId;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.Setter;
/**
* @Copyright (C), 2016-2019 hf
* @FileName: Article
* @Author: hf
* @Date: 2019/10/9 21:12
* @Description: 文章实体类
*/
@Getter
@Setter
@AllArgsConstructor
public class Article {
//标识id
@JestId
private Integer id;
private String author;
private String title;
private String content;
}
- Jest相关操作
@Autowired
JestClient jestClient;
@Test
public void test_jest02() {
//查询表达式
String json = "{\n" +
" \"query\" : {\n" +
" \"match_phrase\" : {\n" +
" \"content\" : \"婚礼\"\n" +
" }\n" +
" },\n" +
" \"highlight\": {\n" +
" \"fields\" : {\n" +
" \"content\" : {}\n" +
" }\n" +
" }\n" +
"}";
//构建搜索
Search search = new Search.Builder(json).addIndex("hf").addType("article").build();
try {
//执行
SearchResult result = jestClient.execute(search);
System.out.println(result.getJsonString());
} catch (IOException e) {
e.printStackTrace();
}
}
@Test
public void test_jest01() {
//1、给ES中索引一个文档
Article article = new Article(2, "陈二", "婚礼邀请", "本人与XX将于yyyy年mm月dd日在XX举行婚礼、欢迎大家参加。");
//构建索引
Index index = new Index.Builder(article).index("hf").type("article").build();
//执行
try {
jestClient.execute(index);
} catch (IOException e) {
e.printStackTrace();
}
}
通过继承ElasticSearchRepository接口操作ES
- pom.xml
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-data-elasticsearchartifactId>
dependency>
dependencies>
- application.yml
spring:
data:
elasticsearch:
cluster-name: elasticsearch-cluster
cluster-nodes: 192.168.44.113:9300,192.168.44.113:9301,192.168.44.113:9302
- ElasticSearchRepository源码
@NoRepositoryBean
public interface ElasticsearchRepository<T, ID extends Serializable> extends ElasticsearchCrudRepository<T, ID> {
<S extends T> S index(S entity);
Iterable<T> search(QueryBuilder query);
Page<T> search(QueryBuilder query, Pageable pageable);
Page<T> search(SearchQuery searchQuery);
Page<T> searchSimilar(T entity, String[] fields, Pageable pageable);
void refresh();
Class<T> getEntityClass();
}
- 自定义BookRepository
package com.hf.boot.repository;
import com.hf.boot.entity.Book;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
import java.util.List;
/**
* @Copyright (C), 2016-2019 hf
* @FileName: BookRepository
* @Author: hf
* @Date: 2019/10/9 21:33
* @Description: 通过 ElasticsearchRepository操作ES
*/
public interface BookRepository extends ElasticsearchRepository<Book,Integer> {
//自定义方法
List<Book> findByBookNameLike(String bookName);
}
-
自定义方法规则
- 参考:https://docs.spring.io/spring-data/elasticsearch/docs/3.0.6.RELEASE/reference/html/#elasticsearch.repositories
- 参考:https://docs.spring.io/spring-data/elasticsearch/docs/3.0.6.RELEASE/reference/html/#elasticsearch.repositories
-
Book实体
package com.hf.boot.entity;
import lombok.*;
import org.springframework.data.annotation.Id;
import org.springframework.data.elasticsearch.annotations.Document;
import org.springframework.data.elasticsearch.annotations.Field;
import org.springframework.data.elasticsearch.annotations.FieldType;
/**
* @Copyright (C), 2016-2019 hf
* @FileName: Book
* @Author: hf
* @Date: 2019/10/9 21:35
* @Description: 书实体
*/
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
@ToString
@Document(indexName = "hf",type = "book")
public class Book {
@Id
private Integer id;
//指定文本类型和分词器
@Field(type = FieldType.Text, analyzer = "ik_max_word")
private String bookName;
private String author;
}
- 相关操作
@Autowired
BookRepository bookRepository;
@Test
public void test_elasticsearchRepository02() {
//查找数据
List<Book> list = bookRepository.findByBookNameLike("西");
System.out.println(list);
}
@Test
public void test_elasticsearchRepository01() {
//索引数据
Book book = new Book(5, "红楼梦", "曹雪芹");
bookRepository.index(book);
}
通过ElasticTemplate操作ES
- 相关操作
@Autowired
ElasticsearchTemplate elasticsearchTemplate;
@Test
public void test_esTemplate02() {
//查找数据
SearchQuery searchQuery = new NativeSearchQueryBuilder()
.withQuery(QueryBuilders.matchQuery("bookName", "ES"))
.withPageable(new PageRequest(0, 10))
.build();
List<Book> list = elasticsearchTemplate.queryForList(searchQuery, Book.class);
System.out.println(list);
}
@Test
public void test_esTemplate01() {
//索引数据
Book book = new Book(5, "ES入门到精通", "ES");
//构建
IndexQuery indexQuery = new IndexQueryBuilder()
.withId(book.getId() + "")
.withObject(book)
.build();
//执行
elasticsearchTemplate.index(indexQuery);
}
