22.external version
主要知识点
基于external version进行乐观锁并发控制
es提供了一个feature,就是说,你可以不用它提供的内部_version版本号来进行并发控制,可以基于你自己维护的一个版本号来进行并发控制。举个列子,假如你的数据在mysql里也有一份,然后你的应用系统本身就维护了一个版本号,无论是什么自己生成的,程序控制的。这个时候,你进行乐观锁并发控制的时候,可能并不是想要用es内部的_version来进行控制,而是用你自己维护的那个version来进行控制。
内部版本号的用法:?version=1
外部版本号的用法: ?version=1&version_type=external
version_type=external和内部版本号控制唯一的区别在于,当使用内部_version时,只有当你提供的version与es中的_version一模一样的时候,才可以进行修改,如果不一样则会报错;当version_type=external的时候,只有当你提供的version比es中的_version大的时候,才能完成修改,其他情况则报错。
例如:在es中,_version=1,?version=1,才能更新成功
在es中,_version=1,?version>1&version_type=external,才能成功,比如当?version=2&version_type=external时才能修改成功
用法举例
1、先构造一条数据
PUT /test_index/test_type/8
{
"test_field": "test"
}
结果如下:
{
"_index": "test_index",
"_type": "test_type",
"_id": "8",
"_version": 1,
"result": "created",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
},
"created": true
}
2、模拟两个客户端同时查询到这条数据(在浏览器中新开一个网页就行)
GET /test_index/test_type/8
结果如下:
{
"_index": "test_index",
"_type": "test_type",
"_id": "8",
"_version": 1,
"found": true,
"_source": {
"test_field": "test"
}
}
3、第一个客户端先进行修改
此时客户端程序是在自己的数据库中获取到了这条数据的最新版本号,比如说是2
PUT /test_index/test_type/8?version=2&version_type=external
{
"test_field": "test client 1"
}
执行结果如下:
{
"_index": "test_index",
"_type": "test_type",
"_id": "8",
"_version": 2,
"result": "updated",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
},
"created": false
}
4、模拟第二个客户端进行修改
第二个客户端同时拿到了自己数据库中维护的那个版本号也是2,同时基于version=2发起修改
PUT /test_index/test_type/8?version=2&version_type=external
{
"test_field": "test client 2"
}
结果如下,可以看到修改不成功,原因是客户端1进行了修改,此时版本号就是2,发起修改时的版本号不大于2,所以修改不成功。
{
"error": {
"root_cause": [
{
"type": "version_conflict_engine_exception",
"reason": "[test_type][8]: version conflict, current version [2] is higher or equal to the one provided [2]",
"index_uuid": "6m0G7yx7R1KECWWGnfH1sw",
"shard": "1",
"index": "test_index"
}
],
"type": "version_conflict_engine_exception",
"reason": "[test_type][8]: version conflict, current version [2] is higher or equal to the one provided [2]",
"index_uuid": "6m0G7yx7R1KECWWGnfH1sw",
"shard": "1",
"index": "test_index"
},
"status": 409
}
5、在并发控制成功后,重新基于最新的版本号发起更新
(1)先用GET得到最新的版本号
GET /test_index/test_type/8
结果如下:得到 "_version": 2,
{
"_index": "test_index",
"_type": "test_type",
"_id": "8",
"_version": 2,
"found": true,
"_source": {
"test_field": "test client 1"
}
}
(2)再在"_version": 2的基础上进行更新,这一次version=3
PUT /test_index/test_type/8?version=3&version_type=external
{
"test_field": "test client 2"
}
结果如下:可以看出更新成功
{
"_index": "test_index",
"_type": "test_type",
"_id": "8",
"_version": 3,
"result": "updated",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
},
"created": false
}