正在加载

分组函数

Elastic Stack Serverless

用于创建特殊分组的函数（也称为分桶）；因此，这些函数需要用作分组的一部分。

HISTOGRAM(
    numeric_exp,
    numeric_interval)

HISTOGRAM(
    date_exp,
    date_time_interval)

输入:

  1. 数值表达式（通常是一个字段）。如果此字段仅包含null值，则该函数返回null。否则，该函数会忽略此字段中的null值。
  2. 数值间隔。如果为null，则该函数返回null。
  3. 日期/时间表达式（通常是一个字段）。如果此字段仅包含null值，则该函数返回null。否则，该函数会忽略此字段中的null值。
  4. 日期/时间间隔。如果为null，则该函数返回null。

输出：根据给定的间隔划分的给定表达式的非空桶或组

描述：histogram 函数获取所有匹配的值，并使用（大致）以下公式将它们划分为固定大小的桶，大小与给定的间隔相匹配

bucket_key = Math.floor(value / interval) * interval
注意

SQL 中的 histogram 不会像传统的直方图和日期直方图那样为缺失的间隔返回空桶。这种行为在 SQL 中在概念上不适用，因为 SQL 将所有缺失的值视为null；因此，histogram 将所有缺失的值都放在null组中。

Histogram可以应用于数值字段

SELECT HISTOGRAM(salary, 5000) AS h FROM emp GROUP BY h;

       h
---------------
25000
30000
35000
40000
45000
50000
55000
60000
65000
70000

或日期/时间字段

SELECT HISTOGRAM(birth_date, INTERVAL 1 YEAR) AS h, COUNT(*) AS c FROM emp GROUP BY h;


           h            |       c
------------------------+---------------
null                    |10
1952-01-01T00:00:00.000Z|8
1953-01-01T00:00:00.000Z|11
1954-01-01T00:00:00.000Z|8
1955-01-01T00:00:00.000Z|4
1956-01-01T00:00:00.000Z|5
1957-01-01T00:00:00.000Z|4
1958-01-01T00:00:00.000Z|7
1959-01-01T00:00:00.000Z|9
1960-01-01T00:00:00.000Z|8
1961-01-01T00:00:00.000Z|8
1962-01-01T00:00:00.000Z|6
1963-01-01T00:00:00.000Z|7
1964-01-01T00:00:00.000Z|4
1965-01-01T00:00:00.000Z|1

只要返回类型是数值，histogram 中的表达式也受支持

SELECT HISTOGRAM(salary % 100, 10) AS h, COUNT(*) AS c FROM emp GROUP BY h;

       h       |       c
---------------+---------------
0              |10
10             |15
20             |10
30             |14
40             |9
50             |9
60             |8
70             |13
80             |3
90             |9

请注意，直方图（以及通常的分组函数）允许自定义表达式，但不能在GROUP BY中对它们应用任何函数。换句话说，以下语句不允许

SELECT MONTH(HISTOGRAM(birth_date), 2)) AS h, COUNT(*) as c FROM emp GROUP BY h ORDER BY h DESC;

因为它需要两个分组（一个用于直方图，然后第二个用于在直方图组之上应用函数）。

相反，可以重写查询以将表达式移动到 histogram 内部

SELECT HISTOGRAM(MONTH(birth_date), 2) AS h, COUNT(*) as c FROM emp GROUP BY h ORDER BY h DESC;

       h       |       c
---------------+---------------
12             |7
10             |17
8              |16
6              |16
4              |18
2              |10
0              |6
null           |10
重要提示

当 SQL 中的 histogram 应用于 DATE 类型而不是 DATETIME 时，指定的间隔将被截断为一天的倍数。 例如：对于HISTOGRAM(CAST(birth_date AS DATE), INTERVAL '2 3:04' DAY TO MINUTE)，实际使用的间隔将是INTERVAL '2' DAY。 如果指定的间隔小于 1 天，例如：HISTOGRAM(CAST(birth_date AS DATE), INTERVAL '20' HOUR)，则使用的间隔将是INTERVAL '1' DAY。

重要提示

为日期/时间 HISTOGRAM 指定的所有间隔将在其date_histogram聚合定义中使用固定间隔，但INTERVAL '1' YEAR、INTERVAL '1' MONTH 和 INTERVAL '1' DAY 这几个明显的例外，它们使用日历间隔。 选择日历间隔是为了 YEAR、MONTH 和 DAY 分组获得更直观的结果。 例如，对于 YEAR，日历间隔将一年桶视为从该特定年份的 1 月 1 日开始，而固定间隔一年桶将一年视为毫秒数（例如，31536000000ms 对应于 365 天，每天 24 小时，每小时 60 分钟等）。 对于固定间隔，例如，2019 年 2 月 5 日属于从 2018 年 12 月 20 日开始的桶，并且 Elasticsearch（以及隐式的 Elasticsearch SQL）将为实际在 2019 年的日期返回 2018 年。 使用日历间隔，这种行为更加直观，2019 年 2 月 5 日实际上属于 2019 年的年份桶。

重要提示

SQL 中的 Histogram 不能应用于 TIME 类型。 例如：目前不支持HISTOGRAM(CAST(birth_date AS TIME), INTERVAL '10' MINUTES)。

© . All rights reserved.