RANK (window)
Syntax
RANK( value [ , direction ] )
RANK( value [ , direction ]
[ TOTAL | WITHIN ... | AMONG ... ]
[ BEFORE FILTER BY ... ]
)
More info:
Description
Returns the rank of the current row if ordered by the given argument. Rows corresponding to the same value used for sorting have the same rank. If the first two rows both have rank of 1, then the next row (if it features a different value) will have rank 3, so, in effect, it is rank with gaps.
If direction is "desc" or omitted, then ranking is done from greatest to least, if "asc", then from least to greatest.
See also RANK_DENSE, RANK_UNIQUE, RANK_PERCENTILE.
Argument types:
value—Boolean | Date | Datetime | Fractional number | Integer | String | UUIDdirection—String
Return type: Integer
Note
Only constant values are accepted for the arguments (direction).
Examples
Example with two arguments
Source data
| Date | City | Category | Orders | Profit |
|---|---|---|---|---|
'2019-03-01' |
'London' |
'Office Supplies' |
8 |
120.80 |
'2019-03-04' |
'London' |
'Office Supplies' |
2 |
100.00 |
'2019-03-05' |
'London' |
'Furniture' |
1 |
750.00 |
'2019-03-02' |
'Moscow' |
'Furniture' |
2 |
1250.50 |
'2019-03-03' |
'Moscow' |
'Office Supplies' |
4 |
85.00 |
'2019-03-01' |
'San Francisco' |
'Office Supplies' |
23 |
723.00 |
'2019-03-01' |
'San Francisco' |
'Furniture' |
1 |
1000.00 |
'2019-03-03' |
'San Francisco' |
'Furniture' |
4 |
4000.00 |
'2019-03-02' |
'Detroit' |
'Furniture' |
5 |
3700.00 |
'2019-03-04' |
'Detroit' |
'Office Supplies' |
25 |
1200.00 |
'2019-03-04' |
'Detroit' |
'Furniture' |
2 |
3500.00 |
Grouped by [City].
Sorted by [City].
Formulas:
- City:
[City]; - Order Sum:
SUM([Orders]); - RANK desc:
RANK(SUM([Orders]), "desc"); - RANK asc:
RANK(SUM([Orders]), "asc").
Result
| City | Order Sum | RANK desc | RANK asc |
|---|---|---|---|
'Detroit' |
32 |
1 |
4 |
'London' |
11 |
3 |
2 |
'Moscow' |
6 |
4 |
1 |
'San Francisco' |
28 |
2 |
3 |
Example with grouping
Source data
| Date | City | Category | Orders | Profit |
|---|---|---|---|---|
'2019-03-01' |
'London' |
'Office Supplies' |
8 |
120.80 |
'2019-03-04' |
'London' |
'Office Supplies' |
2 |
100.00 |
'2019-03-05' |
'London' |
'Furniture' |
1 |
750.00 |
'2019-03-02' |
'Moscow' |
'Furniture' |
2 |
1250.50 |
'2019-03-03' |
'Moscow' |
'Office Supplies' |
4 |
85.00 |
'2019-03-01' |
'San Francisco' |
'Office Supplies' |
23 |
723.00 |
'2019-03-01' |
'San Francisco' |
'Furniture' |
1 |
1000.00 |
'2019-03-03' |
'San Francisco' |
'Furniture' |
4 |
4000.00 |
'2019-03-02' |
'Detroit' |
'Furniture' |
5 |
3700.00 |
'2019-03-04' |
'Detroit' |
'Office Supplies' |
25 |
1200.00 |
'2019-03-04' |
'Detroit' |
'Furniture' |
2 |
3500.00 |
Grouped by [City], [Category].
Sorted by [City], [Category].
Formulas:
- City:
[City]; - Category:
[Category]; - Order Sum:
SUM([Orders]); - RANK TOTAL:
RANK(SUM([Orders]) TOTAL); - RANK WITHIN:
RANK(SUM([Orders]) WITHIN [City]); - RANK AMONG:
RANK(SUM([Orders]) AMONG [City]).
Result
| City | Category | Order Sum | RANK TOTAL | RANK WITHIN | RANK AMONG |
|---|---|---|---|---|---|
'Detroit' |
'Furniture' |
7 |
4 |
2 |
1 |
'Detroit' |
'Office Supplies' |
25 |
1 |
1 |
1 |
'London' |
'Furniture' |
1 |
8 |
2 |
4 |
'London' |
'Office Supplies' |
10 |
3 |
1 |
3 |
'Moscow' |
'Furniture' |
2 |
7 |
2 |
3 |
'Moscow' |
'Office Supplies' |
4 |
6 |
1 |
4 |
'San Francisco' |
'Furniture' |
5 |
5 |
2 |
2 |
'San Francisco' |
'Office Supplies' |
23 |
2 |
1 |
2 |
Data source support
ClickHouse 21.8, Files, Google Sheets, Microsoft SQL Server 2017 (14.0), MySQL 5.7, Oracle Database 12c (12.1), PostgreSQL 9.3, Yandex Documents.