更新文档

更新文档操作既可以完全覆盖现存文档全部字段，又可以部分更新字段（更改现存字段，或添加新字段）。

部分更新

如果你要部分更新文档（如更改现存字段，或添加新字段），你可以在 body 参数中指定一个 doc 参数。这样 doc 参数内的字段会与现存字段进行合并。

  1. $params = [
  2.     'index' => 'my_index',
  3.     'type' => 'my_type',
  4.     'id' => 'my_id',
  5.     'body' => [
  6.         'doc' => [
  7.             'new_field' => 'abc'
  8.         ]
  9.     ]
  10. ];
  12. // Update doc at /my_index/my_type/my_id
  13. $response = $client->update($params);

script 更新

有时你要执行一个脚本来进行更新操作，如对字段进行自增操作或添加新字段。为了执行一个脚本更新，你要提供脚本命令和一些参数：

  1. $params = [
  2.     'index' => 'my_index',
  3.     'type' => 'my_type',
  4.     'id' => 'my_id',
  5.     'body' => [
  6.         'script' => 'ctx._source.counter += count',
  7.         'params' => [
  8.             'count' => 4
  9.         ]
  10.     ]
  11. ];
  13. $response = $client->update($params);

Upserts 更新

Upserts 操作是指“更新或插入”操作。这意味着一个 upsert 操作会先执行 script 更新，如果文档不存在（或是你更新的字段不存在），则会插入一个默认值。

  1. $params = [
  2.     'index' => 'my_index',
  3.     'type' => 'my_type',
  4.     'id' => 'my_id',
  5.     'body' => [
  6.         'script' => 'ctx._source.counter += count',
  7.         'params' => [
  8.             'count' => 4
  9.         ],
  10.         'upsert' => [
  11.             'counter' => 1
  12.         ]
  13.     ]
  14. ];
  16. $response = $client->update($params);