索引状态管理模板迁移控制配置

配置项作用 #

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 模板迁移的时机和方式，特别适用于以下场景：

• Easysearch 版本升级期间的迁移
• 不同版本之间的 ISM 配置迁移
• 需要特定时间戳的回滚操作

时间戳用途 #

last_updated_time 字段用于：

• 跟踪模板的最后修改时间
• 确定迁移的基准时间
• 支持增量迁移操作

使用场景 #

版本升级 #

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

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

定制迁移时间 #

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

迁移失败回滚 #

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

注意事项 #

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

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

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

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

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

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

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

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