【Elasticsearch】doc_as_upsert

在Elasticsearch中，`doc_as_upsert` 是一个用于更新文档的参数，它与 `_update` API 结合使用，用于实现“文档不存在则插入，存在则更新”的功能。

`doc_as_upsert` 的含义

- `doc_as_upsert` 参数：当设置为 `true` 时，如果目标文档不存在，`doc` 部分的内容将被用作插入的新文档内容。

- 默认行为：如果不设置 `doc_as_upsert`，则在文档不存在时，`_update` API 将会失败。

使用场景

- 插入或更新文档：当你不确定文档是否存在时，使用 `doc_as_upsert` 可以避免额外的检查步骤，直接实现插入或更新操作。

- 简化逻辑：在需要频繁更新或插入数据的场景中，`doc_as_upsert` 可以简化代码逻辑，减少对文档存在性的预检查。

 

示例

假设你有一个名为 `users` 的索引，希望根据文档 ID 更新用户信息，如果文档不存在则插入新文档：

 

```json

POST /users/_update/1

{

  "doc": {

    "name": "John Doe",

    "age": 30

  },

  "doc_as_upsert": true

}

```

 

- 如果文档 ID 为 `1` 的用户已经存在，`name` 和 `age` 字段将被更新。

- 如果文档 ID 为 `1` 的用户不存在，将创建一个新的文档，内容为 `{"name": "John Doe", "age": 30}`。

 

注意事项

- 数据一致性：使用 `doc_as_upsert` 时，需要确保 `doc` 部分的内容是完整的，因为这将作为新文档的内容。

- 性能影响：虽然 `doc_as_upsert` 简化了操作逻辑，但在高并发场景下，需要关注其对性能的影响。

 

总结来说，`doc_as_upsert` 是 Elasticsearch 中一个非常实用的功能，用于简化文档的插入或更新操作，特别适用于那些需要频繁处理文档存在性不确定的场景。