原文地址:https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started-modify-data.html
elasticsearch版本:6.5
1、索引更换文件
ElasticSearch提供近实时的数据操作和搜索功能。默认情况下,从索引/更新/删除数据到在搜索结果中显示数据,您可以期待一秒钟的延迟(刷新间隔)。这是与其他平台(如SQL)的一个重要区别,在SQL中,数据在事务完成后立即可用。
创建索引、更新文档
我们以前见过如何索引单个文档。让我们再次回忆一下这个命令:
PUT /customer/_doc/1?pretty
{
"name":"John Doe"
}
同样,上面将把指定的文档索引到客户索引中,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。
2、更新文件
除了能够索引和替换文档外,我们还可以更新文档。请注意,虽然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.\u source指的是将要更新的当前源文档。
ElasticSearch提供了在给定查询条件(如SQL update-where语句)下更新多个文档的功能。参见查询API更新文档。
3、删除文件
删除文档相当简单。此示例显示如何删除ID为2的以前的客户:
DELETE /customer/_doc/2?pretty
请参阅“按查询删除”API以删除与特定查询匹配的所有文档。值得注意的是,使用“按查询删除”API删除整个索引而不是删除所有文档的效率要高得多。
4、批处理
除了能够索引、更新和删除单个文档之外,ElasticSearch还提供了使用批量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。
批量API不会由于其中一个操作失败而失败。如果一个操作由于任何原因失败,它将继续处理后面的其余操作。当批量API返回时,它将为每个操作提供一个状态(以相同的发送顺序),以便您可以检查特定操作是否失败。