delete API允许基于指定的ID来从索引库中删除一个JSON文件。下面演示了从一个叫twitter
的索引库的tweet
type下删除文档,id
是1
:
$ curl -XDELETE 'http://localhost:9200/twitter/tweet/1'
上述删除操作的结果是:
{
"_shards" : {
"total" : 10,
"failed" : 0,
"successful" : 10
},
"found" : true,
"_index" : "twitter",
"_type" : "tweet",
"_id" : "1",
"_version" : 2,
"result": "deleted"
}
索引的每个文档都被标记了版本。当删除文档时, 可以通过指定version
来确保我们试图删除一个实际上已被删除的文档时,它在此期间并没有改变。在文档中执行的每个写入操作,包括删除,都会使其版本递增。
在创建索引文档时如果使用了控制路由的能力,为了删除文档,也应当提供路由值。例如:
$ curl -XDELETE 'http://localhost:9200/twitter/tweet/1?routing=kimchy'
以上将删除ID为1的tweet,但会根据用户路由。请注意,如果删除路由值不正确,会导致文档无法删除。
当映射的_routing
被设定为required
且没有指定的路由值时,删除API将抛出RoutingMissingException
并拒绝该请求。
parent
参数可以被设置,这将基本上与设定路由参数是相同的。
请注意,删除父文档不会自动删除其子文档。根据给定的父文档ID删除所有子文件的一种方法是,通过在创建文档索引时自动生成的_parent
字段来使用根据查询条件删除API进行删除,它的格式是parent_type#parent_id
。
当删除子文档,必须指定其父ID,否则该删除请求将被拒绝和抛出一个RoutingMissingException
异常。
如果索引库之前没有创建,删除操作将自动创建一个索引库(参见创建索引API来手动创建索引),并且如果没有创建类型时,会根据指定的类型名与动态映射类型来自动创建类型(参见put mapping来手动创建类型映射)。
删除操作被散列到一个特定的分片id。然后它被重定向到该ID组内的主分片,和副本分片(如果需要的话)。
当进行的删除请求,你可以设置wait_for_active_shards
参数来要求必须最少达到几个可用的分片才能开始处理删除请求。进一步的细节和使用示例见这里。
用来控制本次的变化能够被搜索可见。参见:refresh。
在执行删除操作时,分配给执行删除操作的主分片可能无法使用。有些方面的原因可能是主分片正在从仓库恢复或进行搬迁。默认情况下,删除操作在返回失败与错误之前将等待1分钟让主分片成为可用的。该timeout
参数可用于明确指定等待多长时间。这里是将其设置为5分钟的一个示例:
$ curl -XDELETE 'http://localhost:9200/twitter/tweet/1?timeout=5m'