Redis FT.SEARCH管道分隔值精确匹配的转义问题求助

问题原因 #

你使用TEXT类型存储searchkey字段，RedisSearch会对TEXT类型内容进行分词处理，管道符|会被视为分词分隔符，导致BA00000000|99|01|1被拆分为多个独立词汇。这就造成：

• 直接执行FT.SEARCH myIdx "@searchkey:BA00000000|99|01|1"时，会匹配包含任意拆分后词汇的文档，因此返回两个结果；
• 使用{}精确匹配语法时，由于TEXT索引中没有存储完整的BA00000000|99|01|1作为单个词汇，自然无法找到匹配项，反斜杠转义也无效。

解决方案 #

根据你的需求选择以下两种方案：

方案1：精确匹配完整的searchkey字符串（推荐）

将searchkey字段类型改为KEYWORD，该类型会将整个字段值作为单个词汇索引，不进行分词：

1. 删除原有索引：

   FT.DROPINDEX myIdx
   

2. 创建新索引，指定searchkey为KEYWORD类型：

   FT.CREATE myIdx ON HASH PREFIX 1 doc: SCHEMA title TEXT WEIGHT 5.0 body TEXT url TEXT searchkey KEYWORD
   

3. 重新设置哈希值（若已存在可跳过，KEYWORD类型会自动重新索引现有值）：

   HSET doc:1 title "hello world" body "lorem ipsum" url "http://redis.io" searchkey "BA00000000|99|01|1"
   HSET doc:2 title "hello world2" body "lorem ipsum2" url "http://redis2.io" searchkey "BA00000000|88|01|1"
   

4. 执行精确匹配查询：

   FT.SEARCH myIdx "@searchkey:{BA00000000|99|01|1}" LIMIT 0 10
   

   此时只会返回doc:1这一个匹配结果。

方案2：按管道符拆分的片段进行匹配

若需要按|分割的各个部分单独或组合匹配，可将searchkey改为TAG类型：

1. 删除原有索引：

   FT.DROPINDEX myIdx
   

2. 创建新索引，指定searchkey为TAG类型并设置分隔符为|：

   FT.CREATE myIdx ON HASH PREFIX 1 doc: SCHEMA title TEXT WEIGHT 5.0 body TEXT url TEXT searchkey TAG SEPARATOR "|"
   

3. 示例查询：
   • 匹配包含BA00000000和99的文档：

     FT.SEARCH myIdx "@searchkey:{BA00000000} @searchkey:{99}" LIMIT 0 10
     

   • 匹配包含88的文档：

     FT.SEARCH myIdx "@searchkey:{88}" LIMIT 0 10
     

内容的提问来源于stack exchange，提问作者SK G