BSearch-QueryBuilder又称高级查询,是一个纯前端的工具插件。通过BSearch-QueryBuilder插件,您可以无需编写复杂的DSL语句,而是以可视化的方式完成复杂的查询请求。

前提条件

您已完成以下操作:

背景信息

Query DSL是一个Java开源框架,用于构建安全类型的SQL查询语句,能够使用API代替传统的拼接字符串来构造查询语句。目前Query DSL支持的平台包括JPA、JDO、SQL、Java Collections、RDF、Lucene以及Hibernate Search。

ES提供了一整套基于JSON的DSL查询语言来定义查询。Query DSL是由一系列抽象的查询表达式组成,特定查询能够包含其它的查询(如bool),部分查询能够包含过滤器(如constant_score),还有的可以同时包含查询和过滤器(如 filtered)。您可以从ES支持的查询集合里面选择任意一个查询表达式,或者从过滤器集合里面选择任意一个过滤器进行组合,构造出复杂的查询。但编写DSL容易出错,仅有少数专业程序人员精通,QueryBuilder能够帮助对ES DSL不甚了解或者想提升编写效率的用户快速生成DSL。BSearch-QueryBuilder插件背景信息
BSearch-QueryBuilder插件具有如下特性:
  • 简单易用:BSearch-QueryBuilder插件提供了可视化的界面点选操作来构造ES的DSL查询请求,无编码即可完成自定义条件的数据查询,减少了复杂的DSL的学习成本。也可辅助开发人员编写或验证DSL语句的正确性。
  • 方便快捷:已经定义的复杂查询条件会保存在Kibana中,避免重复构造查询条件。
  • 小巧轻盈:约占用14MB的磁盘空间,不会常驻内存运行,不影响Kibana和ES的正常运行。
  • 安全可靠:BSearch-QueryBuilder插件不会对用户的数据进行改写、存储和转发,源代码已经通过了阿里云安全审计。
说明 BSearch-QueryBuilder插件仅支持6.3和6.7版本的阿里云ES实例。

操作步骤

  1. 登录对应阿里云ES实例的Kibana控制台。
    登录控制台的具体步骤请参见登录Kibana控制台
  2. 单击左侧导航栏的Management,按照以下步骤创建一个索引模式。
    注意 如果已经创建了索引模式,可忽略此步骤。
    1. Management页面,单击Kibana区域中的Index Patterns
    2. Create index pattern页面,输入索引模式名称(待查询的索引名称)。
    3. 单击Next step
      创建索引模式
    4. 单击Create index pattern
  3. 单击左侧导航栏的Discover
  4. Discover页面,单击右上角菜单栏的Query
  5. 在查询区域添加查询和过滤条件,单击Submit(提交)。
    查询结果
    • 单击查询条件图标,添加一个查询条件。
    • 单击添加一个子过滤条件图标,为查询添加一个子过滤条件。
    • 单击删除一个查询或过滤条件图标,删除一个查询或过滤条件。
    BSearch-QueryBuilder支持模糊查询、多条件组合查询和自定义时间范围查询等多种查询方式,查询示例如下:
    • 模糊查询
      下图中表示对email这个条件进行模糊查询,并要求email中模糊匹配iga模糊查询
      最终得到的匹配结果如下。查询结果
    • 多条件组合查询
      下图的查询条件表示index必须为tryme_book,同时要对type 进行过滤。要求type等于大学教辅数学对外汉语教学大学教材多条件组合查询
      最终得到的匹配结果如下。匹配结果
    • 自定义时间范围查询
      当您需要对时间字段进行筛选时,可使用时间类型的筛选功能。下图中对utc_time进行时间范围筛选,查询[当前时间-240天,当前时间]范围内的数据。自定义时间范围查询
      最终得到的匹配结果如下。匹配结果