深入解析：【Elasticsearch】索引别名 aliases

索引别名

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

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

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

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

1.错误演示

1.1 当前状态：

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

1.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": {
// ... 字段定义
}
}
}

错误信息类似：

✅ 2.解决方案

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

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

// 步骤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：使用原子操作一次性切换

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：创建时不设置写入索引，后续再切换

// 步骤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 查看别名指向的所有索引

GET /_alias/log-index

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

GET /_cat/aliases/log-index?v

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

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

4.实际应用场景

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

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

# 第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 场景：索引重建

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

5.总结

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

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