Class: Redis::Commands::Search::TextField

Inherits:
Field
  • Object
show all
Defined in:
lib/redis/commands/modules/search/field.rb

Overview

A TEXT field, indexing full-text searchable content.

Instance Attribute Summary

Attributes inherited from Field

#alias_name, #name, #options, #query, #type

Instance Method Summary collapse

Constructor Details

#initialize(name, query = nil, **options) ⇒ TextField

Build a TEXT field.

Parameters:

  • name (String, Symbol) —

    the document attribute the field indexes

  • query (Query, nil) (defaults to: nil) —

    a query the field is bound to, enabling #match

  • options (Hash) —

    a customizable set of options

Options Hash (**options):

  • :weight (Numeric) —

    the field's scoring weight (+WEIGHT+)

  • :phonetic (String) —

    phonetic matcher, one of dm:en, dm:fr, dm:pt, dm:es (+PHONETIC+)

  • :no_stem (Boolean) —

    disable stemming (+NOSTEM+)

Raises:

  • (ArgumentError) —

    if :phonetic is not a supported matcher



95
96
97
98
99
100
101
102
103
 
# File 'lib/redis/commands/modules/search/field.rb', line 95

def initialize(name, query = nil, **options)
  super(name, :text, query, **options)
  if options[:phonetic]
    valid_matchers = ['dm:en', 'dm:fr', 'dm:pt', 'dm:es']
    unless valid_matchers.include?(options[:phonetic])
      raise ArgumentError, "Invalid phonetic matcher. Supported matchers are: #{valid_matchers.join(', ')}"
    end
  end
end

Instance Method Details

#match(pattern, raw: false) ⇒ Query

Add a text-match predicate (+@field:(pattern)+) to the bound query.

Parameters:

  • pattern (String) —

    the text pattern to match

  • raw (Boolean) (defaults to: false) —

    when true, treat pattern as a raw RediSearch expression so operators such as wildcards (+*+) and OR (+|+) apply; when false (default) the pattern is escaped and matched literally

Returns:

  • (Query) —

    the bound query with the predicate added



133
134
135
 
# File 'lib/redis/commands/modules/search/field.rb', line 133

def match(pattern, raw: false)
  query.add_predicate(TextMatchPredicate.new(@alias_name || name, pattern, raw: raw))
end

#to_args ⇒ Array

Render this field as the array of FT.CREATE SCHEMA tokens.

Returns:

  • (Array) —

    the schema tokens for this field



108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
 
# File 'lib/redis/commands/modules/search/field.rb', line 108

def to_args
  args = [@name]
  args << "AS" << @alias_name if @alias_name
  args << @type.to_s.upcase
  args << "NOSTEM" if @options[:no_stem]
  args << "WEIGHT" << @options[:weight].to_s if @options[:weight]
  args << "PHONETIC" << @options[:phonetic] if @options[:phonetic]

  # Add suffix options in specific order: no_index, index_missing, index_empty, sortable, withsuffixtrie
  args << "NOINDEX" if @options[:no_index]
  args << "INDEXMISSING" if @options[:index_missing]
  args << "INDEXEMPTY" if @options[:index_empty]
  args << "SORTABLE" if @options[:sortable]
  args << "WITHSUFFIXTRIE" if @options[:withsuffixtrie]

  args
end