*Redis FT.ALIASDEL 命令

FT.ALIASDEL 删除 RediSearch 索引的别名。


*语法

FT.ALIASDEL alias

*参数说明

参数 类型 必填 说明
alias String 要删除的别名

*返回值

  • OK:别名删除成功
  • Error:别名不存在

*时间复杂度

O(1)

*

*示例

*删除别名

> FT.ALIASADD products idx:products
OK
> FT.ALIASDEL products
OK
> FT.SEARCH products "phone"
(error) Index not found

*清理旧版本别名

> FT.ALIASDEL articles_v1
OK

*常见错误

错误 原因 解决
Alias not found 别名不存在 确认别名名称,可用 FT._LIST 查看实际索引

*最佳实践

  • 索引重建或迁移后,及时清理旧别名
  • 删除别名前确认无客户端依赖该别名
  • 配合 FT.ALIASUPDATE 实现别名切换而非先删后加

*FAQ

Q1: 删除别名会影响索引数据吗? A: 不会,仅删除别名映射,索引本身和数据不受影响。

Q2: 可以删除索引的最后一个别名吗? A: 可以,索引可以没有别名,直接用索引名称操作。

Q3: 删除索引会自动删除别名吗? A: 是的,FT.DROPINDEX 会自动清理关联的所有别名。