Class: Searchkick::Query

Inherits:

Object

• Object
• Searchkick::Query

Defined in:

lib/searchkick/query.rb,
lib/searchkick/logging.rb

Instance Attribute Summary

• #body ⇒ Object

  Returns the value of attribute body.

• #klass ⇒ Object readonly

  Returns the value of attribute klass.

• #options ⇒ Object readonly

  Returns the value of attribute options.

• #term ⇒ Object readonly

  Returns the value of attribute term.

Instance Method Summary

• #execute ⇒ Object
• #execute_with_instrumentation ⇒ Object
• #initialize(klass, term, options = {}) ⇒ Query constructor

  A new instance of Query.

• #params ⇒ Object
• #searchkick_index ⇒ Object
• #searchkick_klass ⇒ Object
• #searchkick_options ⇒ Object

Constructor Details

#initialize(klass, term, options = {}) ⇒ Query

Returns a new instance of Query.

# File 'lib/searchkick/query.rb', line 6

def initialize(klass, term, options = {})
  if term.is_a?(Hash)
    options = term
    term = "*"
  else
    term = term.to_s
  end

  @klass = klass
  @term = term
  @options = options

  below12 = Gem::Version.new(Searchkick.server_version) < Gem::Version.new("1.2")
  below14 = Gem::Version.new(Searchkick.server_version) < Gem::Version.new("1.4")

  boost_fields = {}
  fields =
    if options[:fields]
      if options[:autocomplete]
        options[:fields].map{|f| "#{f}.autocomplete" }
      else
        options[:fields].map do |value|
          k, v = value.is_a?(Hash) ? value.to_a.first : [value, :word]
          k2, boost = k.to_s.split("^", 2)
          field = "#{k2}.#{v == :word ? "analyzed" : v}"
          boost_fields[field] = boost.to_f if boost
          field
        end
      end
    else
      if options[:autocomplete]
        (searchkick_options[:autocomplete] || []).map{|f| "#{f}.autocomplete" }
      else
        ["_all"]
      end
    end

  operator = options[:operator] || (options[:partial] ? "or" : "and")

  # pagination
  page = [options[:page].to_i, 1].max
  per_page = (options[:limit] || options[:per_page] || 100000).to_i
  padding = [options[:padding].to_i, 0].max
  offset = options[:offset] || (page - 1) * per_page + padding

  # model and eagar loading
  load = options[:load].nil? ? true : options[:load]

  conversions_field = searchkick_options[:conversions]
  personalize_field = searchkick_options[:personalize]

  all = term == "*"
  facet_limits = {}

  options[:json] ||= options[:body]
  if options[:json]
    payload = options[:json]
  else
    if options[:query]
      payload = options[:query]
    elsif options[:similar]
      payload = {
        more_like_this: {
          fields: fields,
          like_text: term,
          min_doc_freq: 1,
          min_term_freq: 1,
          analyzer: "searchkick_search2"
        }
      }
    elsif all
      payload = {
        match_all: {}
      }
    else
      if options[:autocomplete]
        payload = {
          multi_match: {
            fields: fields,
            query: term,
            analyzer: "searchkick_autocomplete_search"
          }
        }
      else
        queries = []
        fields.each do |field|
          qs = []

          factor = boost_fields[field] || 1
          shared_options = {
            query: term,
            operator: operator,
            boost: factor
          }

          if field == "_all" or field.end_with?(".analyzed")
            shared_options[:cutoff_frequency] = 0.001 unless operator == "and"
            qs.concat [
              shared_options.merge(boost: 10 * factor, analyzer: "searchkick_search"),
              shared_options.merge(boost: 10 * factor, analyzer: "searchkick_search2")
            ]
            misspellings = options.has_key?(:misspellings) ? options[:misspellings] : options[:mispellings] # why not?
            if misspellings != false
              edit_distance = (misspellings.is_a?(Hash) && (misspellings[:edit_distance] || misspellings[:distance])) || 1
              qs.concat [
                shared_options.merge(fuzziness: edit_distance, max_expansions: 3, analyzer: "searchkick_search"),
                shared_options.merge(fuzziness: edit_distance, max_expansions: 3, analyzer: "searchkick_search2")
              ]
            end
          elsif field.end_with?(".exact")
            f = field.split(".")[0..-2].join(".")
            queries << {match: {f => shared_options.merge(analyzer: "keyword")}}
          else
            analyzer = field.match(/\.word_(start|middle|end)\z/) ? "searchkick_word_search" : "searchkick_autocomplete_search"
            qs << shared_options.merge(analyzer: analyzer)
          end

          queries.concat(qs.map{|q| {match: {field => q}} })
        end

        payload = {
          dis_max: {
            queries: queries
          }
        }
      end

      if conversions_field and options[:conversions] != false
        # wrap payload in a bool query
        script_score =
          if below12
            {script_score: {script: "doc['count'].value"}}
          else
            {field_value_factor: {field: "count"}}
          end

        payload = {
          bool: {
            must: payload,
            should: {
              nested: {
                path: conversions_field,
                score_mode: "total",
                query: {
                  function_score: {
                    boost_mode: "replace",
                    query: {
                      match: {
                        query: term
                      }
                    }
                  }.merge(script_score)
                }
              }
            }
          }
        }
      end
    end

    custom_filters = []

    boost_by = options[:boost_by] || {}
    if boost_by.is_a?(Array)
      boost_by = Hash[ boost_by.map{|f| [f, {factor: 1}] } ]
    end
    if options[:boost]
      boost_by[options[:boost]] = {factor: 1}
    end

    boost_by.each do |field, value|
      script_score =
        if below12
          {script_score: {script: "#{value[:factor].to_f} * log(doc['#{field}'].value + 2.718281828)"}}
        else
          {field_value_factor: {field: field, factor: value[:factor].to_f, modifier: "ln2p"}}
        end

      custom_filters << {
        filter: {
          exists: {
            field: field
          }
        }
      }.merge(script_score)
    end

    boost_where = options[:boost_where] || {}
    if options[:user_id] and personalize_field
      boost_where[personalize_field] = options[:user_id]
    end
    if options[:personalize]
      boost_where = boost_where.merge(options[:personalize])
    end
    boost_where.each do |field, value|
      if value.is_a?(Array) and value.first.is_a?(Hash)
        value.each do |value_factor|
          value, factor = value_factor[:value], value_factor[:factor]
          custom_filters << custom_filter(field, value, factor)
        end
      elsif value.is_a?(Hash)
        value, factor = value[:value], value[:factor]
        custom_filters << custom_filter(field, value, factor)
      else
        factor = 1000
        custom_filters << custom_filter(field, value, factor)
      end
    end

    boost_by_distance = options[:boost_by_distance]
    if boost_by_distance
      boost_by_distance = {function: :gauss, scale: "5mi"}.merge(boost_by_distance)
      if !boost_by_distance[:field] or !boost_by_distance[:origin]
        raise ArgumentError, "boost_by_distance requires :field and :origin"
      end
      function_params = boost_by_distance.select{|k,v| [:origin, :scale, :offset, :decay].include?(k) }
      function_params[:origin] = function_params[:origin].reverse
      custom_filters << {
        boost_by_distance[:function] => {
          boost_by_distance[:field] => function_params
        }
      }
    end

    if custom_filters.any?
      payload = {
        function_score: {
          functions: custom_filters,
          query: payload,
          score_mode: "sum"
        }
      }
    end

    payload = {
      query: payload,
      size: per_page,
      from: offset
    }
    payload[:explain] = options[:explain] if options[:explain]

    # order
    if options[:order]
      order = options[:order].is_a?(Enumerable) ? options[:order] : {options[:order] => :asc}
      # TODO id transformation for arrays
      payload[:sort] = order.is_a?(Array) ? order : Hash[ order.map{|k, v| [k.to_s == "id" ? :_id : k, v] } ]
    end

    # filters
    filters = where_filters(options[:where])
    if filters.any?
      payload[:filter] = {
        and: filters
      }
    end

    # facets
    if options[:facets]
      facets = options[:facets] || {}
      if facets.is_a?(Array) # convert to more advanced syntax
        facets = Hash[ facets.map{|f| [f, {}] } ]
      end

      payload[:facets] = {}
      facets.each do |field, facet_options|
        # ask for extra facets due to
        # https://github.com/elasticsearch/elasticsearch/issues/1305
        size = facet_options[:limit] ? facet_options[:limit] + 150 : 100000

        if facet_options[:ranges]
          payload[:facets][field] = {
            range: {
              field.to_sym => facet_options[:ranges]
            }
          }
        elsif facet_options[:stats]
          payload[:facets][field] = {
            terms_stats: {
              key_field: field,
              value_script: below14 ? "doc.score" : "_score",
              size: size
            }
          }
        else
          payload[:facets][field] = {
            terms: {
              field: field,
              size: size
            }
          }
        end

        facet_limits[field] = facet_options[:limit] if facet_options[:limit]

        # offset is not possible
        # http://elasticsearch-users.115913.n3.nabble.com/Is-pagination-possible-in-termsStatsFacet-td3422943.html

        facet_options.deep_merge!(where: options[:where].reject{|k| k == field}) if options[:smart_facets] == true
        facet_filters = where_filters(facet_options[:where])
        if facet_filters.any?
          payload[:facets][field][:facet_filter] = {
            and: {
              filters: facet_filters
            }
          }
        end
      end
    end

    # suggestions
    if options[:suggest]
      suggest_fields = (searchkick_options[:suggest] || []).map(&:to_s)

      # intersection
      if options[:fields]
        suggest_fields = suggest_fields & options[:fields].map{|v| (v.is_a?(Hash) ? v.keys.first : v).to_s.split("^", 2).first }
      end

      if suggest_fields.any?
        payload[:suggest] = {text: term}
        suggest_fields.each do |field|
          payload[:suggest][field] = {
            phrase: {
              field: "#{field}.suggest"
            }
          }
        end
      end
    end

    # highlight
    if options[:highlight]
      payload[:highlight] = {
        fields: Hash[ fields.map{|f| [f, {}] } ]
      }

      if options[:highlight].is_a?(Hash)
        if tag = options[:highlight][:tag]
          payload[:highlight][:pre_tags] = [tag]
          payload[:highlight][:post_tags] = [tag.to_s.gsub(/\A</, "</")]
        end

        highlight_fields = options[:highlight][:fields]
        if highlight_fields
          payload[:highlight][:fields] = {}

          highlight_fields.each do |name, opts|
            payload[:highlight][:fields]["#{name}.analyzed"] = opts || {}
          end
        end
      end
    end

    # An empty array will cause only the _id and _type for each hit to be returned
    # http://www.elasticsearch.org/guide/reference/api/search/fields/
    if options[:select]
      payload[:fields] = options[:select] if options[:select] != true
    elsif load
      payload[:fields] = []
    end

    if options[:type] or klass != searchkick_klass
      @type = [options[:type] || klass].flatten.map{|v| searchkick_index.klass_document_type(v) }
    end
  end

  @body = payload
  @facet_limits = facet_limits
  @page = page
  @per_page = per_page
  @padding = padding
  @load = load
end

Instance Attribute Details

#body ⇒ Object

Returns the value of attribute body.

# File 'lib/searchkick/query.rb', line 4

def body
  @body
end

#klass ⇒ Object (readonly)

Returns the value of attribute klass.

# File 'lib/searchkick/query.rb', line 3

def klass
  @klass
end

#options ⇒ Object (readonly)

Returns the value of attribute options.

# File 'lib/searchkick/query.rb', line 3

def options
  @options
end

#term ⇒ Object (readonly)

Returns the value of attribute term.

# File 'lib/searchkick/query.rb', line 3

def term
  @term
end

Instance Method Details

#execute ⇒ Object

# File 'lib/searchkick/query.rb', line 401

def execute
  begin
    response = Searchkick.client.search(params)
  rescue => e # TODO rescue type
    status_code = e.message[1..3].to_i
    if status_code == 404
      raise MissingIndexError, "Index missing - run #{searchkick_klass.name}.reindex"
    elsif status_code == 500 and (
        e.message.include?("IllegalArgumentException[minimumSimilarity >= 1]") or
        e.message.include?("No query registered for [multi_match]") or
        e.message.include?("[match] query does not support [cutoff_frequency]]") or
        e.message.include?("No query registered for [function_score]]")
      )

      raise UnsupportedVersionError, "This version of Searchkick requires Elasticsearch 1.0 or greater"
    elsif status_code == 400
      if e.message.include?("[multi_match] analyzer [searchkick_search] not found")
        raise InvalidQueryError, "Bad mapping - run #{searchkick_klass.name}.reindex"
      else
        raise InvalidQueryError, e.message
      end
    else
      raise e
    end
  end

  # apply facet limit in client due to
  # https://github.com/elasticsearch/elasticsearch/issues/1305
  @facet_limits.each do |field, limit|
    field = field.to_s
    facet = response["facets"][field]
    response["facets"][field]["terms"] = facet["terms"].first(limit)
    response["facets"][field]["other"] = facet["total"] - facet["terms"].sum{|term| term["count"] }
  end

  opts = {
    page: @page,
    per_page: @per_page,
    padding: @padding,
    load: @load,
    includes: options[:include] || options[:includes],
    json: !options[:json].nil?
  }
  Searchkick::Results.new(searchkick_klass, response, opts)
end

#execute_with_instrumentation ⇒ Object

# File 'lib/searchkick/logging.rb', line 5

def execute_with_instrumentation
  event = {
    name: "#{searchkick_klass.name} Search",
    query: params
  }
  ActiveSupport::Notifications.instrument("search.searchkick", event) do
    execute_without_instrumentation
  end
end

#params ⇒ Object

# File 'lib/searchkick/query.rb', line 392

def params
  params = {
    index: options[:index_name] || searchkick_index.name,
    body: body
  }
  params.merge!(type: @type) if @type
  params
end

#searchkick_index ⇒ Object

# File 'lib/searchkick/query.rb', line 380

def searchkick_index
  klass.searchkick_index
end

#searchkick_klass ⇒ Object

# File 'lib/searchkick/query.rb', line 388

def searchkick_klass
  klass.searchkick_klass
end

#searchkick_options ⇒ Object

# File 'lib/searchkick/query.rb', line 384

def searchkick_options
  klass.searchkick_options
end