Upgrade to 2.0
Details about upgrading to RediSearch 2.x from 1.x
Upgrade to 2.0 when running in Redis OSS
For enterprise upgrade please refer to the following link.
v2 of RediSearch re-architects the way indices are kept in sync with the data. Instead of using
FT.ADD command to index documents, RediSearch 2.0 follows hashes that match the index description regardless of how those were inserted or changed on Redis (
HDEL). The index description will filter hashes on a prefix of the key, and allows you to construct fine-grained filters with the
FILTER option. This description can be defined during index creation (
v1.x indices (further referred to as legacy indices) don't have such index description. That is why you will need to supply their descriptions when upgrading to v2. During the upgrade to v2, you should add the descriptions via the module's configuration so RediSearch 2.0 will be able to load these legacy indexes.
The upgrade index configuration allows you to specify the legacy index to upgrade. It needs to specify the index name and all the
on hash arguments that can be defined on
FT.CREATE command (notice that only the index name is mandatory, the other arguments have default values which are the same as the default values on
FT.CREATE command). So for example, if you have a legacy index called
idx, in order for RediSearch 2.0 to load it, the following configuration needs to be added to the server on start time:
redis-server --loadmodule redisearch.so UPGRADE_INDEX idx
It is also possible to specify the prefixes to follow. For example, assuming all the documents indexed by
idx starts with the prefix
idx:, the following will upgrade the legacy index
redis-server --loadmodule redisearch.so UPGRADE_INDEX idx PREFIX 1 idx:
The way that the upgrade process works behind the scenes is that it redefines the index with the
on hash index description given in the configuration and then reindexes the data. This comes with some limitations:
NOSAVEwas used, then it's not possible to upgrade because the data for reindexing does not exist.
- If you have multiple indices, you need to find the way for RediSearch to identify which hashes belong to which index. You can do it either with a prefix or a filter.
- If you have hashes that are not indexed, you will need to find a way so that RediSearch will be able to identify only the hashes that need to be indexed. This can be done using a prefix or a filter.