Elasticsearch 索引别名入门:创建、路由、原子切换与几个常见误解

AI 生成声明:本文内容由 AI 生成或经 AI 辅助完成,请注意甄别。

别名到底解决了什么问题

索引名一旦带版本号(比如 order_index_v3),就注定会有 v4、v5。如果业务代码里写死 order_index_v3,每次重建索引都要改代码、发版、重启。

别名就是这个问题的标准答案:应用只认别名,别名指向哪个真实索引由运维决定。重建索引、改分片数、换映射时,只需要切换别名指向,应用侧一行代码都不用动。

需要先建立的一个认知是:通过别名写入时,数据最终仍然落在真实的那个索引上,别名只是请求的转发层。它的价值不在"多一层",而在"换底层时调用方无感"。

一、创建别名

最简单的写法

PUT /order_index_v3/_alias/order_alias

_aliases(复数)与 _alias 等价。索引名支持通配符,也可以用 _all。

推荐写法:_aliases API

虽然啰嗦一点,但它能在一次请求里做多件事,也是后面原子切换唯一可行的地方:

POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "order_index_v3",
        "alias": "order_alias"
      }
    }
  ]
}

一个别名指向多个索引同样可行(搜索会跨这些索引,写入时必须指定具体索引,否则报错):

POST /_aliases
{
  "actions": [
    {
      "add": {
        "indices": ["order_index_2024", "order_index_2025"],
        "alias": "order_alias"
      }
    }
  ]
}

二、带过滤器的别名:一个索引、多种视图

POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "order_index_v3",
        "alias": "order_alias_paid",
        "filter": { "term": { "status": "paid" } }
      }
    }
  ]
}

通过 order_alias_paid 查询只能看到 status = paid 的文档,看起来像一张"视图"。

要注意两点:

  • 过滤器只影响读取,不影响写入。通过这个别名写入的文档不会被自动补上 status: paid,写入后可能立刻"查不到";
  • 它在语义上等价于给每个查询强制加一个 filter,是多租户隔离的常用手段,但不是权限控制。

三、路由参数:routing / index_routing / search_routing

这一块最容易误解,先记住一句话:这几个值不是分片编号。

POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "order_index_v3",
        "alias": "order_alias",
        "routing": "1",
        "index_routing": "1",
        "search_routing": "1,2,3"
      }
    }
  ]
}
参数 作用
routing 默认路由值。请求没显式指定 routing 时,读写都用它
index_routing 仅写入生效,写入时用的路由值
search_routing 仅搜索生效,逗号分隔表示多个路由值,会命中这几个值哈希后的全部目标分片

"1"、"2"、"3" 只是普通字符串,ES 对每个值做哈希(默认 _routing 哈希函数)后再决定落到哪个分片。所以上面的配置实际含义是:

  • 所有通过该别名的写入都落到 "1" 哈希出的那一个分片上;
  • 查询会同时扫 "1"、"2"、"3" 三个值各自映射到的分片。

这种"写入收敛、读取放大"的组合,适合把新数据集中写入以提高段合并效率。但如果你没有明确的分片规划,这样配反而会造成热点——单个分片承担全部写入。

更常见的用法:按业务维度做路由

真正想要"按某个字段自动路由到同一分片",通常分两步:先在映射上把路由设为必需,再在写入时传 routing 值。

PUT /order_index_v3/_mapping
{
  "_routing": { "required": true }
}
PUT /order_alias/_doc/1?routing=tenant_001
{
  "tenant_id": "tenant_001",
  "title": "示例文档"
}

这样同一租户的文档稳定落在同一分片,查询时带上 ?routing=tenant_001 可以只打一个分片,省掉广播开销。

需要明确的是:ES 没有"别名按字段值自动路由"这种机制。所谓自动路由,指的是不指定 routing、由 ES 按文档 _id 做默认哈希——这也是绝大多数场景的正确选择。

四、原子切换:零停机重建索引的标准动作

重建索引后,用一次请求完成"摘旧、接新",这个操作是原子的,中间不存在别名指向空窗期:

POST /_aliases
{
  "actions": [
    { "remove": { "index": "order_index_v3", "alias": "order_alias" } },
    { "add":    { "index": "order_index_v4", "alias": "order_alias" } }
  ]
}

配套的完整流程通常是:

  1. 按新映射建 order_index_v4;
  2. _reindex 把数据从 v3 搬到 v4;
  3. 用上面的 _aliases 请求原子切换;
  4. 观察一段时间,确认无误再删除 v3。

如果还想更稳妥,可以在切换前先无感验证:给 v4 建一个临时别名 order_alias_next,让部分流量或校验任务读它,确认数据量、抽样结果一致后再切正式别名。

五、查看与删除

GET /order_alias              // 别名指向哪些索引
GET /order_index_v3/_alias    // 该索引有哪些别名
GET /_aliases                 // 集群全部别名

删除有三种写法,任选其一:

DELETE /order_index_v3/_alias/order_alias
POST /_aliases
{
  "actions": [
    { "remove": { "index": "order_index_v3", "alias": "order_alias" } }
  ]
}

批量场景下只能用 _aliases 的 remove。

六、几个高频误解

Q:删别名会不会删数据?

不会。别名只是门牌,索引是仓库。DELETE /.../_alias/... 只拆门牌,索引和文档完好。真正删数据的是 DELETE /order_index_v3(删索引),这两个操作差一个字,破坏力差一个量级。

Q:只有一个索引时,用别名是不是多此一举?

当下确实没有收益,但这恰恰是最划算的时机:现在改代码只改一次,等真有 v4 时就是一行 _aliases 请求的事。等索引已经上线、代码到处写死索引名,再引入别名就变成一次改造项目了。

Q:别名能同时指向 data stream 和普通索引吗?

不能。同一个别名要么指向索引,要么指向 data stream,混用会被拒绝。

Q:别名支持日期数学表达式吗?

支持,比如 logs-{now/d} 会解析成当天日期,常用于按天滚动写入的场景(这只在创建/查询别名时做日期解析,别名本身仍然指向具体索引)。

Q:操作别名要什么权限?

开启安全功能后需要索引的 manage 权限。

小结

  • 索引名带版本号时,应用层固定用别名,版本信息留在真实索引名里;
  • 建别名优先用 _aliases 的 add/remove,因为原子切换只能这么写;
  • routing 系列参数的值是自定义路由键,不是分片号;无特殊需求不要设,默认按 _id 哈希就是最稳的;
  • 过滤别名只影响读,不要拿它当写入约束;
  • 删别名不删数据,这个操作远比看起来安全。

一个命名上的小建议:真实索引用 业务名_index_v3 这种可迭代的形式,别名用不带版本的 业务名_alias。看名字就知道哪些能删、哪些不能删。

注:文中索引名、字段名、租户标识等均为示例值,已做匿名化处理。

posted @ 2026-11-16 10:07  新*  阅读(90)  评论(0)    收藏  举报