实践Elasticsearch rest风格基本操作

实践Elasticsearch rest风格基本操作

创建索引

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

含义创建一个名字是shopping的索引：

postman发送Rest风格的请求之后得到的响应信息

{
"acknowledged"【响应结果】 : true, # true 操作成功
"shards_acknowledged"【分片结果】 : true, # 分片操作成功
"index"【索引名称】 : "shopping"
}

注意：创建索引库的分片数默认 1 片，在 7.0.0 之前的 Elasticsearch 版本中，默认 5 片

添加重复索引会返回报错信息。

查看索引

查看所有的索引

在 Postman 中，向 ES 服务器发 GET 请http://127.0.0.1:9200/_cat/indices?v

这里请求路径中的_cat 表示查看的意思， indices 表示索引，所以整体含义就是查看当前 ES

服务器中的所有索引，就好像 MySQL 中的 show tables 的感觉，服务器响应结果如下

对应返回表字段的含义

查看单个索引信息

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

查看索引向 ES 服务器发送的请求路径和创建索引是一致的。但是 HTTP 方法不一致。

这里可以体会一下 RESTful 的意义，请求后，服务器响应结果如下

{
    "shopping": {
        "aliases": {},
        "mappings": {},
        "settings": {
            "index": {
                "creation_date": "1644401307985",
                "number_of_shards": "1",
                "number_of_replicas": "1",
                "uuid": "loWEmL2FT7amZyTbiKnzvQ",
                "version": {
                    "created": "7060299"
                },
                "provided_name": "shopping"
            }
        }
    }
}

{
“shopping”【索引名】 : {
“aliases”【别名】 : {},
“mappings”【映射】 : {},
“settings”【设置】 : {
“index”【设置 - 索引】 : {
“creation_date”【设置 - 索引 - 创建时间】 : “1614265373911”,
“number_of_shards”【设置 - 索引 - 主分片数量】 : “1”,
“number_of_replicas”【设置 - 索引 - 副分片数量】 : “1”,
“uuid”【设置 - 索引 - 唯一标识】 : “eI5wemRERTumxGCc1bAk2A”,
“version”【设置 - 索引 - 版本】 : {
“created”: “7080099”
},
“provided_name”【设置 - 索引 - 名称】 : “shopping”
}
}
}
}

删除索引

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

{
“acknowledged”: true
}

文档操作

创建文档

索引已经创建好了，接下来我们来创建文档，并添加数据。这里的文档可以

类比为关系型数据库中的表数据，添加的数据格式为 JSON 格式

在 Postman 中，向 ES 服务器发 POST 请求 ：

http://127.0.0.1:9200/shopping/_doc

请求体内容为：

{
"title":"小米手机",
"category":"小米",
"images":"http://www.gulixueyuan.com/xm.jpg",
"price":3999.00
}

创建文档之后返回的响应数据

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "JgYS3n4BBchQMTo5WfgL",
    "_version": 1,
    "result": "created",
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed": 0
    },
    "_seq_no": 0,
    "_primary_term": 1
}

{
"_index"【索引】 : "shopping",
"_type"【类型-文档】 : "_doc",
"_id"【唯一标识】 : "Xhsa2ncBlvF_7lxyCE9G", #可以类比为 MySQL 中的主键，随机生成
"_version"【版本】 : 1,
"result"【结果】 : "created", #这里的 create 表示创建成功
"_shards"【分片】 : {
"total"【分片 - 总数】 : 2,
"successful"【分片 - 成功】 : 1,
"failed"【分片 - 失败】 : 0
},
"_seq_no": 0,
"_primary_term": 1
}

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

如果想要自定义唯一性标识，需要在创建时指定：

http://127.0.0.1:9200/shopping/_doc/1

此处需要注意：如果增加数据时明确数据主键，那么请求方式也可以为 PUT

查询索引中的文档信息

主键查询

需要指明文档的唯一性标识，类似于 MySQL 中数据的主键查询
在 Postman 中，向 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": 5999.00
    }
}

{
"_index"【索引】 : "shopping",
"_type"【文档类型】 : "_doc",
"_id": "1",
"_version": 2,
"_seq_no": 2,
"_primary_term": 2,
"found"【查询结果】 : true, # true 表示查找到， false 表示未查找到
"_source"【文档源信息】 : {
"title": "华为手机",
"category": "华为",
"images": "http://www.gulixueyuan.com/hw.jpg",
"price": 5999.00
	}
}

所有数据查询

_search查询全部的数据

127.0.0.1:9200/shopping/_search

返回的json响应数据

{
    "took": 202,
    "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": "JgYS3n4BBchQMTo5WfgL",
                "_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": 5999.00
                }
            }
        ]
    }
}

文档修改

全局修改测试

和新增文档一样，输入相同的 URL 地址请求，如果请求体变化，会将原有的数据内容覆盖
在 Postman 中，向 ES 服务器发 POST 请求 ： http://127.0.0.1:9200/shopping/_doc/1

全局修改之后文档中的信息发生了变化。

局部修改

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

将价格的信息进行局部的修改

{
	"doc": {
	"price":3000.00
	}
}

再次进行查询可以发现指定的数据部分已经发生了改变

文档删除

删除一个文档不会立即从磁盘上移除，它只是被标记成已删除（逻辑删除）。
在 Postman 中，向 ES 服务器发 DELETE 请求 ： http://127.0.0.1:9200/shopping/_doc/1

返回响应的json数据如下所示

{
    "_index": "shopping",
    "_type": "_doc",
    "_id": "JgYS3n4BBchQMTo5WfgL",
    "_version": 2,
    "result": "deleted",
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed": 0
    },
    "_seq_no": 4,
    "_primary_term": 1
}

含义说明

{
	"_index": "shopping",
	"_type": "_doc",
	"_id": "1",
	"_version": 1,
	"result"【结果】 : "not_found", # not_found 表示未查找到
	"_shards": {
	"total": 2,
	"successful": 1,
	"failed": 0
	},
	"_seq_no": 5,
	"_primary_term": 2
}