ES-更新现有文档
ES的更新API允许发送文档所需要做的修改,而且API会返回一个答复,告知操作是否成功。
更新流程如下
1. 检索现有的文档。为了使这步奏效,必须打开_source字段,否则ES并不知道原有文档的内容。
2. 进行制定的修改。例如,如果文档是
{"name":"Elasticsearch Denver","organizer":"Lee"}
修改组织者,修改后的文档是
{"name":"Elasticsearch Denver","organizer":"Roy"}
3. 删除旧的文档,在其原有位置索引新的文档(包含修改的内容)。
使用更新API
(1).通过发送部分文档,增加或替换现有文档的一部分。
(2).如果文档不存在,当发送部分文档或者脚本时,请确认文档是否被创建。如果文档之前不存在,可以指定被索引的文档原始内容
(3).发送脚本来更新文档。
1. 发送部分文档
发送部分的文档内容,包含所需要设置的字段值,是更新一个或多个字段最容易的方法。为了实现这个操作,需要将这些信息通过HTTP POST请求发送到该文档URL的_update端点。
先插入一条新文档
curl -XPUT 'localhost:9200/get-together/group/1?pretty' -d '{ "name":"Elasticsearch Denver", "organizer":"Lee" }'
更新
curl -XPOST 'localhost:9200/get-together/group/1/_update?pretty' -d '{ "doc":{ "organizer":"Roy" } }'
这条命令设置了在doc下指定的字段,将其值设置为所提供的值。它并不考虑这些字段之前的值,也不考虑这些字段之前是否存在。如果之前整个文档是不存在的,那么更新操作会失败,并提示文档缺失。
验证
FengZhendeMacBook-Pro:cv FengZhen$ curl 'localhost:9200/get-together/group/1?pretty' { "_index" : "get-together", "_type" : "group", "_id" : "1", "_version" : 2, "found" : true, "_source" : { "name" : "Elasticsearch Denver", "organizer" : "Roy" } }
注意:在更新的时候,要牢记可能存在冲突。例如,如果将分组的组织者修改为”Roy”,还有人将其修改为”Feng”,那么其中一次更新会被另一次覆盖。为了控制这种局面,可以使用版本功能。
2. 使用upsert来创建尚不存在的文档
为了处理更新时文档不存在的情况,可以使用upsert.(update和insert的混成词)
如果被更新的文档不存在,可以在JSON的upsert部分中添加一个初始文档用于索引。
curl -XPOST 'localhost:9200/get-together/group/1/_update?pretty' -d '{ "doc":{ "organizer":"Roy" }, "upsert":{ "name":"Elasticsearch Denver", "organizer":"Roy" } }'
3. 通过脚本来更新文档
(1).默认的脚本语言是Groovy。它的语法和Java相似,但是作为脚本,使用更加简单。
(2).由于更新要获得现有文档的_source内容,修改并重新索引新的文档,因此脚本会修改_source中的字段。使用ctx._source来使用_source,使用ctx._source[字段名]来引用某个指定的字段。
(3).如果需要变量,推荐在params下作为参数单独定义,和脚本本身区分开来。这是因为脚本需要编译,一旦编译完成,就会被缓存。如果使用不同参数,多次运行同样的脚本,脚本只需要编译一次。之后的运行都会从缓存中获取现有脚本。相比每次不同的脚本,这样运行会更快,因为不同的脚本每次都需要编译。
注意:由于安全因素,通过API运行以下脚本可能默认的被禁止,这取决于所运行的ES版本。这成为动态脚本,在elasticsearch.yml中将script.disable_dynamic设置为false,就可以打开这个功能。
curl -XPUT 'localhost:9200/online-shop/shirts/1?pretty' -d '{ "caption":"Learning Elasticsearch", "price":15 }' curl -XPOST 'localhost:9200/online-shop/shirts/1/_update?pretty' -d '{ "script":"ctx._source.price += price_diff", "params":{ "price_diff":10 } }' FengZhendeMacBook-Pro:cv FengZhen$ curl 'localhost:9200/online-shop/_search?pretty' { "took" : 37, "timed_out" : false, "_shards" : { "total" : 5, "successful" : 5, "failed" : 0 }, "hits" : { "total" : 1, "max_score" : 1.0, "hits" : [ { "_index" : "online-shop", "_type" : "shirts", "_id" : "1", "_score" : 1.0, "_source" : { "caption" : "Learning Elasticsearch", "price" : 25 } } ] } }
可以看到,这里使用的是ctx._source.price而不是ctx._source[‘price’].这是指向price字段的另一个方法。
通过版本来实现并发控制
如果同一时刻多次更新都在执行,将面临并发的问题。ES支持并发控制,为每篇文档设置了一个版本号。最初被索引的文档版本是1。当更新操作重新索引它的时候,版本号就设置为2了。如果与此同时另一个更新将版本设置为2,那么就会产生冲突,目前的更新也会失败。可以重试这个更新操作,如果不再有冲突,那么版本就会设置为3.
并发控制流程如下
curl -XPOST 'localhost:9200/online-shop/shirts/1/_update?pretty' -d '{ "script":"Thread.sleep(10000);ctx._source.price = 2" }' curl -XPOST 'localhost:9200/online-shop/shirts/1/_update?pretty' -d '{ "script":"ctx._source.caption = \"Knowing Elasticsearch\"" }'
(1).索引文档然后更新它
(2).更新1在后台启动,有一定时间的等待(睡眠)
(3).在睡眠期间,发出另一个update的指令来修改文档。变化发送在更新1获取原有文档之后、重新索引回去之前。
(4).由于文档的版本已经变为2,更新1就会失败,而不会取消更新2所做的修改。这个时候有就机会重试更新1,然后进行版本为3的修改。
这种并发控制称为乐观锁,因为它允许并行的操作并假设冲突时很少出现的,真的出现时就抛出错误。它和悲观锁是相对的,悲观锁通过锁住可能引起冲突的操作,第一时间预防冲突。
1. 冲突发生时自动重试更新操作
当版本冲突出现的时候,可以再应用程序中处理。如果是更新操作,可以再次尝试,但是也可以通过设置retry_on_conflict参数,让ES自动重试
curl -XPOST 'localhost:9200/online-shop/shirts/1/_update?retry_on_conflict=3' -d '{ "script":"ctx._source.price = 2" }'
2.索引文档的时候使用版本号
更新文档的另一个方法是不使用更新API,而是在同一个索引、类型和ID之处索引一个新的文档。这样的操作会覆盖现有的文档,这种情况下仍然可以使用版本字段来进行并发控制。为了实现这一点,要设置HTTP请求中的version参数。其值应该是期望该文档要拥有的版本号(当前的版本号)。如:如果认为现有的版本已经是3,一个重新索引的请求如下
curl -XPUT 'localhost:9200/online-shop/shirts/1?version=3' -d '{ "caption":"i konw about es versioning", "price":"5" }'
如果现有的版本实际上不是3,name这个操作就会抛出版本冲突异常并失败。
有了版本号就可以安全的索引和更新文档了。
使用外部版本
目前为止都是使用ES的内部版本,每次操作,无论是索引还是更新,ES都会自动的增加版本号。如果数据源是另一个数据存储,也许在那里有版本控制系统。例如,一种基于时间戳的系统。
为了使用外部版本,需要为每次请求添加version_type=external,以及版本号
curl -XPUT 'localhost:9200/online-shop/shirts/1?version=4&version_type=external' -d '{ "caption":"i konw about es versioning", "price":"5" }'
这将使ES接受任何版本号,只要比现有版本高,而且ES也不会自己增加版本号。