大家好，我是烤鸭：

    今天分享的是官网6.x    单一文档(Single document APIs)APIs。

    本文这是部分翻译，如果想看全部的，还是建议阅读官方api。链接：

     https://www.elastic.co/guide/en/elasticsearch/reference/current/docs.html

1.    删除   (delete) API

DELETE /twitter/_doc/1

{"_shards" : {"total" : 2,"failed" : 0,"successful" : 2},"_index" : "twitter","_type" : "_doc","_id" : "1","_version" : 2,"_primary_term": 1,"_seq_no": 5,"result": "deleted"
}

DELETE /twitter/_doc/1?routing=kimchy

分布式

超时

DELETE /twitter/_doc/1?timeout=5m

2.    更新   (update) API

PUT test/_doc/1
{"counter" : 1,"tags" : ["red"]
}

脚本更新

运行脚本，自增计数。

POST test/_doc/1/_update
{"script" : {"source": "ctx._source.counter += params.count","lang": "painless","params" : {"count" : 4}}
}

POST test/_doc/1/_update
{"script" : {"source": "ctx._source.tags.add(params.tag)","lang": "painless","params" : {"tag" : "blue"}}
}

除了_source之外，以下变量可通过ctx  图获得，如:_index、_type、_id、_version、_routing 和_now （当前时间戳）。

也可以在文档中添加新变量：

POST test/_doc/1/_update
{"script" : "ctx._source.new_field = 'value_of_new_field'"
}

或者删除变量：

POST test/_doc/1/_update
{"script" : "ctx._source.remove('new_field')"
}

而且，我们甚至可以改变执行的操作。如果tags字段包含green，删除文档，否则它不做任何操作（noop）：

POST test/_doc/1/_update
{"script" : {"source": "if (ctx._source.tags.contains(params.tag)) { ctx.op = 'delete' } else { ctx.op = 'none' }","lang": "painless","params" : {"tag" : "green"}}
}

更新部分文档

更新API还支持传递部分文档，该文档将被合并到现有文档中（简单递归合并、对象内部合并、替换核心“键值对”和数组）。要完全替换现有文档，应该使用index API。下面的部分更新是对现有文档添加了新字段：

POST test/_doc/1/_update
{"doc" : {"name" : "new_name"}
}

如果指定了doc 和script ，则忽略doc 。最好是将你的字段对的部分文档放在脚本本身中。

NOOP更新检查

如果doc 被指定，它的值将与现有的_source合并。默认情况下，更新检测会检测到它们不会改变任何东西，并返回“"result"： "noop" ，像这样：

POST test/_doc/1/_update
{"doc" : {"name" : "new_name"}
}

如果在发送请求之前name 如果是new_name ，则忽略整个更新请求。如果请求被忽略，响应中的result 返回noop 。

{"_shards": {"total": 0,"successful": 0,"failed": 0},"_index": "test","_type": "_doc","_id": "1","_version": 6,"result": "noop"
}

可以禁用上面的更新检查：

POST test/_doc/1/_update
{"doc" : {"name" : "new_name"},"detect_noop": false
}

更新插入

POST test/_doc/1/_update
{"script" : {"source": "ctx._source.counter += params.count","lang": "painless","params" : {"count" : 4}},"upsert" : {"counter" : 1}
}

更新插入脚本

如果不管文档是否存在，脚本都运行的话，即脚本代替upsert 初始化文档，将scripted_upsert设置为true：

POST sessions/session/dh3sgudg8gsrgl/_update
{"scripted_upsert":true,"script" : {"id": "my_web_session_summariser","params" : {"pageViewEvent" : {"url":"foo.com/bar","response":404,"time":"2014-01-01 12:32"}}},"upsert" : {}
}

文档插入更新

POST test/_doc/1/_update
{"doc" : {"name" : "new_name"},"doc_as_upsert" : true
}