沉梦听雨的编程指南
  • 微服务
  • 搜索引擎
沉梦听雨
2025-04-25
目录

Elasticsearch之HTTP篇

# Elasticsearch 之 HTTP 篇

# HTTP 操作

http 调试工具准备，例如：postman、apifox、apipost...

curl 也可

# 1、索引（表）

官方文档：Index APIs | Elasticsearch Guide | Elastic (opens new window)

# 创建 PUT

对比关系型数据库，创建【索引】就等同于创建【表】。

  • 但在使用上，Elasticsearch 的 Index 更强大、更灵活，比如它是分布式的，可以自带分片、复制、副本等能力，MySQL 表通常没有这些。

向 ES 服务器发 PUT 请求：http://127.0.0.1:9200/shopping

  • 请求后，服务器返回响应：
{
    "acknowledged": true,
    "shards_acknowledged": true,
    "index": "shopping"
}
1
2
3
4
5
  • 如果重复发 PUT 请求：http://127.0.0.1:9200/shopping 添加索引，会返回错误信息：
{
    "error": {
        "root_cause": [
            {
                "type": "resource_already_exists_exception",
                "reason": "index [shopping/Z3ALzZdnQzGEJNoNSEGlvw] already exists",
                "index_uuid": "Z3ALzZdnQzGEJNoNSEGlvw",
                "index": "shopping"
            }
        ],
        "type": "resource_already_exists_exception",
        "reason": "index [shopping/Z3ALzZdnQzGEJNoNSEGlvw] already exists",
        "index_uuid": "Z3ALzZdnQzGEJNoNSEGlvw",
        "index": "shopping"
    },
    "status": 400
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 查询 GET

查看所有索引

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/_cat/indices?v

  • 这里请求路径中的 _cat 表示查看的意思，indices 表示索引，
  • 所以整体含义就是查看当前 ES 服务器中的所有索引，就好像 MySQL 中的 show tables 的感觉，
  • 服务器响应结果如下:
health status index    uuid                   pri rep docs.count docs.deleted store.size pri.store.size
yellow open   shopping Z3ALzZdnQzGEJNoNSEGlvw   1   1          0            0       208b           208b
1
2

响应结果说明：

表头 含义
health 当前服务器健康状态：green(集群完整)、yellow(单点正常/集群不完整)、red(单点不正常)
status 索引打开、关闭状态
index 索引名
uuid 索引统一编号
pri 主分片数量
rep 副本数量
docs.count 可用文档数量
docs.deleted 文档删除状态（逻辑删除）
store.size 主分片和副本整体占空间大小
pri.store.size 主分片占空间大小

查看单个索引

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping

  • url 中 shopping 代表 索引名称

返回结果如下：

{
    "shopping": {
        "aliases": {},
        "mappings": {},
        "settings": {
            "index": {
                "creation_date": "1744101764908",
                "number_of_shards": "1",
                "number_of_replicas": "1",
                "uuid": "Z3ALzZdnQzGEJNoNSEGlvw",
                "version": {
                    "created": "7080099"
                },
                "provided_name": "shopping"
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 删除 DELETE

向 ES 服务器发 DELETE 请求：http://127.0.0.1:9200/shopping

返回结果如下：

{
    "acknowledged": true
}
1
2
3

# 2、文档（行）

这里的文档可以类比为关系型数据库中的表数据，添加的数据格式为 JSON 格式。

# 创建 POST

向 ES 服务器发 POST 请求：http://127.0.0.1:9200/shopping/_doc，请求体 JSON 内容为：

{
    "title": "小米手机",
    "category": "小米",
    "images": "http://www.gulixueyuan.com/xm.jpg",
    "price": 3999.00
}
1
2
3
4
5
6

返回结果如下：

{
    "_index": "shopping", //索引
    "_type": "_doc", // 类型-文档
    "_id": "aemnFJYBLUeT2LeerGCL", // 唯一标识，可以类比为 MySQL 中的主键，随机生成
    "_version": 1, // 版本
    "result": "created", // 结果，这里的 create 表示创建成功
    "_shards": {
        "total": 2, // 分片 - 总数
        "successful": 1, // 分片 - 总数
        "failed": 0 // 分片 - 总数
    },
    "_seq_no": 0,
    "_primary_term": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

⚠️注意：

  • 上面的数据创建后，由于没有指定数据唯一性标识（ID），默认情况下， ES 服务器会随机生成一个。

如果想要自定义唯一性标识，需要在创建时指定：http://127.0.0.1:9200/shopping/_doc/1，请求体 JSON 内容为：

{
    "title": "小米手机",
    "category": "小米",
    "images": "http://www.gulixueyuan.com/xm.jpg",
    "price": 3999.00
}
1
2
3
4
5
6

返回结果如下：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1",
    "_version": 1,  // 自定义唯一标识
    "result": "created",
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed": 0
    },
    "_seq_no": 1,
    "_primary_term": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 主键查询 GET

  • 查看文档时，需要指明文档的唯一性标识，类似于 MySQL 中数据的主键查询
  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_doc/1

返回结果如下：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1",
    "_version": 1,
    "_seq_no": 1,
    "_primary_term": 1,
    "found": true,
    "_source": {
        "title": "小米手机",
        "category": "小米",
        "images": "http://www.gulixueyuan.com/xm.jpg",
        "price": 3999.00
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

查找不存在的内容

  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_doc/1001

返回结果如下：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1001",
    "found": false
}
1
2
3
4
5
6

# 查询索引下所有数据 GET

  • 相当于查询某张表下的所有数据
  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search

返回结果如下：

{
    "took": 384,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 2,
            "relation": "eq"
        },
        "max_score": 1.0,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "aemnFJYBLUeT2LeerGCL",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "1",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# 修改 POST

全量修改

和新增文档一样，输入相同的 URL 地址请求，如果请求体变化，会将原有的数据内容覆盖

  • 向 ES 服务器发 POST 请求：http://127.0.0.1:9200/shopping/_doc/1

请求体 JSON 内容为:

{
    "title": "华为手机",
    "category": "华为",
    "images": "http://www.gulixueyuan.com/hw.jpg",
    "price": 4999.00
}
1
2
3
4
5
6

修改成功后，服务器响应结果：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1",
    "_version": 2,
    "result": "updated", // updated 表示数据被更新
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed": 0
    },
    "_seq_no": 4,
    "_primary_term": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

再次进行主键查询，结果如下：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1",
    "_version": 2,
    "_seq_no": 4,
    "_primary_term": 1,
    "found": true,
    "_source": {
        "title": "华为手机",
        "category": "华为",
        "images": "http://www.gulixueyuan.com/hw.jpg",
        "price": 4999.00
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

可以看到，修改成功。

局部修改

修改数据时，也可以只修改某一给条数据的局部信息

向 ES 服务器发 POST 请求：http://127.0.0.1:9200/shopping/_update/1

请求体 JSON 内容为:

{
    "doc": {
        "title": "小米手机",
        "category": "小米"
    }
}
1
2
3
4
5
6

# 删除 DELETE

删除一个文档不会立即从磁盘上移除，它只是被标记成已删除（逻辑删除）。

向 ES 服务器发 DELETE 请求：http://127.0.0.1:9200/shopping/_doc/1

返回结果：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1", // 对应删除标识
    "_version": 4,
    "result": "deleted", // 表示删除成功
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed": 0
    },
    "_seq_no": 6,
    "_primary_term": 2
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

向 ES 服务器发 GET请求：http://127.0.0.1:9200/shopping/_doc/1，查看是否删除成功：

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "1",
    "found": false
}
1
2
3
4
5
6

# 3、映射操作（表结构）

先创建一个索引：

  • 向 ES 服务器发 PUT 请求：http://127.0.0.1:9200/user

# 创建映射 PUT

  • 向 ES 服务器发 PUT 请求：http://127.0.0.1:9200/user/_mapping
  • 附带 JSON 体如下
{
    "properties": {
        "name": {
            "type": "text",
            "index": true
        },
        "sex": {
            "type": "keyword", // 关键词类型，查询的时候不会分词
            "index": true
        },
        "tel": {
            "type": "keyword",
            "index": false // 字段不会被索引，不能用来搜索

        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

映射数据说明：

  • 字段名：任意填写，下面指定许多属性，例如：title、subtitle、images、price
  • type：类型，Elasticsearch 中支持的数据类型非常丰富，说几个关键的：
    • String 类型，又分两种：
      • text：可分词
      • keyword：不可分词，数据会作为完整字段进行匹配
    • Numerical：数值类型，分两类
      • 基本数据类型：long、integer、short、byte、double、float、half_float
      • 浮点数的高精度类型：scaled_float
    • Date：日期类型
    • Array：数组类型
    • Object：对象
  • index：是否索引，默认为 true，也就是说你不进行任何配置，所有字段都会被索引
    • true：字段会被索引，则可以用来进行搜索
    • false：字段不会被索引，不能用来搜索
  • store：是否将数据进行独立存储，默认为 false
    • 原始的文本会存储在 source 里面，默认情况下其他提取出来的字段都不是独立存储 的，是从 source 里面提取出来的
    • 当然你也可以独立的存储某个字段，只要设置 "store":true 即可，获取独立存储的字段要比从 _source 中解析快得多，但是也会占用更多的空间，所以要根据实际业务需求来设置
  • analyzer：分词器，这里的 ik_max_word 即使用 ik 分词器

# 索引映射关联 PUT

  • 创建索引（表）时并创建映射（表结构）
  • 向 ES 服务器发 PUT 请求：http://127.0.0.1:9200/student
  • 附带 JSON 体如下
{
    "mappings": {
        "properties": {
            "name": {
                "type": "text"
            },
            "sex": {
                "type": "keyword"
            },
            "tel": {
                "type": "long",
                "index": false
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 查询映射 GET

  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/user/_mapping

# 4、复杂查询

确保索引下有数据

  • 先向索引（表）中新增多条测试数据

  • 然后查询所有数据，向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search

{
    "took": 661,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 3,
            "relation": "eq"
        },
        "max_score": 1.0,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 1.0,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "qMZfGZYBs2T-OKTlDK1W",
                "_score": 1.0,
                "_source": {
                    "title": "华为手机",
                    "category": "华为",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 5999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# URL 带参查询

查找 category 为小米的文档，

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search?q=category:小米，返回结果如下：

  • 可以看出来，会自动进行分词查询，即会查出 category 包含 小 或 米 的所有数据
{
    "took": 9,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 2,
            "relation": "eq"
        },
        "max_score": 2.5700645,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 2.5700645,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 1.0296195,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# 请求体带参查询

URL 带参数形式查询，这很容易让不善者心怀恶意，或者参数值出现中文会出现乱码情况。

为了避免这些情况，我们可用使用带 JSON 请求体请求进行查询。

接下带 JSON 请求体，还是查找 category 为小米的文档，

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "query": {
        "match": {
            "category": "小米"
        }
    }
}
1
2
3
4
5
6
7

返回结果如下：

{
    "took": 790,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 2,
            "relation": "eq"
        },
        "max_score": 2.5700645,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 2.5700645,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 1.0296195,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# 查询所有文档（请求体）

查找所有文档内容，也可以这样，

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

  • 不带也是同样的效果
{
    "query": {
        "match_all": {}
    }
}
1
2
3
4
5

# 查询指定字段

如果你想查询指定字段，

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

  • 比如，只查询 title 字段
{
    "query": {
        "match_all": {}
    },
    "_source": [
        "title"
    ]
}
1
2
3
4
5
6
7
8

返回结果如下：

{
    "took": 53,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 3,
            "relation": "eq"
        },
        "max_score": 1.0,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机"
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 1.0,
                "_source": {
                    "title": "红米手机"
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "qMZfGZYBs2T-OKTlDK1W",
                "_score": 1.0,
                "_source": {
                    "title": "华为手机"
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# 分页查询

  • from：当前页的起始索引，默认从 0 开始。from = (pageNum - 1) * size
  • size：每页显示多少条

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "query": {
        "match_all": {}
    },
    "from": 0,
    "size": 2
}
1
2
3
4
5
6
7

返回结果如下：

{
    "took": 113,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 3,
            "relation": "eq"
        },
        "max_score": 1.0,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 1.0,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# 排序查询

  • 根据价格进行降序查询

  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "query": {
        "match_all": {}
    },
    "sort": {
        "price": {
            "order": "desc"
        }
    }
}
1
2
3
4
5
6
7
8
9
10

返回结果如下：

{
    "took": 298,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 3,
            "relation": "eq"
        },
        "max_score": null,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "qMZfGZYBs2T-OKTlDK1W",
                "_score": null,
                "_source": {
                    "title": "华为手机",
                    "category": "华为",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 5999.00
                },
                "sort": [
                    5999.0
                ]
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": null,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                },
                "sort": [
                    3999.0
                ]
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": null,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                },
                "sort": [
                    1999.0
                ]
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# 组合查询

  • bool 把各种其它查询通过 must(必须)、must not(必须不)、should(应该) 的方式进行组合

must 与查询

  • 假设想找出小米牌子，价格为 3999 元的。（must 相当于 sql 的 and）
  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：
{
    "query": {
        "bool": {
            "must": [
                {
                    "match": {
                        "category": "小米"
                    }
                },
                {
                    "match": {
                        "price": 3999.00
                    }
                }
            ]
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

返回结果如下：

{
    "took": 119,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 1,
            "relation": "eq"
        },
        "max_score": 2.89712,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 2.89712,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

should 或查询

  • 假设想找出小米和华为牌子。（should 相当于 sql 的 or）
  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：
{
    "query": {
        "bool": {
            "should": [
                {
                    "match": {
                        "category": "小米"
                    }
                },
                {
                    "match": {
                        "category": "华为"
                    }
                }
            ]
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

返回结果如下：

  • 字段不是关键词类型，会分词查询
{
    "took": 13,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 3,
            "relation": "eq"
        },
        "max_score": 1.89712,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 1.89712,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "qMZfGZYBs2T-OKTlDK1W",
                "_score": 1.3862942,
                "_source": {
                    "title": "华为手机",
                    "category": "华为",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 5999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 0.6931471,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# 范围查询

range 查询找出那些落在指定区间内的数字或者时间。range 查询允许以下字符

操作符 说明
gt 大于 >
gte 大于等于 >=
lt 小于 <
lte 小于等于 <=

  • 假设想找出小米和华为的牌子，价格大于 4000 元的手机。

  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "query": {
        "bool": {
            "should": [
                {
                    "match": {
                        "category": "小米"
                    }
                },
                {
                    "match": {
                        "category": "华为"
                    }
                }
            ],
            "filter": {
                "range": {
                    "price": {
                        "gt": 4000
                    }
                }
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

返回结果如下：

{
    "took": 40,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 1,
            "relation": "eq"
        },
        "max_score": 1.3862942,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "qMZfGZYBs2T-OKTlDK1W",
                "_score": 1.3862942,
                "_source": {
                    "title": "华为手机",
                    "category": "华为",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 5999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# 完全匹配

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "query": {
        "match_phrase": {
            "category": "小米"
        }
    }
}
1
2
3
4
5
6
7

返回结果如下：

  • 不会进行分词查询
{
    "took": 65,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 1,
            "relation": "eq"
        },
        "max_score": 1.89712,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 1.89712,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# 高亮查询

向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "query": {
        "match_phrase": {
            "category": "米"
        }
    },
    "highlight": {
        "fields": {
            "category": {} // 高亮这字段
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

返回结果如下：

{
    "took": 403,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 2,
            "relation": "eq"
        },
        "max_score": 0.6931471,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 0.6931471,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                },
                "highlight": {
                    "category": [
                        "小<em>米</em>"
                    ]
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 0.6931471,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                },
                "highlight": {
                    "category": [
                        "红<em>米</em>"
                    ]
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

# 聚合查询

分组查询示例

聚合允许使用者对 es 文档进行统计分析，类似与关系型数据库中的 group by，当然还有很多其他的聚合，例如取最大值 max、平均值 avg 等等。

接下来按 price 字段进行分组：

  • 新增个相同 price 的数据

  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：

{
    "aggs": { //聚合操作
        "price_group": { //名称，随意起名
            "terms": { //分组
                "field": "price" //分组字段
            }
        }
    }
}
1
2
3
4
5
6
7
8
9

返回结果如下：

{
    "took": 1309,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 4,
            "relation": "eq"
        },
        "max_score": 1.0,
        "hits": [
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "psZeGZYBs2T-OKTlWq1C",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "p8ZeGZYBs2T-OKTloK3v",
                "_score": 1.0,
                "_source": {
                    "title": "红米手机",
                    "category": "红米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 1999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "qMZfGZYBs2T-OKTlDK1W",
                "_score": 1.0,
                "_source": {
                    "title": "华为手机",
                    "category": "华为",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 5999.00
                }
            },
            {
                "_index": "shopping",
                "_type": "_doc",
                "_id": "wcbjGZYBs2T-OKTlL62H",
                "_score": 1.0,
                "_source": {
                    "title": "小米手机",
                    "category": "小米",
                    "images": "http://www.gulixueyuan.com/xm.jpg",
                    "price": 3999.00
                }
            }
        ]
    },
    "aggregations": {
        "price_group": {
            "doc_count_error_upper_bound": 0,
            "sum_other_doc_count": 0,
            "buckets": [
                {
                    "key": 3999.0,
                    "doc_count": 2
                },
                {
                    "key": 1999.0,
                    "doc_count": 1
                },
                {
                    "key": 5999.0,
                    "doc_count": 1
                }
            ]
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

不返回原始数据写法：

上面返回结果会附带原始数据的。若不想要不附带原始数据的结果，可以加多个 size 筛选属性：

{
    "aggs": {
        "price_group": {
            "terms": {
                "field": "price"
            }
        }
    },
    "size": 0
}
1
2
3
4
5
6
7
8
9
10

返回结果如下：

{
    "took": 10,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 4,
            "relation": "eq"
        },
        "max_score": null,
        "hits": []
    },
    "aggregations": {
        "price_group": {
            "doc_count_error_upper_bound": 0,
            "sum_other_doc_count": 0,
            "buckets": [
                {
                    "key": 3999.0,
                    "doc_count": 2
                },
                {
                    "key": 1999.0,
                    "doc_count": 1
                },
                {
                    "key": 5999.0,
                    "doc_count": 1
                }
            ]
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

平均值查询示例

  • 向 ES 服务器发 GET 请求：http://127.0.0.1:9200/shopping/_search，附带 JSON 体如下：
{
    "aggs": {
        "price_avg": { // 名称，随意起名
            "avg": { // 求平均
                "field": "price"
            }
        }
    },
    "size": 0
}
1
2
3
4
5
6
7
8
9
10

返回结果如下：

{
    "took": 188,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 4,
            "relation": "eq"
        },
        "max_score": null,
        "hits": []
    },
    "aggregations": {
        "price_avg": {
            "value": 3999.0
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
上次更新: 2025/4/28 17:48:47
Elasticsearch之DSL篇
ffmpeg入门

← ffmpeg入门→

Theme by Vdoing | Copyright © 2023-2025 沉梦听雨 | MIT License