【Elasticsearch】scripted_upsert

在 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 提供了一种灵活的方式来处理文档的创建和更新逻辑，特别适用于需要动态生成初始内容或统一更新逻辑的场景。