FT.SEARCH

имя индекса. Сначала необходимо создать индекс, используя FT.CREATE.

текстовый запрос для поиска. Если запрос состоит из нескольких слов, заключите его в кавычки. Для получения дополнительных сведений обратитесь к синтаксису запроса.

возвращает идентификаторы документов, а не содержимое. Это полезно, если RediSearch используется только для индексирования внешней коллекции документов.

не пытается использовать стемминг для расширения запроса, а ищет термины запроса дословно.

также возвращает относительный внутренний рейтинг каждого документа. Это может быть использовано для объединения результатов из нескольких экземпляров.

получает необязательные данные платного документа. См. FT.CREATE. Данные платного документа следуют за идентификатором документа и, если WITHSCORES задано, за рейтингами.

возвращает значение ключа сортировки сразу после идентификатора и рейтинга и/или данных платного документа, если они запрошены. Обычно это не требуется и используется для целей согласования распределенного поиска. Этот параметр релевантен только при использовании в сочетании с SORTBY.

ограничивает результаты документами, у которых числовые значения находятся в диапазоне между min и max, если числовой атрибут определен как числовой атрибут в FT.CREATE. min и max следуют синтаксису ZRANGE и могут быть -inf, +inf, и использовать ( для исключающих диапазонов. Поддерживаются несколько числовых фильтров для разных атрибутов в одном запросе.

фильтрует результаты по заданному radius от lon до lat. Радиус задаётся числом и единицами измерения. Для получения дополнительных сведений см. GEORADIUS.

ограничивает результат заданным набором ключей, указанных в списке. Первый аргумент должен быть длиной списка и больше нуля. Несуществующие ключи игнорируются, если все ключи не существуют.

фильтрует результаты по тем, которые встречаются только в определенных атрибутах документа, например, title или URL . Вы должны указать num, что является количеством атрибутов, по которым вы фильтруете. Например, если вы запрашиваете title и URL, то num равно 2.

ограничивает атрибуты, возвращаемые из документа. num — это количество атрибутов, следующих за ключевым словом. Если num равно 0, оно действует как NOCONTENT. identifier — это либо имя атрибута (для хешей и JSON), либо выражение JSON Path (для JSON). property — это необязательное имя, используемое в результате. Если оно не указано, в результате используется identifier.

возвращает только части атрибута, содержащие соответствующий текст. Для получения дополнительной информации см. Выделение.

форматирует вхождения соответствующего текста. Для получения дополнительной информации см. Выделение.

является числом промежуточных терминов, которые разрешается вставить между терминами запроса. Предположим, что вы ищете фразу hello world. Если некоторые термины встречаются между hello и world, то SLOP больше 0 позволяет соответствовать этим текстовым атрибутам. По умолчанию ограничение на SLOP отсутствует.

требует, чтобы термины в документе имели тот же порядок, что и термины в запросе, независимо от расстояний между ними. Обычно используется в сочетании с SLOP По умолчанию false.

использует стеммер для заданного языка при поиске для расширения запроса. Если вы осуществляете поиск по документам на китайском языке, задайте chinese для правильного токенизации терминов запроса. По умолчанию используется английский. Если используется неподдерживаемый язык, команда возвращает ошибку. Список языков см. в FT.CREATE.

использует пользовательское расширение запроса вместо стеммера. См. Расширения.

использует пользовательскую функцию расчёта рейтингов, которую вы определяете. См. Расширения.

возвращает текстовое описание того, как были рассчитаны рейтинги. Использование этого параметра требует WITHSCORES.

добавляет произвольные, бинарно-безопасные данные, которые доступны пользовательским функциям расчёта рейтингов. См. Расширения.

сортирует результаты по значению этого атрибута. Это относится как к текстовым, так и к числовым атрибутам. Атрибуты, необходимые для SORTBY должны быть объявлены как SORTABLE в индексе, чтобы быть доступными с очень низкой задержкой. Обратите внимание, что это увеличивает объём занимаемой памяти.

ограничивает результаты заданным смещением и количеством результатов. Обратите внимание, что смещение нулевое. По умолчанию 0 10, что возвращает 10 элементов, начиная с первого результата. Для подсчёта количества документов в наборе результатов без фактического их возвращения можно использовать LIMIT 0 0.

переопределяет параметр таймаута модуля.

определяет один или несколько параметров значений. Каждый параметр имеет имя и значение.

Вы можете ссылаться на параметры в query по $, за которым следует имя параметра, например, $user. Каждая такая ссылка в запросе поиска на имя параметра заменяется соответствующим значением параметра. Например, с определением параметра PARAMS 4 lon 29.69465 lat 34.95126, выражение @loc:[$lon $lat 10 km] вычисляется в @loc:[29.69465 34.95126 10 km] . Вы не можете ссылаться на параметры в строке запроса, где не разрешены конкретные значения, например, в именах полей, например, @loc Для использования PARAMS, установите DIALECT в 2 или больше 2.

выбирает версию диалекта, в рамках которой будет выполняться запрос. Если не указано, запрос будет выполняться в рамках версии диалекта по умолчанию, установленной во время загрузки модуля или с помощью команды FT.CONFIG SET.

Поиск термина "волшебник" в каждом текстовом атрибуте индекса, содержащего данные о книгах.

127.0.0.1:6379> FT.SEARCH books-idx "wizard"

Ищите термин собаки в атрибуте title.

127.0.0.1:6379> FT.SEARCH books-idx "@title:dogs"

Ищите книги, опубликованные в 2020 или 2021 году.

127.0.0.1:6379> FT.SEARCH books-idx "@published_at:[2020 2021]"

Ищите китайские рестораны в радиусе 5 километров от долготы -122.41, широты 37.77 (Сан-Франциско).

127.0.0.1:6379> FT.SEARCH restaurants-idx "chinese @location:[-122.41 37.77 5 km]"

Ищите термин собаки или кошки в атрибуте title, но отдавайте предпочтение совпадениям с собаками (также известное как повышение значимости).

127.0.0.1:6379> FT.SEARCH books-idx "(@title:dogs | @title:cats) | (@title:dogs) => { $weight: 5.0; }"

Ищите книги, содержащие термин собаки в любом атрибуте TEXT в индексе, и запросите объяснение оценки для каждого результата.

127.0.0.1:6379> FT.SEARCH books-idx "dogs" WITHSCORES EXPLAINSCORE

Ищите книги с космосом в названии, которые имеют science в атрибуте TAG categories.

127.0.0.1:6379> FT.SEARCH books-idx "@title:space @categories:{science}"

Ищите книги, содержащие Python в любом атрибуте TEXT, возвращая 10 результатов, начиная с 11-го результата во всем наборе результатов (параметр смещения нулевой), и возвращая только атрибут title для каждого результата.

127.0.0.1:6379> FT.SEARCH books-idx "python" LIMIT 10 10 RETURN 1 title

Ищите книги, содержащие Python в любом атрибуте TEXT, возвращая цену, хранящуюся в исходном документе JSON.

127.0.0.1:6379> FT.SEARCH books-idx "python" RETURN 3 $.book.price AS price

Ищите книги с семантически похожими названиями на Планета Земля. Возвращайте 10 лучших результатов, отсортированных по расстоянию.

127.0.0.1:6379> FT.SEARCH books-idx "*=>[KNN 10 @title_embedding $query_vec AS title_score]" PARAMS 2 query_vec <"Planet Earth" embedding BLOB> SORTBY title_score DIALECT 2

Ищите фразу привет мир. Сначала создайте индекс.

127.0.0.1:6379> FT.CREATE memes SCHEMA phrase TEXT
OK

Добавьте вариации фразы привет мир.

127.0.0.1:6379> HSET s1 phrase "hello world"
(integer) 1
127.0.0.1:6379> HSET s2 phrase "hello simple world"
(integer) 1
127.0.0.1:6379> HSET s3 phrase "hello somewhat less simple world"
(integer) 1
127.0.0.1:6379> HSET s4 phrase "hello complicated yet encouraging problem solving world"
(integer) 1
127.0.0.1:6379> HSET s5 phrase "hello complicated yet amazingly encouraging problem solving world"
(integer) 1

Затем ищите фразу привет мир. Результат возвращает все документы, содержащие фразу.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello world)' NOCONTENT 
1) (integer) 5
2) "s1"
3) "s2"
4) "s3"
5) "s4"
6) "s5"

Теперь верните все документы, имеющие одну или меньше слов между привет и мир.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello world)' NOCONTENT SLOP 1
1) (integer) 2
2) "s1"
3) "s2"

Теперь верните все документы с тремя или менее словами между привет и мир.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello world)' NOCONTENT SLOP 3
1) (integer) 3
2) "s1"
3) "s2"
4) "s3"

s5 требуется более высокая SLOP для совпадения, SLOP 6 или выше, точно. Посмотрите, что произойдёт, если вы установите SLOP в 5.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello world)' NOCONTENT SLOP 5
1) (integer) 4
2) "s1"
3) "s2"
4) "s3"
5) "s4"

Если вы добавите дополнительные термины (и стемминг), вы получите такие результаты.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello amazing world)' NOCONTENT 
1) (integer) 1
2) "s5"

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello encouraged world)' NOCONTENT SLOP 5
1) (integer) 2
2) "s4"
3) "s5"

127.0.0.1:6379> FT.SEARCH memes '@phrase:(hello encouraged world)' NOCONTENT SLOP 4
1) (integer) 1
2) "s4"

Если вы поменяете местами термины, вы всё ещё можете получить правильную фразу.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(amazing hello world)' NOCONTENT
1) (integer) 1
2) "s5"

Но, если вы используете INORDER, вы получите ноль результатов.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(amazing hello world)' NOCONTENT INORDER
1) (integer) 0

Аналогично, если вы используете атрибут запроса $inorder установленный на true, s5 не будет получено.

127.0.0.1:6379> FT.SEARCH memes '@phrase:(amazing hello world)=>{$inorder: true;}' NOCONTENT
1) (integer) 0

Подводя итог, аргумент INORDER или атрибут запроса $inorder требуют, чтобы термины запроса соответствовали терминам с похожим порядком.