*Redis FT.CONFIG-SET 命令

FT.CONFIG-SET 修改 RediSearch 模块的运行时配置参数。


*语法

FT.CONFIG-SET option value

*参数说明

参数 类型 必填 说明
option String 配置参数名
value String/Integer 配置值

*返回值

  • OK:设置成功
  • Error:参数名无效或值超出范围

*时间复杂度

O(1)

*

*示例

*设置查询超时

> FT.CONFIG-SET TIMEOUT 10000
OK

*设置最大扩展数

> FT.CONFIG-SET MAXEXPANSIONS 500
OK

*设置最小前缀长度

> FT.CONFIG-SET MINPREFIX 3
OK

*常见错误

错误 原因 解决
Unknown configuration option 参数名错误 使用 FT.CONFIG-HELP 查看可用参数
Invalid value 值类型或范围错误 确认参数要求的类型和范围

*最佳实践

  • 运行时修改仅内存生效,重启后丢失,需同步修改 redis.conf
  • 调整 TIMEOUT 时考虑业务可接受的查询延迟
  • 降低 MAXEXPANSIONS 可减少通配符/模糊查询的 CPU 消耗
  • 生产环境修改前在低环境测试

*FAQ

Q1: FT.CONFIG-SET 和 Redis CONFIG SET 有什么区别? A: FT.CONFIG-SET 修改 RediSearch 模块配置;Redis CONFIG SET 修改 Redis 核心配置。

Q2: 修改后需要重启吗? A: 不需要,即时生效。但重启后会恢复配置文件中的值,需持久化到配置文件。

Q3: 所有配置都可以运行时修改吗? A: 不是,部分参数仅启动时有效(如某些线程池参数)。

Q4: 如何恢复默认值? A: 没有直接恢复命令,需用 FT.CONFIG-HELP 查看默认值后手动设置。