Module: Elasticsearch::Persistence::Repository::Search

Includes:
QueryCache
Included in:
Class
Defined in:
lib/elasticsearch/persistence/repository/search.rb

Overview

Returns a collection of domain objects by an Elasticsearch query

Instance Method Summary collapse

Methods included from QueryCache

#cache_query, #store

Instance Method Details

#count(query_or_definition = nil, options = {}) ⇒ Integer

Return the number of domain object in the index

Examples:

Return the number of all domain objects


repository.count
# => 2

Return the count of domain object matching a simple query


repository.count('fox or dog')
# => 1

Return the count of domain object matching a query in the Elasticsearch DSL


repository.search(query: { match: { title: 'fox dog' } })
# => 1

Returns:

  • (Integer) 


79
80
81
82
83
84
85
86
 
# File 'lib/elasticsearch/persistence/repository/search.rb', line 79

def count(query_or_definition = nil, options = {})
  query_or_definition ||= { query: { match_all: {} } }

  request = { index: index_name, body: query_or_definition.to_hash }
  response = cache_query(to_curl(request.merge(options), "_count"), klass) { client.count(request.merge(options)) }

  response
end

#search(query_or_definition, options = {}) ⇒ Elasticsearch::Persistence::Repository::Response::Results

Returns a collection of domain objects by an Elasticsearch query

Pass the query either as a string or a Hash-like object

Examples:

Return objects matching a simple query


repository.search('fox or dog')

Return objects matching a query in the Elasticsearch DSL


repository.search(query: { match: { title: 'fox dog' } })

Define additional search parameters, such as highlighted excerpts


results = repository.search(query: { match: { title: 'fox dog' } }, highlight: { fields: { title: {} } })
 results.map_with_hit { |d,h| h.highlight.title.join }
 # => ["quick brown <em>fox</em>", "fast white <em>dog</em>"]

Perform aggregations as part of the request


results = repository.search query: { match: { title: 'fox dog' } },
                            aggregations: { titles: { terms: { field: 'title' } } }
results.response.aggregations.titles.buckets.map { |term| "#{term['key']}: #{term['doc_count']}" }
# => ["brown: 1", "dog: 1", ... ]

Pass additional options to the search request, such as ‘size`


repository.search query: { match: { title: 'fox dog' } }, size: 25
# GET http://localhost:9200/notes/note/_search
# > {"query":{"match":{"title":"fox dog"}},"size":25}

Returns:



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/elasticsearch/persistence/repository/search.rb', line 42

def search(query_or_definition, options = {})
  request = { index: index_name, body: query_or_definition.to_hash }

  case
  when query_or_definition.respond_to?(:to_hash)
    request.merge!(body: query_or_definition.to_hash)
  when query_or_definition.is_a?(String)
    request.merge!(q: query_or_definition)
  else
    raise ArgumentError, "[!] Pass the search definition as a Hash-like object or pass the query as a String" +
                         " -- #{query_or_definition.class} given."
  end

  response = cache_query(to_curl(request.merge(options)), klass) { client.search(request.merge(options)) }

  Response::Results.new(self, response)
end