/redisearch-go

Go client for RediSearch

Primary LanguageGoBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

license CircleCI GitHub issues Codecov Go Report Card GoDoc

RediSearch Go Client

Mailing List Gitter

Go client for RediSearch, based on redigo.

Installing

go get github.com/RediSearch/redisearch-go/redisearch

Usage Example

package main 
import (
	"fmt"
	"log"
	"time"

	"github.com/RediSearch/redisearch-go/redisearch"
)

func ExampleClient() {

	// Create a client. By default a client is schemaless
	// unless a schema is provided when creating the index
	c := redisearch.NewClient("localhost:6379", "myIndex")

	// Create a schema
	sc := redisearch.NewSchema(redisearch.DefaultOptions).
		AddField(redisearch.NewTextField("body")).
		AddField(redisearch.NewTextFieldOptions("title", redisearch.TextFieldOptions{Weight: 5.0, Sortable: true})).
		AddField(redisearch.NewNumericField("date"))

	// Drop an existing index. If the index does not exist an error is returned
	c.Drop()

	// Create the index with the given schema
	if err := c.CreateIndex(sc); err != nil {
		log.Fatal(err)
	}

	// Create a document with an id and given score
	doc := redisearch.NewDocument("doc1", 1.0)
	doc.Set("title", "Hello world").
		Set("body", "foo bar").
		Set("date", time.Now().Unix())

	// Index the document. The API accepts multiple documents at a time
	if err := c.Index([]redisearch.Document{doc}...); err != nil {
		log.Fatal(err)
	}

	// Searching with limit and sorting
	docs, total, err := c.Search(redisearch.NewQuery("hello world").
		Limit(0, 2).
		SetReturnFields("title"))

	fmt.Println(docs[0].Id, docs[0].Properties["title"], total, err)
	// Output: doc1 Hello world 1 <nil>
}

Supported RediSearch Commands

Command Recommended API and godoc
FT.CREATE CreateIndex
FT.ADD IndexOptions
FT.ADDHASH N/A
FT.ALTER N/A
FT.ALIASADD N/A
FT.ALIASUPDATE N/A
FT.ALIASDEL N/A
FT.INFO Info
FT.SEARCH Search
FT.AGGREGATE Aggregate
FT.CURSOR Aggregate + (*WithCursor option set to True)
FT.EXPLAIN Explain
FT.DEL Delete
FT.GET N/A
FT.MGET N/A
FT.DROP Drop
FT.TAGVALS N/A
FT.SUGADD N/A
FT.SUGGET N/A
FT.SUGDEL N/A
FT.SUGLEN N/A
FT.SYNADD N/A
FT.SYNUPDATE N/A
FT.SYNDUMP N/A
FT.SPELLCHECK SpellCheck
FT.DICTADD N/A
FT.DICTDEL N/A
FT.DICTDUMP N/A
FT.CONFIG N/A