Elasticated

Elasticsearch Wrapper, with Query & Mapping Builders

HOW TO instantiate a repository

repository = Elasticated::Repository.new # pointing to localhost
repository = Elasticated::Repository.new host: 'http://user:pass@192.168.1.2:9200' # pointing to some secured server
repository = Elasticated::Repository.new host: 'myhost', index: 'myindex', type: 'mytype' # pointing to some type of some index

HOW TO build a query

query = Query.build do
  filter do
    equal :first_name, 'Pablo'
  end
  conditions do
    between :age, 20, 25
    must_not do
      wildcard :second_name, 'Santiago*'
    end
    should do
      gt :age, 23
      lt :age, 22
    end
    minimum_should_match 1
  end
  post do
    equal :city, 'CABA'
  end
  aggregations do
    group :register_number, size: 10
  end
  from 5
  size 15
end
query.build # see the result

HOW TO execute a search

repository = Repository.new
query = Query.new
repository.execute_count query
repository.execute_search query
repository.execute_aggregations query
repository.execute_aggregated_search query
repository.delete_by query
repository.exists? query

HOW TO build a document, index or update it

document = Document.create do |doc|
  doc.id = 'my_unique_id'
  doc.index = 'myindex'
  doc.type = 'mytype'
  doc.source = { user: 'Pablo', some_field: 'some_value' }
end
repository = Repository.new
repository.index_document document
repository.update_document document

HOW TO start a resumable scroll

repository = Elasticated::Repository.new
query = Elasticated::Query.new
# prepare the 'search' object
search = repository.prepare_search query, index: 'my_index', type: 'my_type'
# fetch the first page of results
results = search.start
# get the scroll_id, and use it again later
scroll_id = search.scroll_id # also results.scroll_id is valid

HOW TO resume a scroll

repository = Elasticated::Repository.new
scroll_id = '...' # the scroll_id returned by the 'search' object
# prepare the 'search' object
search = repository.restore_search scroll_id
# fetch the next page of results
results = search.fetch
# fetch all pages until the search ends
results.append search.fetch until search.completed?

HOW TO build a mapping

mapping = Elasticated::Mapping.build do
  type :content do
    date :date
    string :user
    analyzed_string :user_alias
    nested :user_purchases do
      long :purchase_id
      string :items
    end
    object :user_info do
      string :address
    end
  end
end

HOW TO configure the gem

Elasticated.configure do |config|
  config.logger = Elasticated::Loggers::DefaultLogger.new
  config.scroll_expiration_time = '3m'
  config.scroll_page_size = 500
  config.search_page_size = 1000
  config.transport_options.request_timeout = 5*60
end

HOW TO configure some specific repository

repository = Repository.new
repository.logger = Elasticated::Loggers::DefaultLogger.new
repository.scroll_expiration_time = '3m'
repository.scroll_page_size = 500
repository.search_page_size = 1000
# transport_options cannot be setted for a single repository