{"id":7262,"date":"2013-03-07T11:34:54","date_gmt":"2013-03-07T10:34:54","guid":{"rendered":"https:\/\/blog.trifork.com\/?p=7262"},"modified":"2013-03-07T11:34:54","modified_gmt":"2013-03-07T10:34:54","slug":"searching-with-the-elasticshell","status":"publish","type":"post","link":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/","title":{"rendered":"Searching with the elasticshell"},"content":{"rendered":"

\"elasticshell\"<\/a>
\nSo as promised here is a sequel to my previous post Introducing the elasticshell<\/a>. Let’s start exactly where we left off…<\/p>\n

What about search?<\/strong>
\nWe of course need to search against the created index. We can provide queries as either json documents or Java QueryBuilders<\/code><\/a> provided with the elasticsearch Java API, which are exposed to the shell as they are.
\n
\nHere is an example using the basic search method; we can either search on all indexes or on a specific index (and type too). When no query is specified, the match_all<\/a> query is used. Since we are lazy by nature, and we don’t want to write a whole query by ourselves, let’s say we want to execute a multi match query<\/a>, thus we start just copy pasting the example taken from the query DSL documentation.<\/p>\n

\n> var query = {\n...   "multi_match" : {\n...     "query" : "this is a test",\n...     "fields" : [ "subject", "message" ]\n...   }\n... }\n<\/pre>\n
Now we can customize our example as we prefer.<\/p>\n
\n> query.multi_match.query="elasticshell"\nelasticshell\n> query.multi_match.fields=["title^2","content"]\n[title^2, content]\n> query\n{\n  "multi_match": {\n    "query": "elasticshell",\n    "fields": [\n      "title^2",\n      "content"\n    ]\n  }\n}\n<\/pre>\n
The basic search method accepts the whole search source as parameter, which might contain facets, sort and many more fragments. Thus we need to wrap our query in a new json object, let’s call it searchSource<\/code>.<\/p>\n
\n> var searchSource={}\n> searchSource.query=query\n{\n  "multi_match": {\n    "query": "elasticshell",\n    "fields": [\n      "title^2",\n      "content"\n    ]\n  }\n}\n> searchSource\n{\n  "query": {\n    "multi_match": {\n      "query": "elasticshell",\n      "fields": [\n        "title^2",\n        "content"\n      ]\n    }\n  }\n}\n<\/pre>\n
We are now ready to execute our search:<\/p>\n
\n> es.search(searchSource);\n{\n  "took": 6,\n  "timed_out": false,\n  "_shards": {\n    "total": 5,\n    "successful": 5,\n    "failed": 0\n  },\n  "hits": {\n    "total": 1,\n    "max_score": 0.19178301,\n    "hits": [\n      {\n        "_index": "blog",\n        "_type": "trifork",\n        "_id": "1",\n        "_score": 0.19178301,\n        "_source": {\n          "title": "Introducing the elasticshell",\n          "author": "Luca Cavanna",\n          "content": "A few days ago I released the first beta version of the elasticshell, a shell for elasticsearch."\n        }\n      }\n    ]\n  }\n}\n<\/pre>\n
Here is how we can achieve the same result using the more flexible searchBuilder<\/code> method, which allows to specify all the options that elasticsearch supports. The difference is that we don’t need to specify the whole search source but only the needed parts, like only the query in the example below. We can just use a fragment of the searchSource json object, since it’s native in the shell.<\/p>\n
\n> es.searchBuilder().query(searchSource.query).execute();\n{\n  "took": 5,\n  "timed_out": false,\n  "_shards": {\n    "total": 5,\n    "successful": 5,\n    "failed": 0\n  },\n  "hits": {\n    "total": 1,\n    "max_score": 0.19178301,\n    "hits": [\n      {\n        "_index": "blog",\n        "_type": "trifork",\n        "_id": "1",\n        "_score": 0.19178301,\n        "_source": {\n          "title": "Introducing the elasticshell",\n          "author": "Luca Cavanna",\n          "content": "A few days ago I released the first beta version of the elasticshell, a shell for elasticsearch."\n        }\n      }\n    ]\n  }\n}\n<\/pre>\n
Let’s say we now want to search for something else, it’s really easy to modify again our existing query object and execute a new search.<\/p>\n
The following is another example, using this time the QueryBuilders<\/code><\/a> provided with the Java API. The QueryBuilders<\/code><\/a> class exposes some static methods that allow to create the different queries supported by the query DSL. All the queries are created through builder objects, which all implement the QueryBuilder<\/code><\/a> interface. You can use auto-suggestions here too to know what methods you can use. When you’re done you just have to provide your own QueryBuilder<\/code> as argument to the queryBuilder<\/code> method and execute your search like this:<\/p>\n
\n> var queryBuilder = QueryBuilders.multiMatchQuery("elasticshell", "title^2", "content");\n> es.searchBuilder().queryBuilder(queryBuilder).execute();\n{\n  "took": 8,\n  "timed_out": false,\n  "_shards": {\n    "total": 5,\n    "successful": 5,\n    "failed": 0\n  },\n  "hits": {\n    "total": 1,\n    "max_score": 0.19178301,\n    "hits": [\n      {\n        "_index": "blog",\n        "_type": "trifork",\n        "_id": "1",\n        "_score": 0.19178301,\n        "_source": {\n          "title": "Introducing the elasticshell",\n          "author": "Luca Cavanna",\n          "content": "A few days ago I released the first beta version of the elasticshell, a shell for elasticsearch."\n        }\n      }\n    ]\n  }\n}\n<\/pre>\n
The limitation of this last approach is that it’s not trivial to combine it with native json within the shell. The QueryBuilder is the elasticsearch (Java) internal representation of the queries, thus we would need to convert it back to the string format and parse it as json in order to play around with the related json objects. I’ll explain this better in the next post, together with another solution I’ve been working on, which would allow you to use the nice elastic.js<\/a> api within the shell.<\/p>\n
Stay tuned!<\/strong>
\nNow that you know how you can execute a search using the elasticshell you have one more good reason to download it and give it a try! More articles and examples will follow too.
\nFeedback is more than welcome, and again, the released version is still a BETA; should you find any problem, I’d kindly ask you to open an issue here on github<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
So as promised here is a sequel to my previous post Introducing the elasticshell. Let’s start exactly where we left off… What about search? We of course need to search against the created index. We can provide queries as either json documents or Java QueryBuilders provided with the elasticsearch Java API, which are exposed to […]<\/p>\n","protected":false},"author":71,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[15,31,65],"tags":[61,101,50],"class_list":["post-7262","post","type-post","status-publish","format-standard","hentry","category-enterprise-search","category-java","category-big_data_search","tag-elasticsearch","tag-javascript","tag-shell"],"acf":[],"yoast_head":"\nSearching with the elasticshell - Trifork Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Searching with the elasticshell - Trifork Blog\" \/>\n<meta property=\"og:description\" content=\"So as promised here is a sequel to my previous post Introducing the elasticshell. Let’s start exactly where we left off… What about search? We of course need to search against the created index. We can provide queries as either json documents or Java QueryBuilders provided with the elasticsearch Java API, which are exposed to […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/\" \/>\n<meta property=\"og:site_name\" content=\"Trifork Blog\" \/>\n<meta property=\"article:published_time\" content=\"2013-03-07T10:34:54+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png\" \/>\n<meta name=\"author\" content=\"Luca Cavanna\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Luca Cavanna\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/\",\"url\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/\",\"name\":\"Searching with the elasticshell - Trifork Blog\",\"isPartOf\":{\"@id\":\"https:\/\/trifork.nl\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png\",\"datePublished\":\"2013-03-07T10:34:54+00:00\",\"author\":{\"@id\":\"https:\/\/trifork.nl\/blog\/#\/schema\/person\/d9aa0a29580038af46b7a223de3e4fd8\"},\"breadcrumb\":{\"@id\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#primaryimage\",\"url\":\"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png\",\"contentUrl\":\"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/trifork.nl\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Searching with the elasticshell\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/trifork.nl\/blog\/#website\",\"url\":\"https:\/\/trifork.nl\/blog\/\",\"name\":\"Trifork Blog\",\"description\":\"Keep updated on the technical solutions Trifork is working on!\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/trifork.nl\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/trifork.nl\/blog\/#\/schema\/person\/d9aa0a29580038af46b7a223de3e4fd8\",\"name\":\"Luca Cavanna\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/trifork.nl\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/56beb100625f636499231471d8c27425?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/56beb100625f636499231471d8c27425?s=96&d=mm&r=g\",\"caption\":\"Luca Cavanna\"},\"url\":\"https:\/\/trifork.nl\/blog\/author\/luca\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Searching with the elasticshell - Trifork Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/","og_locale":"en_US","og_type":"article","og_title":"Searching with the elasticshell - Trifork Blog","og_description":"So as promised here is a sequel to my previous post Introducing the elasticshell. Let’s start exactly where we left off… What about search? We of course need to search against the created index. We can provide queries as either json documents or Java QueryBuilders provided with the elasticsearch Java API, which are exposed to […]","og_url":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/","og_site_name":"Trifork Blog","article_published_time":"2013-03-07T10:34:54+00:00","og_image":[{"url":"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png","type":"","width":"","height":""}],"author":"Luca Cavanna","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Luca Cavanna","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/","url":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/","name":"Searching with the elasticshell - Trifork Blog","isPartOf":{"@id":"https:\/\/trifork.nl\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#primaryimage"},"image":{"@id":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#primaryimage"},"thumbnailUrl":"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png","datePublished":"2013-03-07T10:34:54+00:00","author":{"@id":"https:\/\/trifork.nl\/blog\/#\/schema\/person\/d9aa0a29580038af46b7a223de3e4fd8"},"breadcrumb":{"@id":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#primaryimage","url":"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png","contentUrl":"https:\/\/trifork.nl\/articles\/wp-content\/uploads\/sites\/3\/2013\/03\/logo-elasticshell-150x150.png"},{"@type":"BreadcrumbList","@id":"https:\/\/trifork.nl\/blog\/searching-with-the-elasticshell\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/trifork.nl\/blog\/"},{"@type":"ListItem","position":2,"name":"Searching with the elasticshell"}]},{"@type":"WebSite","@id":"https:\/\/trifork.nl\/blog\/#website","url":"https:\/\/trifork.nl\/blog\/","name":"Trifork Blog","description":"Keep updated on the technical solutions Trifork is working on!","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/trifork.nl\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/trifork.nl\/blog\/#\/schema\/person\/d9aa0a29580038af46b7a223de3e4fd8","name":"Luca Cavanna","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/trifork.nl\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/56beb100625f636499231471d8c27425?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/56beb100625f636499231471d8c27425?s=96&d=mm&r=g","caption":"Luca Cavanna"},"url":"https:\/\/trifork.nl\/blog\/author\/luca\/"}]}},"_links":{"self":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/posts\/7262","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/users\/71"}],"replies":[{"embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/comments?post=7262"}],"version-history":[{"count":0,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/posts\/7262\/revisions"}],"wp:attachment":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/media?parent=7262"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/categories?post=7262"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/tags?post=7262"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}