快捷導(dǎo)航

Redis全文搜索教程之創(chuàng)建索引并關(guān)聯(lián)源數(shù)據(jù)的教程

更新時間：2023年12月21日 09:03:20 作者：waynaqua

RediSearch提供了一種簡單快速的方法對 hash 或者 json 類型數(shù)據(jù)的任何字段建立二級索引，然后就可以對被索引的 hash 或者 json 類型數(shù)據(jù)字段進行搜索和聚合操作，這篇文章主要介紹了Redis全文搜索教程之創(chuàng)建索引并關(guān)聯(lián)源數(shù)據(jù),需要的朋友可以參考下

Redis 全文搜索是依賴于 Redis 官方提供的 RediSearch 來實現(xiàn)的。RediSearch 提供了一種簡單快速的方法對 hash 或者 json 類型數(shù)據(jù)的任何字段建立二級索引，然后就可以對被索引的 hash 或者 json 類型數(shù)據(jù)字段進行搜索和聚合操作。

這里我們把被索引的 hash 或者 json 類型數(shù)據(jù)叫做源數(shù)據(jù)。

本文大綱如下，

使用體驗

簡單場景下，用 RediSearch 來平替 Elasticsearch 的使用場景已經(jīng)足夠。像是 Elasticsearch 中常用的查詢語法 AND 、OR 、IN 、NOT IN 、> 、< 、= 、like 等，在 RediSearch 中都是支持的。

此外 RediSearch 還支持聚合統(tǒng)計、停用詞、文本標記和轉(zhuǎn)義、同義詞、標簽、排序、向量查詢、中文分詞等。

就我個人來說，個人項目使用 RediSearch 作為全文搜索引擎已經(jīng)夠用了，它有占用內(nèi)存低、索引建立快、查詢數(shù)據(jù)性能足夠高等優(yōu)點。

后續(xù)發(fā)展

就目前官方對 RediSearch 的支持更新來看，

最近一次提交記錄在 12 月 17 號。

可以看到 RediSearch 的更新頻率還是比較高的，而且是官方支持做的模塊，不用擔(dān)心后續(xù)無人維護。

雖然 Redis 天生支持分布式集群，但是 RediSearch 對 Redis 集群的支持還不完善，引用官方說明，

官方針對 RediSearch 的集群支持問題，提供了一個 RediSearch 集群版本，但是這個版本只能在 Redis 企業(yè)版或者 Redis Cloud 上能使用，開源版還沒有，這一點需要告訴大家。

遇到 bug

首先在使用 RediSearch 的過程中，遇到了 bug 并發(fā)現(xiàn) bug 來源于 RediSearch，不要慌，也不要抱怨難用，畢竟是開源項目，

大家可以看到 issue 列表中有很多 bug 沒有解決。

不過本著開源共進的精神，希望大家發(fā)現(xiàn)了 bug 后，第一時間在 RediSearch 官方 github 上提個 issue，方便官方發(fā)現(xiàn)并解決問題。

RediSearch Github 倉庫地址：https://github.com/RediSearch/RediSearch

下面我給大家用 newbee-mall-pro 項目作為樣本，給大家介紹下如何創(chuàng)建一個索引并關(guān)聯(lián)源數(shù)據(jù)。

newbee-mall-pro 項目地址：https://github.com/wayn111/newbee-mall-pro

添加源數(shù)據(jù)

在 newbee-mall-pro 項目中，已經(jīng)將商品數(shù)據(jù)以 hash 類型存入了 Redis 中，

其中，我們對于 key 名稱的定義規(guī)則是按照 newbee_mall:goods: + 商品ID。

這里我們的 key 名稱定義規(guī)則很重要，RediSearch 創(chuàng)建索引會基于 key 名稱前綴來生成。

hash 類型的 value 包含屬性如下，

goodsId : 商品 ID，唯一屬性，由數(shù)據(jù)庫商品表主鍵生成
goodsName : 商品名稱
goodsIntro : 商品簡介
goodsCategoryId : 商品分類 ID，唯一屬性，由數(shù)據(jù)庫商品分類表主鍵生成
goodsSellStatus : 商品上架狀態(tài)，0 代表下架，1 代表上架
sellingPrice : 商品售價
originalPrice : 商品原價
tag : 商品標簽

在 newbee-mall-pro 中，添加源數(shù)據(jù)的方法已經(jīng)寫好了，代碼邏輯在 JedisSearch.addGoodsListIndex() 方法里，

public boolean addGoodsListIndex(String keyPrefix, List<Goods> list) {
    int chunk = 200;
    List<List<Goods>> partition = ListUtil.partition(list, chunk);
    AbstractPipeline pipelined = client.pipelined();
    for (List<Goods> goodsList : partition) {
        for (Goods goods : goodsList) {
            RsGoodsDTO target = new RsGoodsDTO();
            MyBeanUtil.copyProperties(goods, target);
            Map<String, String> hash = MyBeanUtil.toMap(target);
            // 支持中文
            hash.put("_language", Constants.GOODS_IDX_LANGUAGE);
            pipelined.hset(keyPrefix + goods.getGoodsId(), hash);
        }
    }
    pipelined.sync();
    return true;
}

上訴代碼中，其實就是把 list 商品列表以 hash 類型的數(shù)據(jù)結(jié)構(gòu)寫進 Redis 中，并且為了加快寫入速度，使用了 Redis 提供的管道操作。

需要注意的就是 hash 類型中新增了一個 _language 字段，用于指定 RediSearch 對于源數(shù)據(jù)關(guān)聯(lián)的索引，要使用中文分詞查詢。

建立索引

RediSearch 通過提供一種簡單且自動的方式在 Redis hash 類型數(shù)據(jù)結(jié)構(gòu)上創(chuàng)建二級索引，并且內(nèi)部極大地簡化了這一過程。（最終會出現(xiàn)更多數(shù)據(jù)結(jié)構(gòu)）

如果我們要使用 RediSearch 查詢商品 hash 結(jié)構(gòu)里的 goodsName 字段，那么必須要對該字段建立索引。

Jedis 新建索引

所以這里，我給大家介紹下在 newbee-mall-pro 項目中，是如何建立索引的，代碼邏輯在 GoodsServiceImpl.syncRs() 方法中，

// 定義索引結(jié)構(gòu)
public boolean syncRs() {
    jedisSearch.dropIndex("idx:goods");
    Schema schema = new Schema()
            .addSortableTextField("goodsName", 1.0)
            .addSortableTextField("goodsIntro", 0.5)
            .addSortableNumericField("goodsId")
            .addSortableNumericField("goodsCategoryId")
            .addSortableNumericField("goodsSellStatus")
            .addSortableNumericField("sellingPrice")
            .addSortableNumericField("originalPrice")
            .addSortableTagField("tag", "|");
    jedisSearch.createIndex(Constants.GOODS_IDX_NAME, Constants.GOODS_IDX_PREFIX, schema);
}

上述代碼中，我們對商品 hash 結(jié)構(gòu)里的下方字段都建立了索引。

goodsName：文本類型，可排序，設(shè)置權(quán)重為 1.0
goodsIntro：文本類型，可排序，設(shè)置權(quán)重為 0.5
goodsId：數(shù)字類型，可排序
goodsCategoryId：數(shù)字類型，可排序
goodsSellStatus：數(shù)字類型，可排序
sellingPrice：數(shù)字類型，可排序
originalPrice：數(shù)字類型，可排序
tag：標簽類型，可排序，設(shè)置分隔符為字符串 |

在 RediSerach 中可以添加的字段類型有 text、numberic、tag 等，可以設(shè)置是否排序。

并且還可以設(shè)置權(quán)重系數(shù)，表示該字段已加權(quán)。這對于在搜索操作期間為特定字段分配不同的重要性級別非常有用，通常就是在條件篩選完成后的打分排序階段用于提升或者降低排名。

Redis 中的新建索引語法

當(dāng)我們把上面的 Jedis 新建索引的代碼轉(zhuǎn)換為 Redis 中的語法后，如下

> FT.CREATE idx:goods ON hash PREFIX 1 "newbeemall:goods:" \
SCHEMA goodsName TEXT SORTABLE WEIGHT 1.0 \
SCHEMA goodsIntro TEXT SORTABLE WEIGHT 0.5 \
goodsId NUMERIC SORTABLE \
goodsCategoryId NUMERIC SORTABLE \
goodsSellStatus NUMERIC SORTABLE \
sellingPrice NUMERIC SORTABLE \
originalPrice NUMERIC SORTABLE \
tag TAG SORTABLE SEPARATOR "|"

現(xiàn)在我給大家詳細介紹下這條命令：

FT.CREATE：RediSearch 中索引創(chuàng)建語法。
idx:goods：指定索引名稱，索引名稱將在所有鍵名稱中使用，因此請保持簡短。
ON hash：指定索引關(guān)聯(lián)的結(jié)構(gòu)類型。需要注意的是，在 RediSearch 2.0 中僅支持哈希結(jié)構(gòu)，隨著 RediSearch 更新，后續(xù)有望支持更多數(shù)據(jù)結(jié)構(gòu)。
PREFIX 1 "newbeemall:goods:"：指定索引的關(guān)聯(lián)源數(shù)據(jù)的 key 前綴，可以指定多個前綴。
SCHEMA ...：字段定義，用于定義字段名稱、類型、是否排序、權(quán)重等?？梢远x多個字段。

如果你想了解更多關(guān)于 ft.search 的語法以及字段定義相關(guān)的只是，可以打開官方文檔，

https://redis.io/docs/interact/search-and-query/basic-constructs/schema-definition

Redis 中查詢索引定義

在 RediSearch 中要查詢已經(jīng)存在的索引詳情也是很簡單的，官方提供了 ft.info 索引名稱 的語法，用來打印索引詳情。

> FT.INFO idx:goods

最后聊兩句

本文給大家用我的開源項目 newbee-mall-pro 作為樣本，給大家細致的介紹了一番 RediSearch 在項目實戰(zhàn)中關(guān)于索引創(chuàng)建與關(guān)聯(lián)源數(shù)據(jù)的用法，希望大家喜歡。

到此這篇關(guān)于Redis全文搜索教程之創(chuàng)建索引并關(guān)聯(lián)源數(shù)據(jù)的文章就介紹到這了,更多相關(guān)Redis創(chuàng)建索引并關(guān)聯(lián)源數(shù)據(jù)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: