RediSearch Quick Start Tutorial
For this quick start, you will need the following:
Add RediSearch Module to Redis Enterprise Software Cluster
Download the Module
To download this module, go to the Redis Enterprise downloads page. The module should be downloaded to wherever you use a browser to access the Redis Enterprise Software web UI.
Add Module to UI
- Log into the Redis Enterprise Software web UI
- Navigate to the settings -> redise modules
- Click on Add Module button and navigate to where you downloaded the module package
- Click on the Upload button and notice the name and version
Create a new database that uses the Module
- Navigate to databases tab
- Click on the + sign, if necessary, then create database
- On the create database screen, check the box for Redis Modules and select the module you want to use for this database.
- Click Show advanced options and put 12544 for the port.
- Click the activate button
Let’s create a new index called “myidx”. When you define the index, you must pass in the structure of the data you will be adding to the index. In this example, we have four things we input, the title, body, url, and value. In this example, we have three TEXT and one NUMERIC values. The title has a weight of 5.0.
127.0.0.1:12544> FT.CREATE myIdx SCHEMA title TEXT WEIGHT 5.0 body TEXT url TEXT value NUMERIC
Add info to test index
Now add some data to this index. We will add an object which key will be doc1 and then adds a title of “hello world”, body of “my favorite object”, and url of “https://redislabs.com/” to the object as follows:
127.0.0.1:12544> FT.ADD myIdx doc1 1.0 FIELDS title "hello world" body "My first object" url "https://redislabs.com/" OK
Search the Index
Do a search on this index for any object with the word “first”:
127.0.0.1:12544> FT.SEARCH myIdx "first" LIMIT 0 10 1) (integer) 1 2) "doc1" 3) 1) "title" 2) "hello world" 3) "body" 4) "My first object" 5) "url" 6) "https://redislabs.com/"
Drop the Index
Now that we are done with it, we can drop the index.
127.0.0.1:12544> FT.DROP myIdx OK
Auto-Complete and Search Engine Suggestions
Let’s add a suggestion for the search engine to use
127.0.0.1:12544> FT.SUGADD autocomplete "hello world" 100 "(integer)" 1
Make sure the suggestion is there:
127.0.0.1:12544> FT.SUGGET autocomplete "he" 1) "hello world"