【Elasticsearch】索引别名 aliases

索引别名

[🚫 1.错误演示](#🚫 1.错误演示)
- [1.1 当前状态：](#1.1 当前状态：)
- [1.2 执行以下命令会报错](#1.2 执行以下命令会报错)
[✅ 2.解决方案](#✅ 2.解决方案)
- [2.1 方案 1：先移除旧索引的写入权限，再设置新索引](#2.1 方案 1：先移除旧索引的写入权限，再设置新索引)
- [2.2 方案 2：使用原子操作一次性切换](#2.2 方案 2：使用原子操作一次性切换)
- [2.3 方案 3：创建时不设置写入索引，后续再切换](#2.3 方案 3：创建时不设置写入索引，后续再切换)
[🔍 3.验证当前状态](#🔍 3.验证当前状态)
- [3.1 查看别名指向的所有索引](#3.1 查看别名指向的所有索引)
- [3.2 查看哪个索引是当前写入索引](#3.2 查看哪个索引是当前写入索引)
- [3.3 查看所有包含写入索引的别名](#3.3 查看所有包含写入索引的别名)
[💡 4.实际应用场景](#💡 4.实际应用场景)
- [4.1 场景：基于时间的索引滚动](#4.1 场景：基于时间的索引滚动)
- [4.2 场景：索引重建](#4.2 场景：索引重建)
[🎯 5.总结](#🎯 5.总结)

在博文《【Elasticsearch】动手创建一个索引》中，我们创建了一个名为 test-index 的索引，并且指定索引别名为 log-index，同时设置其为写入索引。

如果此时我再次建立一个索引，名称为 test-index-01，别名为 log-index，也指定为写入索引，会发生什么呢？

您说得完全正确！这会报错，因为一个别名在同一时间只能指向一个作为写入索引的索引。

🚫 1.错误演示

1.1 当前状态：

test-index ← 别名 log-index（is_write_index: true）

1.2 执行以下命令会报错

json 复制代码

PUT /test-index-01
{
  "settings": {
    "number_of_shards": 3,
    "number_of_replicas": 1,
    "refresh_interval": "15s"
  },
  "aliases": {
    "log-index": {
      "is_write_index": true  // ← 冲突！
    }
  },
  "mappings": {
    "properties": {
      // ... 字段定义
    }
  }
}

错误信息类似：

✅ 2.解决方案

如果想要切换写入索引，有以下几种正确的做法。

2.1 方案 1：先移除旧索引的写入权限，再设置新索引

json 复制代码

// 步骤1：移除旧索引的写入权限
POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "test-index",
        "alias": "log-index",
        "is_write_index": false
      }
    }
  ]
}

// 步骤2：创建新索引并设置为写入索引
PUT /test-index-01
{
  "settings": {
    "number_of_shards": 3,
    "number_of_replicas": 1,
    "refresh_interval": "15s"
  },
  "aliases": {
    "log-index": {
      "is_write_index": true
    }
  },
  "mappings": {
    "properties": {
      "timestamp": {
        "type": "date",
        "format": "yyyy-MM-dd HH:mm:ss||epoch_millis"
      },
      "message": {
        "type": "text",
        "analyzer": "ik_max_word"
      }
      // ... 其他字段
    }
  }
}

2.2 方案 2：使用原子操作一次性切换

json 复制代码

POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "test-index-01",
        "alias": "log-index",
        "is_write_index": true
      }
    },
    {
      "add": {
        "index": "test-index", 
        "alias": "log-index",
        "is_write_index": false
      }
    }
  ]
}

2.3 方案 3：创建时不设置写入索引，后续再切换

json 复制代码

// 步骤1：创建新索引（不设置写入索引）
PUT /test-index-01
{
  "settings": {
    "number_of_shards": 3,
    "number_of_replicas": 1,
    "refresh_interval": "15s"
  },
  "aliases": {
    "log-index": {}  // ← 只添加别名，不设置写入索引
  },
  "mappings": {
    // ... 字段定义
  }
}

// 步骤2：原子切换写入索引
POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "test-index-01",
        "alias": "log-index", 
        "is_write_index": true
      }
    },
    {
      "add": {
        "index": "test-index",
        "alias": "log-index",
        "is_write_index": false
      }
    }
  ]
}

🔍 3.验证当前状态

在执行任何操作前，您可以先检查当前别名状态：

3.1 查看别名指向的所有索引

json 复制代码

GET /_alias/log-index

3.2 查看哪个索引是当前写入索引

json 复制代码

GET /_cat/aliases/log-index?v

3.3 查看所有包含写入索引的别名

json 复制代码

GET /_cat/aliases?v&filter_path=is_write_index:true

💡 4.实际应用场景

这种设计在以下场景中很有用：

4.1 场景：基于时间的索引滚动

bash 复制代码

# 第1个月：logs-2024-01 是写入索引
# 第2个月：切换到 logs-2024-02 为写入索引
# 第3个月：切换到 logs-2024-03 为写入索引
# 但应用程序始终使用别名 "logs" 写入

1️⃣ 设置 logs-2024-01 为写入索引。

2️⃣ 通过别名往索引中写入数据。

3️⃣ 可以看到此时数据写入了 logs-2024-01。

4️⃣ 切换写入索引为 logs-2024-02。

5️⃣ 可以看到 logs-2024-02 此时已成为别名 logs 的写入索引了。

6️⃣ 再次通过索引别名往索引中写入数据。

7️⃣ 可以观察到，此时写入的数据已经存储到了 logs-2024-02 中。

4.2 场景：索引重建

bash 复制代码

# 阶段1：products-v1 是写入索引
# 阶段2：创建 products-v2，数据迁移
# 阶段3：切换写入索引到 products-v2
# 阶段4：下线 products-v1

🎯 5.总结

✅ 一个别名可以指向多个索引
✅ 但只能有一个索引设置为 is_write_index: true
✅ 切换写入索引需要使用原子操作
✅ 应用程序可以始终使用别名，无需关心底层索引变化

这种机制正是 Elasticsearch 实现索引滚动、零停机重建等高级功能的基础。