Elasticsearch REST API

1.集群

1.1.查看集群健康值

REST API

GET _cat/health?v

使用curl请求，其他API请求方式相同

curl http://127.0.0.1:9200/_cat/health?v

有用户认证的请求方式

curl -u dd http://127.0.0.1:9200/_cat/health?v

1.2.查看集群节点信息（包含ES版本号）

GET _nodes/settings

1.3.查看节点负载

GET _cat/nodes?v

1.4.查看线程池

GET _cat/thread_pool?v

可以用h参数查看指定内容

GET _cat/nodes?v&h=name,ram.percent,ram.max,heap.current,heap.max,disk.used,disk.total

1.5.查看节点统计信息

GET _nodes/stats

1.6.查看当前执行的任务

GET _cat/tasks?v

1.7.查看活跃线程

GET _nodes/hot_threads?type=cpu&interval=10s

2.查看所有索引

GET _cat/indices?v

• v：显示列名
  按文档数量排序

GET _cat/indices?s=docs.count

按索引大小排序

curl http://localhost:9200/_cat/indices?bytes=b | sort -rnk9 |grep -v ?v

3.查看索引结构（mapping）

GET /user/_mapping?pretty

• pretty：返回结果的格式美观易读

4.创建索引

索引名规则：

• 索引名不能包含以下字符：\ / * ? " < > | 空格 , #
• 7.0以前可以包含冒号，7.0之后不支持
• 不能以- _ +开头
• 不能是.或..
• 最大长度为255字节

4.1.只创建索引

REST APT

PUT myIndex

使用curl请求

curl -X PUT http://127.0.0.1:9200/user

4.2.创建索引时指定mapping

PUT myIndex
{
  "mappings": {
    "user": {
      "properties": {
        "name": { "type": "text" },
        "user_name": { "type": "keyword" },
        "email": { "type": "keyword" }
      }
    }
  }
}

4.3.Elasticsearch 7.x创建索引

Elasticsearch 7.x去除了type，API仍然兼容老的方式，但需要增加include_type_name参数，否则会报错，include_type_name或include_type_name=true都可以，不加参数默认为false。

PUT myIndex?include_type_name
{
  "mappings": {
    "user": {
      "properties": {
        "name": { "type": "text" },
        "user_name": { "type": "keyword" },
        "email": { "type": "keyword" }
      }
    }
  }
}

不包含type方式（推荐），由于8.x在API层面也去除了type，不兼容老的方式，所以建议使用该方式创建索引。

PUT myIndex
{
  "mappings": {
    "properties": {
      "name": { "type": "text" },
      "user_name": { "type": "keyword" },
      "email": { "type": "keyword" }
    }
  }
}

4.4.创建索引时手动指定索引配置

PUT no_replicas
{
  "settings": {
    "number_of_shards": 1, 
    "number_of_replicas": 0
  }
}

5.创建mapping

mapping可以在创建时指定，也可以在索引创建之后指定。

PUT /myIndex/myType/_mapping
{
  "properties": {
    "name": {
      "type": "text"
    },
    "user_name": {
      "type": "keyword"
    },
    "email": {
      "type": "keyword"
    }
  }
}

6.字段类型

6.1.keyword

keyword类型不会对值进行分词，该类型的字段只用来排序、聚合，如邮箱地址、手机号、邮编等。keyword类型的字段只能被精确搜索，不能模糊搜索。

6.2.text

text类型的字段，用来存放文本类数据。该类型字段在被索引之前，整个字符串会被分词器分成多个关键词，搜索时，可以对关键词进行搜素。text类型字段不能排序，也很少用来聚合。可以通过analyzer属性来指定字段的分词器，如ik分词器。

"mappings":{
      "my_type":{
         "properties":{
            "title": {
               "type":"text",
               "analyzer":"ik_max_word"
            }
         }
      }
   }

7.聚合查询

查询字段中各值的数量

POST myIndex/_search?pretty
 {
      "size":0,
      "aggs":{
         "group_by_source":{
              "terms":{
               "field":"fieldName"
              }
           }
       }
 }

8.Ingest pipelines

8.1.将已有索引通过pipelines处理并刷新数据

POST myIndex/_update_by_query?pipeline=my-pipeline

9.搜索

9.1.搜索指定的type（V7以下版本）

ES V7以下版本存在type，V7以上版本，都固定为_doc，但兼容老的API，type处可填_doc（和不填一样效果）

GET /myIndex/myType/_search

10.打开关闭索引

打开索引

POST /myIndex/_open

关闭索引

POST /myIndex/_close