Elasticsearch 参考指南（修改你的数据）

修改你的数据

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

索引/替换文档

咱们以前已经看到了如何索引单个文档，让咱们再次回想一下这个命令：

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

一样，上面将指定的文档索引到customer索引中，ID为1。若是咱们再使用不一样（或相同）的文档再次执行上述命令，Elasticsearch将在ID为1的现有文档之上替换（即从新索引）新文档：

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" }
}

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

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

也可使用简单脚本执行更新，此示例使用脚本将年龄增长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的customer：

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不会因其中一个操做失败而失败，若是单个操做因任何缘由失败，它将继续处理其后的其他操做，批量API返回时，它将为每一个操做提供一个状态（按照发送的顺序），以便你能够检查特定操做是否失败。

---

上一篇：探索你的集群

下一篇：探索你的数据