在 Elasticsearch 中，`scripted_upsert` 是一个用于更新操作的参数，它允许在文档不存在时通过脚本初始化文档内容，而不是直接使用 `upsert` 部分的内容。这种方式提供了更灵活的文档创建和更新逻辑。
`scripted_upsert` 的工作原理
当设置 `scripted_upsert` 为 `true` 时，Elasticsearch 会根据脚本逻辑来处理文档的创建和更新，而不是直接使用 `upsert` 部分的内容。脚本可以根据文档是否存在来执行不同的逻辑。
- 文档不存在时：脚本会初始化文档内容。
- 文档存在时：脚本会更新文档内容。
使用场景
`scripted_upsert` 常用于以下场景：
1. 复杂的初始化逻辑：当文档不存在时，需要通过脚本动态生成初始内容，而不是直接插入固定的 `upsert` 数据。
2. 统一的更新逻辑：无论文档是否存在，都希望通过脚本统一处理更新逻辑。
示例
以下是一个使用 `scripted_upsert` 的示例，展示了如何根据文档是否存在来执行不同的脚本逻辑：
```json
POST /sessions/session/1/_update
{
"scripted_upsert": true,
"script": {
"source": "if (ctx.op == 'create') { ctx._source = params.newData } else { ctx._source.counter += params.increment }",
"lang": "painless",
"params": {
"newData": {
"counter": 1,
"name": "Initial Name"
},
"increment": 5
}
},
"upsert": {}
}
```
在这个例子中：
- 如果文档不存在，脚本会使用 `params.newData` 初始化文档。
- 如果文档存在，脚本会将 `counter` 字段增加 `params.increment` 的值。
注意事项
- `upsert` 部分：即使设置了 `scripted_upsert`，`upsert` 部分仍然需要提供一个空对象 `{}`，否则会报错。
- 脚本语言：脚本通常使用 Painless 语言编写，这是一种 Elasticsearch 提供的安全脚本语言。
- 性能考虑：脚本执行会增加一定的计算开销，因此在高并发场景下需要注意性能优化。
通过 `scripted_upsert`，Elasticsearch 提供了一种灵活的方式来处理文档的创建和更新逻辑，特别适用于需要动态生成初始内容或统一更新逻辑的场景。