ES6.0.0官方参考指南翻译~入门指南~修改数据

修改数据

Elasticsearch提供了近实时的数据操作和搜索能力.默认情况下，您可以预计从索引/更新/删除您的数据到您搜索结果中显示的时间之间的延迟时间（刷新间隔）将持续一秒。这是与SQL等其他平台（在这些平台中，事务完成后数据立即可用）的重要区别.

索引/替换文档

之前我们已经看过了如何索引单个文档。 让我们再回顾一下那个命令：

PUT /customer/doc/1?pretty
{
 "name": "John Doe"
}

再一次地，上面的操作会将指定文档(ID为1)编排到customer索引中. 如果我们再用不同的（或相同的）文档再次执行上述命令，Elasticsearch会使用现有ID替换原有ID：

PUT /customer/doc/1?pretty
{
 "name": "Jane Doe"
}

上述命令会将ID为1的文档名称从“John Doe”改为“Jane Doe”。 另一方面，如果我们使用不同的ID，则会索引一个新文档，并且索引中已经存在的文档将保持不变。

PUT /customer/doc/2?pretty
{
 "name": "Jane Doe"
}

上述命令会索引一个ID为2的新文档.

在索引时，ID部分是可选的.如果未指定，Elasticsearch会生成一个随机ID，然后使用它来索引文档. Elasticsearch生成的实际ID（或者我们在前面例子中明确指定的）会作为索引API调用的一部分返回。

下面这个例子展示了如何索引没有显式指定ID的文档：

POST /customer/doc?pretty
{
 "name": "Jane Doe"
}

请注意，在上述情况下，我们使用的是POST而非PUT，因为我们没有指定一个ID。

更新文档

除了能索引和替换文档之外，我们也可以更新文档. 请注意，虽然Elasticsearch实际上并没有在原地进行更新，而是每当我们进行更新时，Elasticsearch会删除旧的文档，然后索引一个新的文档，一次性地应用更新。

下面的示例展示了如何通过将名称字段更改为“Jane Doe”来更新以前的文档（ID为1）：

POST /customer/doc/1/_update?pretty
{
 "doc": { "name": "Jane Doe" }
}

下面这个例子展示了如何通过改变name字段为“Jane Doe”来更新我们以前的文档（ID为1），同时为其添加一个age字段：

POST /customer/doc/1/_update?pretty
{
 "doc": { "name": "Jane Doe", "age": 20 }
}

更新也可以通过简单的脚本来执行. 此示例会使用脚本来将age加5:

POST /customer/doc/1/_update?pretty
{
 "script" : "ctx._source.age += 5"
}

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

Elasticsearch提供了在给定查询条件（如SQL UPDATE-WHERE语句）的情况下更新多个文档的能力。 参考docs-update-by-query API

删除文档

删除文档相当简单. 下面的例子展示了如何删除我们先前ID为2的文档：

DELETE /customer/doc/2?pretty

参考_delete_by_query API来了解如何删除匹配查询的所有文档. 值得注意的是，删除整个索引而不是使用Delete By Query API删除所有文档将更有效率。

批处理

除了能索引，更新，删除单个文档之外， Elasticsearch还提供了_bulk API批量支持上述操作的能力。这个功能很重要，因为它提供了一种高效机制-使得我们可以在减少网络往返的情况下，尽可能快地完成多个操作。

作为简单示例，面的调用会在一个批量操作中索引两个文档（ID 1 - John Doe和ID 2 - Jane Doe）：

POST /customer/doc/_bulk?pretty
{"index":{"_id":"1"}}
{"name": "John Doe" }
{"index":{"_id":"2"}}
{"name": "Jane Doe" }

下面这个批量操作会更新第一个文档(ID为1)，然后删除第二个文档(ID为2）:

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

请注意，对于删除操作，没有附带相应的源文档，因为删除操作只需要文档ID.

Bulk API不会因其中某个操作失败而失败(无事务概念).如果某个操作失败了，它会继续处理该操作之后的其它操作.当bulk API返回时，它会为每个操作返回一个状态码(与发送顺序相同)，以便您可以根据此状态来检查特定操作的成功状态.