AI 生成声明:本文内容由 AI 生成或经 AI 辅助完成,请注意甄别。
别名到底解决了什么问题
索引名一旦带版本号(比如 order_index_v3),就注定会有 v4、v5。如果业务代码里写死 order_index_v3,每次重建索引都要改代码、发版、重启。
别名就是这个问题的标准答案:应用只认别名,别名指向哪个真实索引由运维决定。重建索引、改分片数、换映射时,只需要切换别名指向,应用侧一行代码都不用动。
需要先建立的一个认知是:通过别名写入时,数据最终仍然落在真实的那个索引上,别名只是请求的转发层。它的价值不在"多一层",而在"换底层时调用方无感"。
一、创建别名
最简单的写法
json
PUT /order_index_v3/_alias/order_alias
_aliases(复数)与 _alias 等价。索引名支持通配符,也可以用 _all。
推荐写法:_aliases API
虽然啰嗦一点,但它能在一次请求里做多件事,也是后面原子切换唯一可行的地方:
json
POST /_aliases
{
"actions": [
{
"add": {
"index": "order_index_v3",
"alias": "order_alias"
}
}
]
}
一个别名指向多个索引同样可行(搜索会跨这些索引,写入时必须指定具体索引,否则报错):
json
POST /_aliases
{
"actions": [
{
"add": {
"indices": ["order_index_2024", "order_index_2025"],
"alias": "order_alias"
}
}
]
}
二、带过滤器的别名:一个索引、多种视图
json
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
这一块最容易误解,先记住一句话:这几个值不是分片编号。
json
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 值。
json
PUT /order_index_v3/_mapping
{
"_routing": { "required": true }
}
json
PUT /order_alias/_doc/1?routing=tenant_001
{
"tenant_id": "tenant_001",
"title": "示例文档"
}
这样同一租户的文档稳定落在同一分片,查询时带上 ?routing=tenant_001 可以只打一个分片,省掉广播开销。
需要明确的是:ES 没有"别名按字段值自动路由"这种机制 。所谓自动路由,指的是不指定 routing、由 ES 按文档 _id 做默认哈希------这也是绝大多数场景的正确选择。
四、原子切换:零停机重建索引的标准动作
重建索引后,用一次请求完成"摘旧、接新",这个操作是原子的,中间不存在别名指向空窗期:
json
POST /_aliases
{
"actions": [
{ "remove": { "index": "order_index_v3", "alias": "order_alias" } },
{ "add": { "index": "order_index_v4", "alias": "order_alias" } }
]
}
配套的完整流程通常是:
- 按新映射建
order_index_v4; _reindex把数据从 v3 搬到 v4;- 用上面的
_aliases请求原子切换; - 观察一段时间,确认无误再删除 v3。
如果还想更稳妥,可以在切换前先无感验证:给 v4 建一个临时别名 order_alias_next,让部分流量或校验任务读它,确认数据量、抽样结果一致后再切正式别名。
五、查看与删除
json
GET /order_alias // 别名指向哪些索引
GET /order_index_v3/_alias // 该索引有哪些别名
GET /_aliases // 集群全部别名
删除有三种写法,任选其一:
json
DELETE /order_index_v3/_alias/order_alias
json
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。看名字就知道哪些能删、哪些不能删。
注:文中索引名、字段名、租户标识等均为示例值,已做匿名化处理。