scripts of type [inline], operation [update] and lang [groovy] are disabled

  Elasticsearch的更新文档API准许通过脚本操作来更新文档。更新操作从索引中获取文档，执行脚本，然后获得返回结果。它使用版本号来控制文档获取或者重建索引。

 备注：在Elasticsearch中的更新操作是完全从新索引文件。

    我们新建一个文档：

请求：PUT http://localhost:9200/test/type1/1?pretty

参数：

[java]  view plain  copy

1. {  
2.     "counter" : 1,  
3.     "tags" : ["red"]  
4. }  

脚本开启功能

    在最新版本的Elasticsearch中,基于安全考虑(如果用不到,请保持禁用),默认禁用了动态脚本功能.如果被禁用，在使用脚本的时候则报以下的错误：

scripts of type [inline], operation [update] and lang [groovy] are disabled

    可以用以下方式完全开启动态脚本功能，在config/elasticsearch.yml文件,在最后添加以下代码：

script.inline: on

script.indexed: on

script.file: on

配置后，重启Elasticsearch。

下面我们用脚本来更新此文档。

请求：POST http://localhost:9200/test/type1/1/_update?pretty

参数：

[java]  view plain  copy

1. {  
2.     "script" : {  
3.         "inline": "ctx._source.counter += count",  
4.         "params" : {  
5.             "count" : 4  
6.         }  
7.     }  
8. }  

执行完后，我们在查询一下文档内容，可以发现counter的值为5：

[java]  view plain  copy

1. {  
2.   "_index" : "test",  
3.   "_type" : "type1",  
4.   "_id" : "1",  
5.   "_version" : 5,  
6.   "found" : true,  
7.   "_source" : {  
8.     "counter" : 5,  
9.     "tags" : [ "red" ]  
10.   }  
11. }  

在看下面的更新操作：

请求：POST http://localhost:9200/test/type1/1/_update?pretty

参数：

[java]  view plain  copy

1. {  
2.     "script" : {  
3.         "inline": "ctx._source.tags += tag",  
4.         "params" : {  
5.             "tag" : "blue"  
6.         }  
7.     }  
8. }  

返回的内容为，表示更新成功，我们看一下_version为6，比刚才的值增加了1：

[java]  view plain  copy

1. {  
2.   "_index" : "test",  
3.   "_type" : "type1",  
4.   "_id" : "1",  
5.   "_version" : 6,  
6.   "_shards" : {  
7.     "total" : 2,  
8.     "successful" : 1,  
9.     "failed" : 0  
10.   }  
11. }  

然后我们在查询一下文档内容：

[java]  view plain  copy

1. {  
2.   "_index" : "test",  
3.   "_type" : "type1",  
4.   "_id" : "1",  
5.   "_version" : 6,  
6.   "found" : true,  
7.   "_source" : {  
8.     "counter" : 5,  
9.     "tags" : [ "red", "blue" ]  
10.   }  
11. }  

在脚本中除了_source外其他内置参数也可以使用，例如_index, _type, _id, _version, _routing, _parent, _timestamp, _ttl。

下面我们通过脚本增加一列。

请求：POST http://localhost:9200/test/type1/1/_update?pretty

参数：

[java]  view plain  copy

1. {  
2.     "script" : "ctx._source.name_of_new_field = \"value_of_new_field\""  
3. }  

然后查询此文档：

[java]  view plain  copy

1. {  
2.   "_index" : "test",  
3.   "_type" : "type1",  
4.   "_id" : "1",  
5.   "_version" : 7,  
6.   "found" : true,  
7.   "_source" : {  
8.     "counter" : 5,  
9.     "tags" : [ "red", "blue" ],  
10.     "name_of_new_field" : "value_of_new_field"  
11.   }  
12. }  

从中可以看出，文档中又增加了一列。

删除一列，请求和刚才的一样，参数变为：

[java]  view plain  copy

1. {  
2.     "script" : "ctx._source.remove(\"name_of_new_field\")"  
3. }  

甚至可以通过表达式来判断做某些事情，例如：下面的示例将删除的文件如果标签字段包含蓝色，否则什么也不做（空）：

请求参数：

[java]  view plain  copy

1. {  
2.     "script" : {  
3.         "inline": "ctx._source.tags.contains(tag) ? ctx.op = \"delete\" : ctx.op = \"none\"",  
4.         "params" : {  
5.             "tag" : "blue"  
6.         }  
7.     }  
8. }  

部分文档更新：

    该更新接口还支持更新部分文档，将文档合并到现有文档中（简单的递归合并、对象的内部合并、替换核心的“键/值”和数组）。例如：

[java]  view plain  copy

1. {  
2.     "doc" : {  
3.         "name" : "new_name"  
4.     }  
5. }  

更新后，可以发现文档中多了一列name。

[java]  view plain  copy

1. {  
2.   "_index" : "test",  
3.   "_type" : "type1",  
4.   "_id" : "1",  
5.   "_version" : 23,  
6.   "found" : true,  
7.   "_source" : {  
8.     "counter" : 5,  
9.     "tags" : [ "red", "blue" ],  
10.     "name" : "new_name"  
11.   }  
12. }  

    当文档指定的值与现有的_source合并。当新的文档和老的文档不一致的时候，文档将会被从新建立索引。当新旧文档一样的时候，则不进行从建索引的操作。可以通过设置detect_noop为false，让任何情况下都从新建立索引，例如下面的更新操作：

[java]  view plain  copy

1. {  
2.     "doc" : {  
3.         "name" : "new_name"  
4.     },  
5.     "detect_noop": false  
6. }  

删除文档

    删除文档相对比较简单：

请求：DELETE http://localhost:9200/test/type1/1

返回的内容为：

[java]  view plain  copy

1. {  
2.     "found": true,   
3.     "_index": "test",   
4.     "_type": "type1",   
5.     "_id": "1",   
6.     "_version": 24,   
7.     "_shards": {  
8.         "total": 2,   
9.         "successful": 1,   
10.         "failed": 0  
11.     }}  

则表示删除了此文档。

    赛克蓝德(secisland)后续会逐步对Elasticsearch的最新版本的各项功能进行分析，近请期待。也欢迎加入secisland公众号进行关注。