1. 准备阶段：确定目标和条件

UpdateByQueryRequest updateByQueryRequest = new UpdateByQueryRequest(ArchivesGlobalConstant.PROFILE_INDEX_NAME);
updateByQueryRequest.setDocTypes(ArchivesGlobalConstant.TYPE_NAME);
updateByQueryRequest.setQuery(QueryBuilders.termsQuery("lib_id", libIds));

• 创建请求对象：new UpdateByQueryRequest(...)。
  • 意义：告诉 ES，“我要对 PROFILE_INDEX_NAME 这个索引执行批量更新操作”。
• 设置类型：setDocTypes(...)。
  • 意义：限定操作的文档类型（虽然新版 ES 逐渐弱化类型，但旧版客户端代码里还需要写）。
• 设置查询条件：setQuery(...)。
  • 意义：“找谁？”。使用 termsQuery 找出所有 lib_id 在 libIds 列表中的文档。这一步和查数据是一模一样的。

2. 逻辑阶段：定义修改规则（核心）

Map<String, Object> params = Maps.newHashMap();
params.put("groupId", groupId);
params.put("groupIds", Lists.newArrayList(groupId));

// ... 中间根据 ADD/REMOVE 选择脚本
updateByQueryRequest.setScript(new Script(...));

• 准备参数：params。
  • 意义：把 Java 里的变量（groupId）包装成 Map，准备传给 ES。这样做的目的是为了防止字符串拼接错误，也方便 ES 做安全检查。
• 定义脚本：new Script(...)。
  • 意义：“改成什么样？”。这是批量更新的灵魂。
  • 逻辑：把刚才的参数、脚本语言（Painless）、以及具体的修改代码（那个长字符串）组装在一起。
  • 注意：这里根据 operateTag 判断是执行“添加 ID”还是“删除 ID”的逻辑。

3. 执行阶段：发送指令并处理

updateByQueryRequest.setRefresh(true);
updateByQueryRequest.setConflicts("proceed");

try {
    restHighLevelClient.updateByQuery(updateByQueryRequest, RequestOptions.DEFAULT);
} catch (IOException e) {
    // 错误处理
}

• 配置选项：
  • setRefresh(true)：立即生效。更新完马上刷新索引，让数据能立刻被搜索到（如果不设，ES 可能会为了性能稍后才刷新，导致查不到刚改的数据）。
  • setConflicts("proceed")：冲突忽略。如果在更新过程中有其他人在修改同一条数据，不要报错停止，而是继续执行下去。
• 发送请求：client.updateByQuery(...)。
  • 意义：把请求发给 ES。ES 会根据条件找到文档，然后执行脚本里的逻辑，最后保存。