RedisSearch中的标签字段详解与应用指南

RedisSearch中的标签字段详解与应用指南

RediSearch 项目地址: https://gitcode.com/gh_mirrors/red/RediSearch

什么是标签字段

标签字段（Tag Fields）是RedisSearch中一种特殊类型的字段，它提供了一种高效的方式来存储和查询分类数据。与全文搜索字段不同，标签字段采用了更简单的分词和索引编码方式，特别适合存储诸如用户标签、产品分类、地理位置等离散值数据。

标签字段的核心特性

1. 简洁的分词处理：标签字段不使用复杂的分词器，而是允许用户自定义分隔符（默认为逗号）来分隔多个标签值。

2. 大小写处理灵活：默认情况下会对拉丁语系文本进行小写转换，但可以通过CASESENSITIVE参数禁用此功能。

3. 精确匹配要求：标签字段的内容不能通过普通的全文搜索找到，必须使用专门的标签查询语法。

4. 高效存储结构：标签索引仅存储文档ID的增量编码，不存储频率或偏移向量，使得每个标签条目通常只有1-2字节大小。

5. 容量限制：每个索引最多可以创建1024个标签字段。

创建标签字段

在定义RedisSearch索引时，可以通过以下语法添加标签字段：

FT.CREATE ... SCHEMA ... {field_name} TAG [SEPARATOR {sep}] [CASESENSITIVE]

参数说明：

• SEPARATOR：指定标签分隔符，默认为逗号(,)，可以是任何可打印的ASCII字符
• CASESENSITIVE：保持标签原始大小写（默认会转为小写）

示例：

FT.CREATE products_idx ON HASH PREFIX 1 product: SCHEMA 
    name TEXT 
    categories TAG SEPARATOR "|" 
    brands TAG SEPARATOR ";" CASESENSITIVE

标签字段查询语法

查询标签字段需要使用特定的语法格式：

@<字段名>:{ <标签1> | <标签2> | ... }

基础查询示例

查找包含"电子产品"或"家用电器"标签的商品：

FT.SEARCH products_idx "@categories:{ 电子产品 | 家用电器 }"

组合查询示例

结合全文搜索、数值范围和标签查询：

FT.SEARCH products_idx 
    "@name:手机 @price:[1000 5000] @brands:{ 华为 | 小米 }"

前缀匹配查询

标签字段支持使用*进行前缀匹配：

FT.SEARCH products_idx "@categories:{ 电子* }"
FT.SEARCH products_idx "@brands:{ Hua* }"

多标签查询策略

并集查询（OR逻辑）

在同一个标签条件中包含多个标签时，查询会返回包含任意一个标签的文档：

FT.SEARCH products_idx "@categories:{ 手机 | 平板电脑 }"

交集查询（AND逻辑）

要实现必须包含所有指定标签的查询，需要重复使用标签条件：

FT.SEARCH products_idx 
    "@categories:{ 手机 } @categories:{ 5G } @categories:{ 旗舰 }"

特殊字符处理技巧

包含标点符号的标签

当标签中包含标点符号时，在查询时需要对这些符号进行转义：

存储时（无需转义）：

HSET product:1 name "iPhone 13" categories "Apple产品,旗舰手机"

查询时（需要转义）：

FT.SEARCH products_idx "@categories:{ Apple\\产品 }"

包含空格的标签

对于包含多个单词的标签，建议对空格进行转义以避免语法错误：

错误方式：

FT.SEARCH products_idx "@categories:{ 智能 家居 }"

正确方式：

FT.SEARCH products_idx "@categories:{ 智能\\ 家居 }"

最佳实践建议

1. 分隔符选择：选择不会出现在标签值中的字符作为分隔符，如管道符|或分号;

2. 查询性能优化：将高频查询的标签放在条件前面，利用RedisSearch的查询优化特性

3. 标签设计：保持标签的简洁性和一致性，避免使用过于复杂或含义模糊的标签

4. 大小写处理：除非有特殊需求，否则建议使用默认的小写转换，以提高查询命中率

5. 转义规范：养成对所有特殊字符和空格进行转义的习惯，避免潜在的查询错误

通过合理使用RedisSearch的标签字段功能，开发者可以构建出高效、灵活的分类查询系统，满足各种复杂的数据检索需求。

RediSearch 项目地址: https://gitcode.com/gh_mirrors/red/RediSearch