Elasticsearch 2.20 文档篇:更新删除文档

Porter4195 5年前

来自: http://my.oschina.net/secisland/blog/614513


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

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

    我们新建一个文档:

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

参数:

{      "counter" : 1,      "tags" : ["red"]  }

脚本开启功能

    在最新版本的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

参数:

{      "script" : {          "inline": "ctx._source.counter += count",          "params" : {              "count" : 4          }      }  }

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

{    "_index" : "test",    "_type" : "type1",    "_id" : "1",    "_version" : 5,    "found" : true,    "_source" : {      "counter" : 5,      "tags" : [ "red" ]    }  }

在看下面的更新操作:

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

参数:

{      "script" : {          "inline": "ctx._source.tags += tag",          "params" : {              "tag" : "blue"          }      }  }

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

{    "_index" : "test",    "_type" : "type1",    "_id" : "1",    "_version" : 6,    "_shards" : {      "total" : 2,      "successful" : 1,      "failed" : 0    }  }

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

{    "_index" : "test",    "_type" : "type1",    "_id" : "1",    "_version" : 6,    "found" : true,    "_source" : {      "counter" : 5,      "tags" : [ "red", "blue" ]    }  }

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

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

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

参数:

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

然后查询此文档:

{    "_index" : "test",    "_type" : "type1",    "_id" : "1",    "_version" : 7,    "found" : true,    "_source" : {      "counter" : 5,      "tags" : [ "red", "blue" ],      "name_of_new_field" : "value_of_new_field"    }  }

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

删除一列,请求和刚才的一样,参数变为:

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

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

请求参数:

{      "script" : {          "inline": "ctx._source.tags.contains(tag) ? ctx.op = \"delete\" : ctx.op = \"none\"",          "params" : {              "tag" : "blue"          }      }  }

部分文档更新:

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

{      "doc" : {          "name" : "new_name"      }  }

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

{    "_index" : "test",    "_type" : "type1",    "_id" : "1",    "_version" : 23,    "found" : true,    "_source" : {      "counter" : 5,      "tags" : [ "red", "blue" ],      "name" : "new_name"    }  }

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

{      "doc" : {          "name" : "new_name"      },      "detect_noop": false  }

删除文档

    删除文档相对比较简单:

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

返回的内容为:

{      "found": true,       "_index": "test",       "_type": "type1",       "_id": "1",       "_version": 24,       "_shards": {          "total": 2,           "successful": 1,           "failed": 0      }}

则表示删除了此文档。

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