ES系列14:你知道25种(桶聚合)Bucket Aggs 类型各自的使用场景么?【聚合分析】

2020-11-13 10:37:52 浏览数 (1)

看了本文,你将掌握

1、ES有哪些聚合类型?Bucket、Metric、Pipeline Aggregations 各自的特点是什么??

2、Bucket Aggs 有哪些种类?各自的使用场景是什么?

3、Bucket Aggs 各种类型的重要参数有哪些?注意事项是什么?

ps:本文基于ES 7.7.1【文末附《Bucket aggs 25种类型详解》xmind 获取方式】

01 ES聚合类型简介

一图胜千言

如上图,ES的聚合一共有4种类型,Bucket 、Metric、Pipeline 是经常使用的,掌握了这3种聚合,就已经可以满足日常大部分的聚合分析场景了。

在学习之前,先掌握aggregations的语法结构:【注意aggregations关键字可使用aggs代替】

简单示例,学会agg语法:

代码语言:javascript复制
GET /cars/_search
{
  "size": 0,
  "aggs": {
    "first_agg_name": {
      "terms": {
        "field": "color"
      },
      "aggs": {
        "sub_agg_name1": {
          "avg": {
            "field": "price"
          }
        },
        "sub_agg_name2": {
          "terms": {
            "field": "make"
          }
        }
      }
    }
  }
}

02 Bucket Aggregations

Bucket 就是桶的意思,即按照一定的规则将文档分配到不同的桶中,达到分类分析的目的。

ES从 2.x 到 7.x,聚合功能已经日渐强大,到 7.7 版本, Bucket 聚合已经有25种类型了,今天我们就一起系统学习 Bucket Aggregations,全面掌握 Bucket 聚合

Bucket Aggs 概览

ps:因为篇幅问题,TeHero在文章中就只通过示例进行简单讲解,涉及其他的注意事项,重要参数等,见xmind截图,毕竟一图胜千言,哈哈,好吧,我承认,就是懒得写重复的内容【文末有xmind源文件获取方式】。

2.0 写在前面

通过上图《Bucket Aggs 概览》我们可以看到,一共有25种类型的 Bucket Aggs,对于每一种聚合类型,我们都去详细学习并掌握是比较费时间的,个人建议可以按如下方式学习:

  • 1)了解每种聚合类型的使用场景,简单而言,就是知道每种聚合是干嘛的,能对数据做怎样的分析;
  • 2)了解其注意事项和重要参数;
  • 3)完成以上2点,我觉得就差不多了,在实际工作中,面对需求,我们知道可以用哪些聚合操作解决需求即可,需要用到的时候再去详细学习具体的语法。

2.1 Terms 术语聚合

场景示例:对于博客系统,按不同的作者分类聚合,得到每位作者的博文总数

代码语言:javascript复制
GET /blogs_index/_search
{
  "size": 0,
  "aggs": {
    "author": {
      "terms": {
        "field": "author"
      }
    }
  }
}

结果:

代码语言:javascript复制
  "aggregations" : {
    "author" : {
      "doc_count_error_upper_bound" : 0,
      "sum_other_doc_count" : 0,
      "buckets" : [
        {
          "key" : "方才兄",
          "doc_count" : 3
        },
        {
          "key" : "方才",
          "doc_count" : 1
        }
      ]
    }
  }

2.2 Rare Terms 稀有术语聚合

在 Terms Aggs 中,聚合结果的排序是默认根据 doc_count 的值降序排列,但在实际使用过程中,我们有时候希望根据 doc_count 的值升序排列,这个时候就应该使用 Rare Terms【之所以不使用 Terms aggs再去改变排序规则,是因为聚合精度问题,后续专门讨论】

场景示例:按不同的作者分类聚合,同时根据每位作者的文章总数进行升序排列

代码语言:javascript复制
GET /blogs_index/_search
{
  "size": 0,
  "aggs": {
    "author": {
      "rare_terms": {
        "field": "author",
        "max_doc_count": 10
      }
    }
  }
}

注意max_doc_count参数:术语出现的最大文档数【返回的bucket 的 doc_count <= 该值】,默认值为1,最大值为100。

结果:

代码语言:javascript复制
   "aggregations" : {
    "author" : {
      "buckets" : [
        {
          "key" : "方才",
          "doc_count" : 1
        },
        {
          "key" : "方才兄",
          "doc_count" : 3
        }
      ]
    }
  }

2.3 Histogram 直方图聚合

场景示例:按商品价格区间聚合,得到不同价格区间的商品总数

代码语言:javascript复制
GET /product/_search
{
  "size": 0,
  "aggs": {
    "price": {
      "histogram": {
        "field": "price",
        "interval": 2000
      }
    }
  }
}

结果:

代码语言:javascript复制
{
  "aggregations": {
    "price": {
      "buckets": [
        {
          "key": 0,
          "doc_count": 3
        },
        {
          "key": 20000,
          "doc_count": 4
        },
        {
          "key": 80000,
          "doc_count": 1
        }
      ]
    }
  }
}

简单解释下,返回的 “key” 值:0代表区间【0,2000),2000代表区间【2000,4000)。

2.4 Date histogram 日期直方图聚合

场景示例:查看每天博客系统的发文总数

代码语言:javascript复制
GET /blogs_index/_search
{
  "size": 0,
  "aggs": {
    "price": {
      "date_histogram": {
        "field": "createAt",
        "calendar_interval": "day",
        "format": "yyyy-MM-dd"
      }
    }
  }
}

结果:

代码语言:javascript复制
  "aggregations": {
    "price": {
      "buckets": [
        {
          "key_as_string": "2020-05-22",
          "key": 1590105600000,
          "doc_count": 1
        },
        {
          "key_as_string": "2020-05-23",
          "key": 1590192000000,
          "doc_count": 1
        },
        {
          "key_as_string": "2020-05-24",
          "key": 1590278400000,
          "doc_count": 2
        }
      ]
    }
  }

2.5 Auto-interval Date Histogram 自动间隔日期直方图聚合

该聚合的应用场景,更多的可能是,页面强制需要多个点绘制图表。

场景示例:还是通过博客的创建时间做聚合,这次我希望返回3个bucket

代码语言:javascript复制
GET /blogs_index/_search
{
  "size": 0,
  "aggs": {
    "createTime": {
      "auto_date_histogram": {
        "field": "createAt",
        "format": "yyyy-MM-dd",
        "buckets": 3
      }
    }
  }
}

结果:

代码语言:javascript复制
  "aggregations": {
    "createTime": {
      "buckets": [
        {
          "key_as_string": "2020-05-22",
          "key": 1590105600000,
          "doc_count": 1
        },
        {
          "key_as_string": "2020-05-23",
          "key": 1590192000000,
          "doc_count": 1
        },
        {
          "key_as_string": "2020-05-24",
          "key": 1590278400000,
          "doc_count": 2
        }
      ],
      "interval": "1d"
    }
  }

2.6 Range 范围聚合

场景示例:查看价格在100以内,100-200和200以上 这3个范围的商品数量

代码语言:javascript复制
GET /product/_search
{
  "aggs": {
    "price_ranges": {
      "range": {
        "field": "price",
        "ranges": [
          {
            "to": 100
          },
          {
            "from": 100,
            "to": 200
          },
          {
            "from": 200
          }
        ]
      }
    }
  }
}

结果:

代码语言:javascript复制
  "aggregations": {
    "price_ranges": {
      "buckets": [
        {
          "key": "*-100.0",
          "to": 100,
          "doc_count": 0
        },
        {
          "key": "100.0-200.0",
          "from": 100,
          "to": 200,
          "doc_count": 0
        },
        {
          "key": "200.0-*",
          "from": 200,
          "doc_count": 0
        }
      ]
    }
  }

2.7 Date Range 日期范围聚合

场景示例:获取过去到10个月之前的所有商品总数和10个月之前的商品总数:

代码语言:javascript复制
GET /product/_search
{
  "aggs": {
    "range": {
      "date_range": {
        "field": "date",
        "format": "yyyy-MM",
        "ranges": [
          {
            "to": "now-10M/M"
          },
          {
            "from": "now-10M/M"
          }
        ]
      }
    }
  }
}

注意:to:date < 现在减去10个月,向下舍入到月初;from:date > = 现在减去10个月,向下舍入到月初。

结果:现在是 2020-07

代码语言:javascript复制
  "aggregations": {
    "range": {
      "buckets": [
        {
          "key": "*-2019-09",
          "to": 1567296000000,
          "to_as_string": "2019-09",
          "doc_count": 20
        },
        {
          "key": "2019-09-*",
          "from": 1567296000000,
          "from_as_string": "2019-09",
          "doc_count": 50
        }
      ]
    }
  }

2.8 IP Range IP范围聚合

看个示例即可:

代码语言:javascript复制
GET /ip_addresses/_search
{
  "size": 10,
  "aggs": {
    "ip_ranges": {
      "ip_range": {
        "field": "ip",
        "ranges": [
          {
            "to": "10.0.0.5"
          },
          {
            "from": "10.0.0.5"
          }
        ]
      }
    }
  }
}

结果:

代码语言:javascript复制
GET /product/_search
{
  "aggregations": {
    "ip_ranges": {
      "buckets": [
        {
          "key": "*-10.0.0.5",
          "to": "10.0.0.5",
          "doc_count": 10
        },
        {
          "key": "10.0.0.5-*",
          "from": "10.0.0.5",
          "doc_count": 0
        }
      ]
    }
  }
}

2.9 Composite 复合聚合

1)对于Composite Agg 需要看两个示例,一个是翻页的示例:

代码语言:javascript复制
GET /teamwork_task/_search
{
  "size": 0,
  "aggs": {
    "my_buckets": {
      "composite": {
        "size": 2,
        "sources": [
          {
            "customName": {
              "terms": {
                "field": "team_id"
              }
            }
          }
        ]
      }
    }
  }
}

结果:

代码语言:javascript复制
  "aggregations": {
    "my_buckets": {
      "after_key": {
        "customName": 135
      },
      "buckets": [
        {
          "key": {
            "customName": 128
          },
          "doc_count": 2
        },
        {
          "key": {
            "customName": 135
          },
          "doc_count": 3
        }
      ]
    }
  }
}

翻页查询:查询 body不变,添加上次返回的 after即可

代码语言:javascript复制
GET /teamwork_task/_search
{
  "size": 0,
  "aggs": {
    "my_buckets": {
      "composite": {
        "size": 2,
        "sources": [
          {
            "customName": {
              "terms": {
                "field": "team_id"
              }
            }
          }
        ],
        "after": {
          "customName": 135
        }
      }
    }
  }
}

2)问卷结果统计示例:假设有A、B两道题,每题都有2个答案,那么 Composite聚合就可以得到所有可能组合的答案的问卷数

代码语言:javascript复制
GET /question_index/_search
{
  "size": 0,
  "aggs": {
    "my_buckets": {
      "composite": {
        "sources": [
          {
            "question_A": {
              "terms": {
                "field": "question_A"
              }
            }
          },
          {
            "question_B": {
              "terms": {
                "field": "question_B"
              }
            }
          }
        ]
      }
    }
  }
}

结果:

代码语言:javascript复制
  "aggregations": {
    "my_buckets": {
      "after_key": {
        "question_A": "B",
        "question_B": 1
      },
      "buckets": [
        {
          "key": {
            "question_A": "A",
            "question_B": 1
          },
          "doc_count": 1
        },
        {
          "key": {
            "question_A": "B",
            "question_B": 1
          },
          "doc_count": 1
        }
      ]
    }
  }

2.10 Filter 过滤器聚合

场景示例:只想查看商品类型是 t-shirt 的平均价格

代码语言:javascript复制
POST /sales/_search?size=0
{
    "aggs" : {
        "t_shirts" : {
            "filter" : { "term": { "type": "t-shirt" } },
            "aggs" : {
                "avg_price" : { "avg" : { "field" : "price" } }
            }
        }
    }
}

ps:考虑篇幅问题,后面的例子仅写DSL,省略结果。

2.11 Filters 过滤器集合聚合

场景示例:日志统计,统计 error 和 warning 各有多少条记录

代码语言:javascript复制
GET logs/_search
{
  "size": 0,
  "aggs": {
    "messages": {
      "filters": {
        "filters": {
          "errors": {
            "match": {
              "body": "error"
            }
          },
          "warnings": {
            "match": {
              "body": "warning"
            }
          }
        }
      }
    }
  }
}

2.12 Global 全局聚合

场景示例:查询商品类型为 t-shirt 的商品集合及其平均价格,同时得到所有商品的平均价格

代码语言:javascript复制
POST /sales/_search?size=0
{
  "query": {
    "match": {
      "type": "t-shirt"
    }
  },
  "aggs": {
    "all_products": {
      "global": {},
      "aggs": {
        "avg_price": {
          "avg": {
            "field": "price"
          }
        }
      }
    },
    "t_shirts": {
      "avg": {
        "field": "price"
      }
    }
  }
}

2.13 Missing 缺少聚合

场景示例:获取没有标价的商品的总数

代码语言:javascript复制
POST /sales/_search?size=0
{
  "aggs": {
    "products_without_a_price": {
      "missing": {
        "field": "price"
      }
    }
  }
}

2.14 Adjacency Matrix 邻接矩阵聚合

概念理解图示:

2.15 3种地理位置的bucket聚合

2.16 后续8种bucket聚合待深入学习

es

0 人点赞