An Elixir flavored DSL for building JSON based settings, mappings, queries, percolators to Elasticsearch engine.
Hint: Check out /examples directory as a quick intro.
Let's define the mapping for specific document type:
import Tirexs.Mapping
index = [index: "articles", type: "article"]
mappings do
indexes "id", type: "long", index: "not_analyzed", include_in_all: false
indexes "title", type: "string", boost: 2.0, analyzer: "snowball"
indexes "tags", type: "string", analyzer: "keyword"
indexes "content", type: "string", analyzer: "snowball"
indexes "authors", [type: "object"] do
indexes "name", type: "string"
indexes "nick_name", type: "string"
end
end
{ :ok, status, body } = Tirexs.Mapping.create_resource(index)Then let's populate an articles index:
import Tirexs.Bulk
require Tirexs.ElasticSearch
settings = Tirexs.ElasticSearch.config()
Tirexs.Bulk.store [index: "articles", refresh: true], settings do
create id: 1, title: "One", tags: ["elixir"], type: "article"
create id: 2, title: "Two", tags: ["elixir", "ruby"], type: "article"
create id: 3, title: "Three", tags: ["java"], type: "article"
create id: 4, title: "Four", tags: ["erlang"], type: "article"
endNOTE
If you want to provide a dynamic list of documents you can prepare a list of document in this way:
docs = [
create: [id: 1, title: "One", tags: ["elixir"], type: "article"],
create: [id: 2, title: "Two", tags: ["elixir", "ruby"], type: "article"],
create: [id: 3, title: "Three", tags: ["java"], type: "article"],
create: [id: 4, title: "Four", tags: ["erlang"], type: "article"]
# more...
]and call:
Tirexs.Bulk.store [index: "articles", refresh: true], settings, do: docsNow, let's go further. We will be searching for articles whose title begins with letter “T”, sorted by title in descending order, filtering them for ones tagged “elixir”, and also retrieving some facets:
import Tirexs.Search
require Tirexs.Query
articles = search [index: "articles"] do
query do
string "title:T*"
end
filter do
terms "tags", ["elixir", "ruby"]
end
facets do
global_tags [global: true] do
terms field: "tags"
end
current_tags do
terms field: "tags"
end
end
sort do
[
[title: "desc"]
]
end
end
result = Tirexs.Query.create_resource(articles)
Enum.each Tirexs.Query.result(result, :hits), fn(item) ->
IO.puts inspect(item)
#=> [{"_index","articles"},{"_type","article"},{"_id","2"},{"_score",1.0},{"_source",[{"id",2}, {"title","Two"},{"tags",["elixir","r uby"]},{"type","article"}]}]
endLet's display the global facets:
Enum.each Tirexs.Query.result(result, :facets).global_tags.terms, fn(f) ->
IO.puts "#{f.term} #{f.count}"
end
#=> elixir 2
#=> ruby 1
#=> java 1
#=> erlang 1Now, let's display the facets based on current query (notice that count for articles tagged with 'java' is included, even though it's not returned by our query; count for articles tagged 'erlang' is excluded, since they don't match the current query):
Enum.each Tirexs.Query.result(result, :facets).current_tags.terms, fn(f) ->
IO.puts "#{f.term} #{f.count}"
end
#=> ruby 1
#=> java 1
#=> elixir 1In the end, a snippet about using a Percolator (check out the examples/percolator.exs)
percolator = percolator [index: "my-index", name: 1] do
query do
match "message", "bonsai tree"
end
end
{_, _, body} = Tirexs.Percolator.create_resource(percolator, settings)
percolator = percolator [index: "my-index", type: "message"] do
doc do
[[message: "A new bonsai tree in the office"]]
end
end
{_, _, body} = Tirexs.Percolator.match(percolator, settings)If you feel like porting or fixing something, please drop a pull request or issue tracker at GitHub! Check out the CONTRIBUTING.md for more details.
Tirexs source code is released under Apache 2 License.
Check LICENSE and NOTICE files for more details. The project HEAD is https://github.com/zatvobor/tirexs.