Elasticsearch
开发指南 / 2 Restful API
6
文档版本：20181105
警告：
外部版本控制支持将数值 0 作为有效的版本号。这允许版本与版本号始于 0 而非 1 的外部版本控
制系统保持同步。其不利之处在于，版本号等于 0 的文档不能使用按查询结果更新 API (Update-
By-Query API) 进行更新，而且只要其版本号等于 0，也不能使用按查询结果删除 API (Delete By
Query API) 进行删除。
有利的一面是，只要使用源数据库中的版本号，就不需要对因源数据库更改而执行的异步索引操作
进行严格排序。如果使用外部版本控制，即使是使用数据库中的数据更新 Elasticsearch 索引这种简
单情况也会得到简化，因为如果索引操作出于任何原因出现问题，则只会使用最新版本。
版本类型
除了上文提及的 internal 和 external 版本类型，Elasticsearch 还支持为特定用例使用其他类
型。以下是关于不同版本类型及其语义的概述。
• internal：如果给定版本与存储文档的版本相同，则仅索引文档。
• external 或 external_gt：如果给定版本高于存储文档的版本或当前没有文档，则仅索引文
档。给定版本将用作新版本，并将与新文档一起存储。提供的版本必须是非负数长值数字。
• external_gte：如果给定版本等于或高于存储文档的版本，则仅索引文档。如果当前没有文
档，操作也会成功。给定版本将用作新版本，并将与新文档一起存储。提供的版本必须是非负数
长值数字。
说明：
external_gte 版本类型用于特殊用例，应谨慎使用。如果使用不当，可能会导致数据丢失。还
有一个选项 force，它可能会导致主碎片与副本碎片不一致，因此已弃用。
2.1.1.3 操作类型
索引操作还接受可用于强制执行 create 操作的 op_type，从而允许“缺少即加入”(put-if-
absent) 行为。使用 create 时，如果索引中已存在由该 ID 创建的文档，则索引操作将会失败。
以下是使用 op_type 参数的示例：
PUT twitter/_doc/1?op_type=create
{
"user" : "kimchy",
"post_date" : "2009-11-15T14:12:12",
"message" : "trying out Elasticsearch"
剩余67页未读，继续阅读
