[experimental] Window Functions

Warning

This is an experimental feature that is currently in development and is not ready
for general use. It will change in unpredictable backwards-incompatible ways in
the future releases. Set allow_experimental_window_functions = 1 to enable it.

ClickHouse supports the standard grammar for defining windows and window functions. The following features are currently supported:

FeatureSupport or workaround
ad hoc window specification (count() over (partition by id order by time desc))supported
expressions involving window functions, e.g. (count() over ()) / 2)not supported, wrap in a subquery (feature request)
WINDOW clause (select … from table window w as (partiton by id))supported
ROWS framesupported
RANGE framesupported, the default
INTERVAL syntax for DateTime RANGE OFFSET framenot supported, specify the number of seconds instead
GROUPS framenot supported
Calculating aggregate functions over a frame (sum(value) over (order by time))all aggregate functions are supported
rank(), dense_rank(), row_number()supported
lag/lead(value, offset)not supported, replace with any(value) over (…. rows between <offset> preceding and <offset> preceding), or following for lead

References

GitHub Issues

The roadmap for the initial support of window functions is in this issue.

All GitHub issues related to window funtions have the comp-window-functions tag.

Tests

These tests contain the examples of the currently supported grammar:

https://github.com/ClickHouse/ClickHouse/blob/master/tests/performance/window_functions.xml

https://github.com/ClickHouse/ClickHouse/blob/master/tests/queries/0_stateless/01591_window_functions.sql

Postgres Docs

https://www.postgresql.org/docs/current/sql-select.html#SQL-WINDOW

https://www.postgresql.org/docs/devel/sql-expressions.html#SYNTAX-WINDOW-FUNCTIONS

https://www.postgresql.org/docs/devel/functions-window.html

https://www.postgresql.org/docs/devel/tutorial-window.html

MySQL Docs

https://dev.mysql.com/doc/refman/8.0/en/window-function-descriptions.html

https://dev.mysql.com/doc/refman/8.0/en/window-functions-usage.html

https://dev.mysql.com/doc/refman/8.0/en/window-functions-frames.html