---
title: "索引状态管理元数据迁移状态配置"
date: 2026-02-18
lastmod: 2026-02-18
description: "index_state_management.metadata_migration.status 配置项用于跟踪索引状态管理的元数据迁移状态。"
tags: ["索引状态管理", "ISM", "元数据迁移", "状态跟踪"]
summary: "配置项作用 #  index_state_management.metadata_migration.status 配置项用于跟踪索引状态管理（ISM）的元数据迁移过程状态。
配置项属性 #   配置路径: index_state_management.metadata_migration.status 数据类型: Integer（整数） 默认值: 0（迁移进行中） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启）  状态值说明 #   0: 迁移进行中（默认值） 1: 迁移成功 -1: 迁移失败  配置建议 #  默认配置 #  index_state_management: metadata_migration: status: 0 # 默认值，迁移进行中 检查迁移状态 #  GET /_cluster/settings 查看配置中的 index_state_management.metadata_migration.status 值：
 如果为 1，表示迁移已完成 如果为 -1，表示迁移失败，需要检查日志 如果为 0，表示迁移仍在进行中  迁移完成后设置 #  index_state_management: metadata_migration: status: 1 # 迁移成功 注意事项 #    动态更新: 此配置可以动态更新，无需重启节点。"
---


## 配置项作用

`index_state_management.metadata_migration.status` 配置项用于**跟踪索引状态管理（ISM）的元数据迁移过程状态**。

## 配置项属性

- **配置路径**: `index_state_management.metadata_migration.status`
- **数据类型**: `Integer`（整数）
- **默认值**: `0`（迁移进行中）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 是（可以动态更新，无需重启）

## 状态值说明

- **`0`**: 迁移进行中（默认值）
- **`1`**: 迁移成功
- **`-1`**: 迁移失败

## 配置建议

## 默认配置

```yaml
index_state_management:
  metadata_migration:
    status: 0  # 默认值，迁移进行中
```

## 检查迁移状态

```bash
GET /_cluster/settings
```

查看配置中的 `index_state_management.metadata_migration.status` 值：
- 如果为 `1`，表示迁移已完成
- 如果为 `-1`，表示迁移失败，需要检查日志
- 如果为 `0`，表示迁移仍在进行中

## 迁移完成后设置

```yaml
index_state_management:
  metadata_migration:
    status: 1  # 迁移成功
```

## 注意事项

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

2. **用途**: 用于监控和跟踪元数据迁移过程的进度，特别在不同版本的 Easysearch 之间迁移 ISM 配置时。

3. **迁移场景**: 主要用于以下场景：
   - Easysearch 版本升级
   - ISM 配置格式变更
   - 数据迁移操作

4. **状态检查**: 在迁移过程中，应定期检查此状态值以确保迁移正常进行。

5. **失败处理**: 如果状态为 `-1`（失败），需要检查集群日志以了解失败原因并采取相应措施。

6. **只读状态**: 通常情况下，此状态由系统自动更新，不建议手动修改。