---
title: "索引状态管理模板迁移控制配置"
date: 2026-03-16
lastmod: 2026-03-16
description: "index_state_management.template_migration.control 配置项用于控制索引状态管理模板迁移的行为和时间戳。"
tags: ["索引状态管理", "ISM", "模板迁移", "版本控制"]
summary: "配置项作用 #  index_state_management.template_migration.control 配置项用于控制索引状态管理（ISM）模板迁移的行为和时间戳。
配置项属性 #   配置路径: index_state_management.template_migration.control 数据类型: Long（长整数） 默认值: 0L 最小值: -2L 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启）  控制值说明 #   0: 启用迁移，使用集群管理器时间作为 ISM 模板的 last_updated_time（默认值） -1: 迁移成功结束 -2: 迁移失败结束 > 0: 使用指定的纪元毫秒值作为 ISM 模板的 last_updated_time  配置建议 #  默认配置 #  index_state_management: template_migration: control: 0 # 默认值，启用迁移 迁移成功后 #  index_state_management: template_migration: control: -1 # 迁移成功结束 迁移失败后 #  index_state_management: template_migration: control: -2 # 迁移失败结束 自定义时间戳 #  index_state_management: template_migration: control: 1640995200000 # 2022-01-01 00:00:00 UTC 功能说明 #  迁移控制 #  此配置允许精细控制 ISM 模板迁移的时机和方式，特别适用于以下场景："
---


## 配置项作用

`index_state_management.template_migration.control` 配置项用于**控制索引状态管理（ISM）模板迁移的行为和时间戳**。

## 配置项属性

- **配置路径**: `index_state_management.template_migration.control`
- **数据类型**: `Long`（长整数）
- **默认值**: `0L`
- **最小值**: `-2L`
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 是（可以动态更新，无需重启）

## 控制值说明

- **`0`**: 启用迁移，使用集群管理器时间作为 ISM 模板的 `last_updated_time`（默认值）
- **`-1`**: 迁移成功结束
- **`-2`**: 迁移失败结束
- **`> 0`**: 使用指定的纪元毫秒值作为 ISM 模板的 `last_updated_time`

## 配置建议

## 默认配置

```yaml
index_state_management:
  template_migration:
    control: 0  # 默认值，启用迁移
```

## 迁移成功后

```yaml
index_state_management:
  template_migration:
    control: -1  # 迁移成功结束
```

## 迁移失败后

```yaml
index_state_management:
  template_migration:
    control: -2  # 迁移失败结束
```

## 自定义时间戳

```yaml
index_state_management:
  template_migration:
    control: 1640995200000  # 2022-01-01 00:00:00 UTC
```

## 功能说明

## 迁移控制

此配置允许精细控制 ISM 模板迁移的时机和方式，特别适用于以下场景：
- Easysearch 版本升级期间的迁移
- 不同版本之间的 ISM 配置迁移
- 需要特定时间戳的回滚操作

## 时间戳用途

`last_updated_time` 字段用于：
- 跟踪模板的最后修改时间
- 确定迁移的基准时间
- 支持增量迁移操作

## 使用场景

## 版本升级

```yaml
# 升级期间启用迁移
index_state_management:
  template_migration:
    control: 0
```

升级完成后设置为 `-1` 表示迁移成功。

## 定制迁移时间

```yaml
# 使用特定时间戳进行迁移
index_state_management:
  template_migration:
    control: 1640995200000  # 指定迁移基准时间
```

## 迁移失败回滚

```yaml
# 标记迁移失败
index_state_management:
  template_migration:
    control: -2
```

## 注意事项

1. **动态更新**: 此配置可以动态更新，无需重启节点。

2. **最小值限制**: 配置值不能小于 `-2L`，小于此值的设置将被拒绝。

3. **自动设置**: 在大多数情况下，此值由系统在迁移过程中自动设置，无需手动干预。

4. **迁移监控**: 在迁移过程中，应定期检查此值以了解迁移状态。

5. **失败处理**: 如果迁移失败（值为 `-2`），需要检查日志以了解失败原因。

6. **时间戳格式**: 当使用正值时，必须是纪元毫秒时间戳（自 1970-01-01 00:00:00 UTC 起的毫秒数）。

7. **集群协调**: 在集群环境中，确保所有节点使用一致的配置值。

8. **备份建议**: 在进行迁移操作前，建议备份相关配置和数据。