Elasticsearch-更新现有文档

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" : "",
"_version" : ,
"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":
}'

curl -XPOST 'localhost:9200/online-shop/shirts/1/_update?pretty' -d '{
"script":"ctx._source.price += price_diff",
"params":{
"price_diff":
}
}'

FengZhendeMacBook-Pro:cv FengZhen$ curl 'localhost:9200/online-shop/_search?pretty'
{
"took" : ,
"timed_out" : false,
"_shards" : {
"total" : ,
"successful" : ,
"failed" :
},
"hits" : {
"total" : ,
"max_score" : 1.0,
"hits" : [ {
"_index" : "online-shop",
"_type" : "shirts",
"_id" : "",
"_score" : 1.0,
"_source" : {
"caption" : "Learning Elasticsearch",
"price" :
}
} ]
}
}

可以看到，这里使用的是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":""
}'

如果现有的版本实际上不是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":""
}'

这将使ES接受任何版本号，只要比现有版本高，而且ES也不会自己增加版本号。