elasticsearch文档Delete API
elasticsearch文档Delete API
上篇文章和读者分享了Elasticsearch中文档Get API的一些基本用法，本文来看看DELETE API的基本用法。
本文是Elasticsearch系列的第十一篇，阅读前面的文章，有助于更好的理解本文：
1.elasticsearch安装与配置 2.初识elasticsearch中的REST接口 3.elasticsearch修改数据 4.elasticsearch文档操作 5.elasticsearch API约定(一) 6.elasticsearch API约定(二) 7.elasticsearch文档读写模型 8.elasticsearch文档索引API(一) 9.elasticsearch文档索引API(二) 10.elasticsearch文档 Get API
Delete API允许开发者通过一个文档id删除一个JSON文档，这个我们在前面已经有过案例，例如下面这样，表示删除twitter索引中id为1的文档：
curl -X DELETE "localhost:9200/twitter/_doc/1?pretty"执行结果如下：
Versioning
索引中的每个文档都被标记了版本，任何的操作如更新删除等，都会导致文档版本的递增，因此，当删除文档时，也可以指定文档的版本号，确保删掉的文档是我们想删掉的文档。已经删除文档的版本号在删除后仍可短时间使用，以便控制并发操作，可以通过index.gc_deletes来设置已经删除文档的版本号的保存时间，默认为60秒。
Routing
如果在添加文档时使用了路由，那么在删除文档时也需要指定路由，如果不指定，则无法删除指定的文档，如下：
curl -X DELETE "localhost:9200/twitter/_doc/1?routing=sang&pretty"执行结果如下：
可以看到，如果未指定路由，会提示文档找不到，指定了路由，文档就能找到并删除了。
当mapping的routing被设定为required,而开发者却没有指定的路由值时，删除API将抛出RoutingMissingException并拒绝该请求。这是为了防止用户忘记配置路由值从而造成不必要的损失（因为当用户使用自定义路由时，所有的请求[DELETE/PUT/GET/POST]都会需要路由值），将routing设置为required的方式如下：
curl -XPUT 'localhost:9200/twitter?pretty' -H 'Content-Type: application/json' -d'
{
"mappings": {
"_doc": {
"_routing": {
"required": true
}
}
}
}
'指定完成后，添加文档，再删除文档，删除文档时必须指定routing，否则就会抛出RoutingMissingException异常，如下：
Automatic index creation
如果删除的是一个不存在的索引，则删除操作会自动创建出该索引，并且还会自动为特定类型创建动态类型映射。
Distributed
删除操作将被散列到一个特定的分片ID，然后该操作被重定向到该ID组内的主分片，以及组内的副本分片（如果需要）。
Wait For Active Shards
waitforactive_shards参数的作用和elasticsearch文档索引API(二)一文中介绍的含义一致，这里不再赘述，读者可以参考该篇文章。
Refresh
控制本次的变化是否能够被搜索可见。后文我将详细介绍这个参数。
Timeout
在执行删除操作时，分配给执行删除操作的主分片可能无法使用。有些方面的原因可能是主分片正在从仓库恢复或进行搬迁。默认情况下，删除操作在返回失败与错误之前将等待1分钟让主分片成为可用的。该timeout参数可用于明确指定等待多长时间。这里是将其设置为5分钟的一个示例：
执行删除操作时，分配用于执行删除操作的主分片可能不可用，原因可能是主分片当前正在从仓库恢复或正在进行重定位。默认情况下，删除操作将在主分片上等待最多1分钟，然后给出一个失败的响应，使用timeout参数可以显式指定等待的时间，如下表示等待时间为5分钟：
curl -X DELETE "localhost:9200/twitter/_doc/1?timeout=5m"好了，本文就先介绍到这里，有问题欢迎留言讨论。