Elasticsearch实战(四)-Kibana常见RESTful API操作

1 document数据格式

1.1 面向文档的搜索分析引擎

(1)应用系统的数据结构都是面向对象的,复杂的

(2)对象数据存储到数据库中,只能拆解开来,变为扁平的多张表,每次查询的时候还得还原回对象格式,相当麻烦

(3)ES是面向文档的,文档中存储的数据结构,与面向对象的数据结构是一样的,基于这种文档数据结构,es可以提供复杂的索引,全文检索,分析聚合等功能

(4)es的document用json数据格式来表达


public class Employee {

  private String email;
  private String firstName;
  private String lastName;
  private EmployeeInfo info;
  private Date joinDate;

}

private class EmployeeInfo {
  
  private String bio; // 性格
  private Integer age;
  private String[] interests; // 兴趣爱好

}

EmployeeInfo info = new EmployeeInfo();
info.setBio("curious and modest");
info.setAge(30);
info.setInterests(new String[]{"bike", "climb"});

Employee employee = new Employee();
employee.setEmail("zhangsan@sina.com");
employee.setFirstName("san");
employee.setLastName("zhang");
employee.setInfo(info);
employee.setJoinDate(new Date());

1.2 employee对象

里面包含了Employee类自己的属性,还有一个EmployeeInfo对象


两张表

将employee对象的数据重新拆开来,变成Employee数据和EmployeeInfo数据


employee表

employee表:email,first_name,last_name,join_date,4个字段


employee_info表

employee_info表:bio,age,interests,3个字段;此外还有一个外键字段,比如employee_id,关联着employee表

即 field name 和 field value

{
    "email": "JavaEdge公众号@tech.com",
    "first_name": "公众号",
    "last_name": "JavaEdge",
    "info": {
        "bio":         "curious and modest",
        "age":         30,
        "interests": [ "bike", "climb" ]
    },
    "join_date": "2019/11/17"
}

我们就明白了es的document数据格式和数据库的关系型数据格式的区别


2 电商商品管理后台业务需求


为其基于ES构建一个后台系统,提供以下功能:

(1)对商品信息进行CRUD(增删改查)操作

(2)执行简单的结构化查询

(3)可以执行简单的全文检索,以及复杂的phrase(短语)检索

(4)对于全文检索的结果,可以进行高亮显示

(5)对数据进行简单的聚合分析


3 简单的集群管理

3.1 快速检查集群的健康状况

es提供了一套api,叫做cat api,可以查看es中各种各样的数据

GET /_cat/health?v

Elasticsearch实战(四)-Kibana常见RESTful API操作Elasticsearch实战(四)-Kibana常见RESTful API操作


快速了解集群的健康状况?green、yellow、red?

  • green:每个索引的primary shard和replica shard都是active状态的
  • yellow:每个索引的primary shard都是active状态的,但是部分replica shard不是active状态,处于不可用的状态
  • red:不是所有索引的primary shard都是active状态的,部分索引有数据丢失了


为什么会处于一个yellow状态?

我们现在就一个笔记本电脑,就启动了一个es进程,相当于就只有一个node。

现在es中有一个index,就是kibana自己内置建立的index。

由于默认的配置是给每个index分配5个primary shard和5个replica shard,而且primary shard和replica shard不能在同一台机器上(为了容错)。

现在kibana自己建立的index是1个primary shard和1个replica shard。当前就一个node,所以只有1个primary shard被分配了和启动了,但是一个replica shard没有第二台机器去启动。


做一个小实验:此时只要启动第二个es进程,就会在es集群中有2个node,然后那1个replica shard就会自动分配过去,然后cluster status就会变成green状态。


(2)快速查看集群中有哪些索引

  • GET /_cat/indices?v

Elasticsearch实战(四)-Kibana常见RESTful API操作Elasticsearch实战(四)-Kibana常见RESTful API操作


3 Index API 操作

下图中操作,左框内为 requests,右框内为 response

创建索引 - PUT

PUT /索引名


  • PUT /test_index?pretty 对应

Elasticsearch实战(四)-Kibana常见RESTful API操作


  • 老版响应

Elasticsearch实战(四)-Kibana常见RESTful API操作


创建文档时,若index不存在,ES会自动创建对应的indextype

  • PUT /index/type/id

Elasticsearch实战(四)-Kibana常见RESTful API操作


查看现有索引

GET _cat/indices

Elasticsearch实战(四)-Kibana常见RESTful API操作


删除索引:DELETE

DELETE /test_index?pretty

Elasticsearch实战(四)-Kibana常见RESTful API操作


4 Document API 操作

4.1 新增文档


创建文档时,若索引不存在,ES会自动创建对应的indextype


PUT /index/type/id
{
  "JSON 数据":"JavaEdge"
}
{
  "_index" : "index",
  "_type" : "type",
  "_id" : "id",
  "_version" : 1, 每次更新文档都会自增,作为 MVCC 乐观锁机制
  "result" : "created",
  "_shards" : {
    "total" : 2,
    "successful" : 1,
    "failed" : 0
  },
  "_seq_no" : 0,
  "_primary_term" : 1
}


不指定 id 创建文档 API

PUT /index/type
{
  "公众号":"JavaEdge"
}


{
  "_index" : "index",
  "_type" : "type",
  "_id" : "uNLtD3YBqIyYzzh7-hHH", # 不指定时,自动生成
  "_version" : 1,
  "result" : "created",
  "_shards" : {
    "total" : 2,
    "successful" : 1,
    "failed" : 0
  },
  "_seq_no" : 1,
  "_primary_term" : 1
}

ES 会自动建立index和type,不需要提前创建,而且es默认会对document每个field都建立倒排索引,让其可以被搜索

批量创建文档 API

ES允许一次创建多个文档,从而减少网络传输开销,提升写入速率


  • endpoint为 _bulk,如下:

Elasticsearch实战(四)-Kibana常见RESTful API操作Elasticsearch实战(四)-Kibana常见RESTful API操作


4.2 查询文档

指定要查询的文档 id


GET /index/type/id
{
  "_index" : "index",
  "_type" : "type",
  "_id" : "id",
  "_version" : 1,
  "_seq_no" : 0,
  "_primary_term" : 1,
  "found" : true,
  "_source" : {
    "JSON 数据" : "JavaEdge"
  }
}


查询所有文档

GET /index/type/_search
{
  "query":{
    "term":{
      "_id":"1"
    }
  }
}

Elasticsearch实战(四)-Kibana常见RESTful API操作

GET _search
{
  "query": {
    "match_all": {}
  }
}


批量查询文档 API

Elasticsearch实战(四)-Kibana常见RESTful API操作

4.3 修改商品

PUT /ecommerce/product/1
{
    "name" : "jiaqiangban gaolujie yagao",
    "desc" :  "gaoxiao meibai",
    "price" :  30,
    "producer" :      "gaolujie producer",
    "tags": [ "meibai", "fangzhu" ]
}

{
  "_index": "ecommerce",
  "_type": "product",
  "_id": "1",
  "_version": 1,
  "result": "created",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  },
  "created": true
}

{
  "_index": "ecommerce",
  "_type": "product",
  "_id": "1",
  "_version": 2,
  "result": "updated",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  },
  "created": false
}


PUT /ecommerce/product/1
{
    "name" : "jiaqiangban gaolujie yagao"
}


替换方式有一个不好,即使必须带上所有的field,才能去进行信息的修改

4.4 修改商品

POST /ecommerce/product/1/_update
{
  "doc": {
    "name": "jiaqiangban gaolujie yagao"
  }
}

{
  "_index": "ecommerce",
  "_type": "product",
  "_id": "1",
  "_version": 8,
  "result": "updated",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}


上一篇:Elasticsearch 跨集群数据迁移方案总结


下一篇:Android开发9——Activity的启动模式