Aggregation Functions
This page lists the aggregation functions available in the GSQL query language. These functions take a single SET/BAG
, SetAccum/BagAccum
, or ListAccum
as the parameter and return an aggregated value from all members of the set or bag.
The |
avg()
Syntax
avg( [DISTINCT] setExp )
Description
Returns the average of all elements in a set or bag. The function can only take set/bag expressions whose members are numeric types.
Return type
A numeric type. If all members of the set/bag expression are integers, the return value will also be rounded down to be an integer.
Parameters
Parameter | Description | Data type |
---|---|---|
|
An expression that evaluates to a |
|
Example
avg([5, 4, 1, 0, 0, 0]) -> 1
avg([3, 2, 1]) -> 2
count()
Syntax
count( [DISTINCT] setExp )
Description
Returns the size of the set or bag.
Return type
INT
Parameters
Parameter | Description | Data type |
---|---|---|
|
An expression that evaluates to a |
|
Example
count([1, 2, 3]) => 3
count([1, 1, 2, 2) => 4
percentileCont()
Syntax
percentileCont(expression, percent)
Description
Aggregating Returns the percentile of the given value over a group using linear interpolation.
Return type
INT
Parameters
Parameter | Description | Data type |
---|---|---|
percentileCont(expression, percent) |
An expression that evaluates to a In GSQL, the second parameter should be percent or percentage. While, in an openCypher reference its percentile. In statistics percentile refers to a type of quantiles, obtained by adopting a subdivision into 100 groups. |
|
Example
CREATE OR REPLACE OPENCYPHER QUERY test1(){
MATCH (n:Person)
RETURN percentileCont(n.age, 0.4)
}
CREATE OR REPLACE QUERY test2() SYNTAX V2 {
SELECT percentileCont(p.id, 0.4) INTO T
FROM Person:p
WHERE p.firstName=="John";
PRINT T;
}
CREATE OR REPLACE QUERY test3() SYNTAX V2 {
PRINT percentileCont(DISTINCT [5, 4, 1, 0, 0, 0], 0.5);
PRINT percentileCont([5, 4, 1, 0, 0, 0], 0.5);
}
max()
Syntax
max( [DISTINCT] setExp )
Description
Returns the member with the maximum value in a set or bag. The function can only take set/bag expressions whose members are numeric types.
Return type
A numeric type.
Parameters
Parameter | Description | Data type |
---|---|---|
|
An expression that evaluates to a |
|
Example
max([1, 2, -3, 4]) => 4
max([1, 1, 3, 3]) => 3
min()
Syntax
min( [DISTINCT] setExp )
Description
Returns the member with the minimum value in a set or bag. The function can only take set/bag expressions whose members are numeric types.
Return type
A numeric type.
Parameters
Parameter | Description | Data type |
---|---|---|
|
An expression that evaluates to a |
|
Example
min([1, 2, -3, 4]) => -3
min([1, 1, 3, 3]) => 1
sum()
Syntax
sum( [DISTINCT] setExp )
Description
Returns the sum of all members in a set or bag. The function can only take set/bag expressions whose members are numeric types.
Return type
A numeric type.
Parameters
Parameter | Description | Data type |
---|---|---|
|
An expression that evaluates to a |
|
Example
sum([1, 2, -3, 4]) => 4
sum([1, 1, 3, 3]) => 8