强制合并

1.0 版引入

强制合并 API 操作强制对一个或多个索引的分片进行合并。对于数据流，该 API 强制对数据流的后端索引的分片进行合并。

端点

POST /_forcemerge
POST /<index>/_forcemerge/

合并操作

在 OpenSearch 中，分片是一个 Lucene 索引，它由*段*（或段文件）组成。段存储索引数据。较小的段会定期合并为较大的段，较大的段变得不可变。合并操作减少了每个分片的段总数，并释放了磁盘空间。

OpenSearch 执行后台段合并，生成的段大小不超过 index.merge.policy.max_merged_segment（默认为 5 GB）。

已删除文档

当从 OpenSearch 索引中删除文档时，它不会从 Lucene 段中删除，而只是被标记为待删除。当段文件合并时，已删除的文档会被移除（或*清除*）。因此，合并也会释放被标记为已删除文档所占用的空间。

强制合并 API

除了定期合并之外，您还可以使用强制合并 API 强制进行段合并。

仅当发送到索引的所有写入请求都完成后，才能对索引使用强制合并 API。强制合并操作可能会产生非常大的段。如果仍有写入请求发送到索引，则合并策略不会合并这些段，直到它们主要由已删除的文档组成。这可能会增加磁盘空间使用量并导致性能下降。

当您调用强制合并 API 时，该调用会被阻塞，直到合并完成。如果在此期间连接丢失，强制合并操作会在后台继续进行。发送到同一索引的新强制合并请求将被阻塞，直到当前运行的合并操作完成。

强制合并多个索引

要强制合并多个索引，您可以在以下索引组合上调用强制合并 API

• 多个索引
• 包含多个后端索引的一个或多个数据流
• 指向多个索引的一个或多个索引别名
• 集群中的所有数据流和索引

当您强制合并多个索引时，合并操作会在节点的每个分片上按顺序执行。当强制合并操作正在进行时，分片的存储空间会暂时增加，以便所有段都可以重写到一个新段中。当 max_num_segments 设置为 1 时，分片的存储空间会暂时翻倍。

强制合并数据流

强制合并数据流对于管理数据流的后端索引非常有用，尤其是在滚动操作之后。基于时间的索引仅在指定时间段内接收索引请求。一旦该时间段结束且索引不再接收写入请求，您可以强制将所有索引分片的段合并为一个段。在单段分片上的搜索效率更高，因为它们使用更简单的数据结构。

路径参数

下表列出了可用的路径参数。所有路径参数均为可选。

查询参数

下表列出了可用的查询参数。所有查询参数都是可选的。

示例请求

以下示例展示如何使用强制合并 API。

强制合并特定索引

以下示例强制合并特定索引

POST /testindex1/_forcemerge

强制合并多个索引

以下示例强制合并多个索引

POST /testindex1,testindex2/_forcemerge

强制合并所有索引

以下示例强制合并所有索引

POST /_forcemerge

将数据流的后端索引强制合并为一个段

以下示例将数据流的后端索引强制合并为一个段

POST /.testindex-logs/_forcemerge?max_num_segments=1

强制合并主分片

以下示例强制合并索引的主分片

POST /.testindex-logs/_forcemerge?primary_only=true

示例响应

{
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}

响应正文字段

下表列出了所有响应字段。