Elasticsearch系统学习（八）-partial update

一、partial update介绍

1.1、什么是partial update？

1）PUT /index/type/id

创建文档&替换文档，是一样的语法。一般对应到应用程序中，每次的执行流程基本是这样的：

（1）应用程序先发起一个get请求，获取到document，展示到前台界面，供用户查看和修改
（2）用户在前台界面修改数据，发送到后台
（3）后台代码，会将用户修改的数据在内存中进行执行，然后封装好修改后的全量数据
（4）然后发送PUT请求，到es中，进行全量替换
（5）es将老的document标记为deleted，然后重新创建一个新的document

2）partial update

语法格式：

post /index/type/id/_update 
{
   "doc": {
      "要修改的少数几个field即可，不需要全量的数据"
   }
}

3）图解partial update实现原理以及其优点

4）partial update操作示例

PUT /test_index/test_type/10
{
  "test_field1": "test1",
  "test_field2": "test2"
}

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "10",
  "_version": 1,
  "result": "created",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  },
  "created": true
}

POST /test_index/test_type/10/_update
{
  "doc": {
    "test_field2": "updated test2"
  }
}

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "10",
  "_version": 2,
  "result": "updated",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}

GET /test_index/test_type/10

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "10",
  "_version": 2,
  "found": true,
  "_source": {
    "test_field1": "test1",
    "test_field2": "updated test2"
  }
}

二、基于groovy脚本实现partial update

es是有个内置的脚本支持，可以基于groovy脚本实现各种各样的复杂操作

创建测试数据：

PUT /test_index/test_type/11
{
  "num": 0,
  "tags": []
}

2.1、使用内置脚本

POST /test_index/test_type/11/_update
{
  "script": "ctx._source.num+=1"   #使用内置脚本使num加1
}

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "11",
  "_version": 2,
  "result": "updated",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}

GET /test_index/test_type/11

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "11",
  "_version": 2,
  "found": true,
  "_source": {
    "num": 1,
    "tags": []
  }
}

2.2、使用外部脚本

在es的安装目录下config/scripts下编写groovy脚本，名称为test-add-tags.groovy

ctx._source.tags+=new_tag

在界面操作：

POST /test_index/test_type/11/_update
{
  "script": {
    "lang": "groovy",  #缺少,报错Unable to find on disk file script [test-add-tags] using lang [painless]
    "file": "test-add-tags",
    "params": {
      "new_tag": "tag1"
    }
  }
}

GET /test_index/test_type/11

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "11",
  "_version": 3,
  "found": true,
  "_source": {
    "num": 1,
    "tags": [
      "tag1"   #新加的tag
    ]
  }
}

2.3、使用脚本删除文档

编写groovy脚本test-delete-document.groovy：

ctx.op = ctx._source.num == count ? 'delete' : 'none'  #如果num等于count，就删除该document，否则不执行相关操作

界面操作：

POST /test_index/test_type/11/_update
{
  "script": {
    "lang": "groovy",
    "file": "test-delete-document",
    "params": {
      "count": 1
    }
  }
}

GET /test_index/test_type/11

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "11",
  "found": false
}

2.4、upsert操作

在2.3中已经将document删除了，再次执行_update操作会报错

POST /test_index/test_type/11/_update
{
  "doc": {
    "num": 1
  }
}

{
  "error": {
    "root_cause": [
      {
        "type": "document_missing_exception",
        "reason": "[test_type][11]: document missing",  #document未找到
        "index_uuid": "6t1NqhChSpyuYY7m-Eq2jA",
        "shard": "4",
        "index": "test_index"
      }
    ],
    "type": "document_missing_exception",
    "reason": "[test_type][11]: document missing",
    "index_uuid": "6t1NqhChSpyuYY7m-Eq2jA",
    "shard": "4",
    "index": "test_index"
  },
  "status": 404
}

如果指定的document不存在，就执行upsert中的初始化操作；如果指定的document存在，就执行doc或者script指定的partial update操作

POST /test_index/test_type/11/_update
{
  "script": "ctx._source.num+=1",
  "upsert": {
    "num": 0,
    "tags": []
  }
}

#因为document不存在，执行了初始化操作
GET /test_index/test_type/11

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "11",
  "_version": 1,
  "found": true,
  "_source": {
    "num": 0,
    "tags": []
  }
}

#当再次执行post时，因为文档已经存在，就将num+1
POST /test_index/test_type/11/_update
{
  "script": "ctx._source.num+=1",
  "upsert": {
    "num": 0,
    "tags": []
  }
}

{
  "_index": "test_index",
  "_type": "test_type",
  "_id": "11",
  "_version": 2,
  "found": true,
  "_source": {
    "num": 1,
    "tags": []
  }
}

三、partial update内置乐观锁并发控制

我们可以使用retry_on_conflict和_version，采取retry策略及基于指定的版本好去更新

post /index/type/id/_update?retry_on_conflict=5&version=6