3.4 KiB

Raw Blame History

layout
doc_page

Filter groupBy Query Results

A having clause is a JSON object identifying which rows from a groupBy query should be returned, by specifying conditions on aggregated values.

It is essentially the equivalent of the HAVING clause in SQL.

Druid supports the following types of having clauses.

Query filters

Query filter HavingSpecs allow all Druid query filters to be used in the Having part of the query.

The grammar for a query filter HavingSpec is:

{
    "type" : "filter",
    "filter" : <any Druid query filter>
}

For example, to use a selector filter:

{
    "type" : "filter",
    "filter" : {
      "type": "selector",
      "dimension" : "<dimension>",
      "value" : "<dimension_value>"
    }
}

Note that behavior of the "filter" HavingSpec on an output field named "__time" differs from most other HavingSpecs. Unlike most other HavingSpecs, it will act on each row's timestamp rather than an output field named "__time". We recommend avoiding naming output fields "__time". Future versions of Druid may enforce this.

Numeric filters

The simplest having clause is a numeric filter. Numeric filters can be used as the base filters for more complex boolean expressions of filters.

Here's an example of a having-clause numeric filter:

{
    "type": "greaterThan",
    "aggregation": "myAggMetric",
    "value": 100
}

Equal To

The equalTo filter will match rows with a specific aggregate value. The grammar for an equalTo filter is as follows:

{
    "type": "equalTo",
    "aggregation": "<aggregate_metric>",
    "value": <numeric_value>
}

This is the equivalent of HAVING <aggregate> = <value>.

Greater Than

The greaterThan filter will match rows with aggregate values greater than the given value. The grammar for a greaterThan filter is as follows:

{
    "type": "greaterThan",
    "aggregation": "<aggregate_metric>",
    "value": <numeric_value>
}

This is the equivalent of HAVING <aggregate> > <value>.

Less Than

The lessThan filter will match rows with aggregate values less than the specified value. The grammar for a greaterThan filter is as follows:

{
    "type": "lessThan",
    "aggregation": "<aggregate_metric>",
    "value": <numeric_value>
}

This is the equivalent of HAVING <aggregate> < <value>.

Dimension Selector Filter

dimSelector

The dimSelector filter will match rows with dimension values equal to the specified value. The grammar for a dimSelector filter is as follows:

{
    "type": "dimSelector",
    "dimension": "<dimension>",
    "value": <dimension_value>
}

Logical expression filters

AND

The grammar for an AND filter is as follows:

{
    "type": "and",
    "havingSpecs": [<having clause>, <having clause>, ...]
}

The having clauses in havingSpecs can be any other having clause defined on this page.

OR

The grammar for an OR filter is as follows:

{
    "type": "or",
    "havingSpecs": [<having clause>, <having clause>, ...]
}