克隆、缩小与拆分索引

克隆、缩小与拆分索引 #

这三个操作都是"把一个现有索引复制到一个新索引"，区别在于目标索引的主分片数：

操作API目标主分片数典型场景
Clone_clone与源索引相同复制索引用于测试/实验
Shrink_shrink源分片数的因子（如 6→3、6→2、6→1）合并小分片、降低开销
Split_split源分片数的倍数（如 2→4、2→6）扩展分片以提高写入并发

前置条件：源索引必须是只读状态。所有操作都会创建一个全新的索引，源索引保持不变。

公共前置步骤 #

在执行 Clone / Shrink / Split 之前，源索引必须标记为只读：

PUT /source-index/_settings
{
  "index.blocks.write": true
}

对于 Shrink 操作，还需要将所有分片的副本迁移到同一个节点：

PUT /source-index/_settings
{
  "index.routing.allocation.require._name": "node-1",
  "index.blocks.write": true
}

等待所有分片完成迁移：

GET _cat/shards/source-index?v

确认所有分片都在目标节点上后再执行 Shrink。

Clone：克隆索引 #

将索引完整克隆为一个新索引（相同的分片数、设置和数据）。

POST /source-index/_clone/target-index

可以在请求体中为目标索引指定不同的设置：

POST /source-index/_clone/target-index
{
  "settings": {
    "index.number_of_replicas": 2
  },
  "aliases": {
    "my-alias": {}
  }
}

克隆完成后，记得移除源索引的写入块：

PUT /source-index/_settings
{
  "index.blocks.write": false
}

Shrink：缩小索引 #

将索引缩小为更少的主分片。目标分片数必须是源分片数的因子。

例如，一个 12 分片的索引可以缩小为 6、4、3、2 或 1 个分片。

POST /logs-000001/_shrink/logs-000001-shrunk
{
  "settings": {
    "index.number_of_shards": 1,
    "index.number_of_replicas": 1,
    "index.routing.allocation.require._name": null,
    "index.blocks.write": null
  }
}

注意：目标索引的设置中通常需要清除 routing.allocation.require 和 blocks.write，否则新索引会继承这些限制。

Shrink 的工作原理 #

Shrink 使用硬链接（hard link）而不是复制数据，所以速度很快且几乎不消耗额外磁盘空间。具体过程：

  1. 创建目标索引，主分片数为指定值
  2. 将源索引的段（segment）通过硬链接映射到目标索引
  3. 对目标索引进行恢复（如同刚打开的索引）

Split：拆分索引 #

将索引拆分为更多的主分片。目标分片数必须是源分片数的倍数。

例如，一个 2 分片的索引可以拆分为 4、6、8 等。

POST /my-index/_split/my-index-split
{
  "settings": {
    "index.number_of_shards": 4
  }
}

Split 的前置条件 #

源索引创建时，index.number_of_routing_shards 决定了拆分的上限。例如：

PUT /my-index
{
  "settings": {
    "index.number_of_shards": 2,
    "index.number_of_routing_shards": 8
  }
}

此索引最多可以拆分到 8 个分片（2→4→8）。

公共查询参数 #

三个 API 共享相同的查询参数：

参数类型默认值说明
timeoutTime30s操作超时时间
master_timeoutTime30s连接主节点的超时时间
wait_for_active_shardsString—等待的活跃分片数（数字、all 或 index-setting）

请求体 #

三个 API 的请求体结构相同：

字段类型说明
settingsObject目标索引的设置（会覆盖从源索引继承的值）
aliasesObject目标索引的别名定义

操作完成后 #

完成后通常需要：

  1. 移除源索引的写入块（如果还需要使用源索引）
  2. 验证目标索引的数据完整性
  3. 如果不再需要源索引，可以删除或关闭它
  4. 如果使用了别名，更新别名指向
// 验证文档数
GET /target-index/_count

// 通过别名切换
POST _aliases
{
  "actions": [
    { "remove": { "index": "source-index", "alias": "my-alias" } },
    { "add": { "index": "target-index", "alias": "my-alias" } }
  ]
}

下一步 #

©INFINI.LTD, All Rights Reserved.