[翻译]ElasticSearch官方文档-数据的修改

本文翻译自：www.elastic.co/guide/en/el…

本文是Elasticsearch的入门文档，将会介绍ElasticSearch中关于修改，更新和删除数据的相关操做。

修改数据

Elasticsearch近乎实时提供数据操做和搜索功能。默认状况下，你能够在你索引/更新/删除操做数据的一秒钟延迟（刷新间隔）后，看到其出如今搜索结果中。这是与其余平台（如SQL）的重要区别，这类型的平台数据在事务完成后能够当即使用。

索引和替换文档

咱们之前看过咱们如何索引一个文档。以下：

PUT /customer/external/1?pretty
{
  "name": "John Doe"
}复制代码

接下来，将上述将指定的文档索引到外部类型，ID为1的自定义索引。若是咱们再次使用不一样的（或相同）文档执行上述命令，Elasticsearch将替换（即从新索引），新的文档现有的ID为1，且出如今顶部：

PUT /customer/external/1?pretty
{
  "name": "Jane Doe"
}复制代码

以上将ID为1的文档的名称从“John Doe”更改成“Jane Doe”。另外一方面，若是咱们使用不一样的ID，则新的文档将被编入索引，而且已经在索引中的现有文档保持不变(至关于复制)，以下：

PUT /customer/external/2?pretty
{
  "name": "Jane Doe"
}复制代码

以上索引为一个ID为2的新文档。索引时，ID部分是可选的。若是没有指定，Elasticsearch将生成一个随机ID，而后使用它来对文档进行索引。索引API调用的返回值中包含Elasticsearch生成的实际ID（或者咱们在前面的例子中明确指定的任何内容）。

此示例显示如何索引没有显式ID的文档：

POST /customer/external?pretty
{
  "name": "Jane Doe"
}复制代码

请注意，在上述状况下，咱们使用POST动词而不是PUT，由于咱们没有指定ID。

更新文档

除了可以索引和替换文档外，咱们还能够更新文档。注意，虽然Elasticsearch实际上并无在底层进行及时更新。每当咱们进行更新时，Elasticsearch都会删除旧的文档，而后对一个新文档进行索引（至关于复制），同时更新一次应用更新。

此示例显示如何经过将名称字段更改成“Jane Doe”，以此来更新咱们之前的文档（ID为1）：

POST /customer/external/1/_update?pretty
{
  "doc": { "name": "Jane Doe" }
}复制代码

此示例显示如何经过将名称字段更改成“Jane Doe”来更新咱们之前的文档（ID为1），同时在其中添加一个年龄字段：

POST /customer/external/1/_update?pretty
{
  "doc": { "name": "Jane Doe", "age": 20 }
}复制代码

也可使用简单的脚原本执行更新。此示例使用脚本将年龄增长5：

POST /customer/external/1/_update?pretty
{
  "script" : "ctx._source.age += 5"
}复制代码

在上面的例子中，ctx._source是指当前的源文档即将被更新。

请注意，在撰写本文时，一次只能对单个文档执行更新。在未来，Elasticsearch可能会提供给予查询条件的多个文档的更新功能（如SQL UPDATE-WHERE语句）。

删除文档

删除文档是至关简单的。此示例显示如何删除咱们以前的ID为2的客户：

DELETE /customer/external/2?pretty复制代码

请参阅_delete_by_query API以删除与特定查询相匹配的全部文档。值得注意的是，删除整个索引效率更高，而不是使用“按查询删除”API删除符合的文档。

批量处理

除了可以索引，更新和删除单个文档以外，Elasticsearch还提供了使用_bulk API批量执行上述任何操做的功能。这个功能很重要，由于它提供了一个很是有效的机制来尽量快地进行多个操做，尽量少的网络往返行程。

做为一个快速示例，如下调用在一个批量操做中指定两个文档（ID 1 - John Doe和ID 2 - Jane Doe）：

POST /customer/external/_bulk?pretty
{"index":{"_id":"1"}}
{"name": "John Doe" }
{"index":{"_id":"2"}}
{"name": "Jane Doe" }复制代码

此示例更新第一个文档（ID为1），而后在一个批量操做中删除第二个文档（ID为2）：

POST /customer/external/_bulk?pretty
{"update":{"_id":"1"}}
{"doc": { "name": "John Doe becomes Jane Doe" } }
{"delete":{"_id":"2"}}复制代码

请注意，对于删除操做，在它以后没有相应的源文档，由于删除只须要待删除的文档的ID。

因为其中一个操做失败，Bulk API不会失败。若是一个单一的动做因为任何缘由而失败，它将继续处理其后的其他动做。当批量API返回时，它将为每一个操做提供一个状态（按照发送的相同顺序），以便·能够检查特定操做是否失败。