Elasticsearch 7.10执行delete-by-query遇文档数上限错误求助

问题根源 #

日志里的错误提示“Number of documents in the index can't exceed [2147483519]”，是因为索引logdata的index.max_doc_count参数被设置为2147483519（这是ES的默认值，也可能是被人为修改过），这个参数限制了单索引的最大文档数。delete-by-query操作在执行时会触发该上限检查，导致任务直接终止，无法删除任何记录。

解除限制的操作步骤 #

• 第一步：确认当前索引配置
  执行命令查看logdata的max_doc_count参数值：

  GET /logdata/_settings/index.max_doc_count?flat_settings=true
  

  若返回值为2147483519，则坐实是这个参数在限制操作。

• 第二步：修改索引的文档数上限
  可以直接设置为-1表示无限制（ES 7.x支持该设置），执行命令：

  PUT /logdata/_settings
  {
    "index.max_doc_count": -1
  }
  

  也可以设置为更大的具体数值，比如Long类型最大值9223372036854775807：

  PUT /logdata/_settings
  {
    "index.max_doc_count": 9223372036854775807
  }
  

• 第三步：重新执行delete-by-query
  参数修改生效后（动态参数无需重启节点），再次运行你的删除命令即可正常执行。

额外提醒 #

如果集群中其他索引也出现类似问题，检查elasticsearch.yml全局配置里的index.max_doc_count项，确保全局默认值符合业务需求，避免后续新索引踩同样的坑。

内容的提问来源于stack exchange，提问作者Aditya K