Fonctions d’Agrégation

Vue d’ensemble

Une fonction d'agrégation effectue un calcul sur un ensemble de valeurs et renvoie une seule valeur scalaire.

L'agrégation verticale est supportée qui prend un ensemble de valeurs de différentes lignes et agrège en une seule valeur. L'agrégation horizontale qui prend un ensemble de valeurs d'une liste de groupe de valeurs et agrège en une seule valeur n'est pas encore supportée.

DISTINCT

Les fonctions avg(), count(), max(), min(), sum(), collect_list(), stddev_samp(), et stddev_pop() supportent l'utilisation du quantificateur d'ensemble DISTINCT pour dédupliquer les valeurs avant l'agrégation.

Valeurs Nulles

Les lignes contenant des valeurs null sont ignorées par toutes les fonctions d'agrégation, sauf count(*).

Exemple de Graph

Les exemples suivants s'exécutent contre ce graph :

avg()

Calcule la moyenne d'un ensemble de valeurs.

MATCH (n)
RETURN avg(n.score)

Résultat:

FOR item IN [2, "a", 3, "1.2", null]
RETURN avg(item)

Résultat:

collect_list()

Collecte un ensemble de valeurs dans une liste.

MATCH (n)
RETURN collect_list(n.title)

Résultat:

count()

Retourne le nombre de lignes dans l'entrée.

MATCH (n)
RETURN count(n)

Résultat:

count(*)

count(*) retourne le nombre de lignes dans la table de travail actuelle.

En comparant les deux requêtes suivantes, les valeurs null ne sont prises en compte que lors de l'utilisation de count(*) :

FOR item IN [1, "a", "2", "b3", null]
RETURN count(item)

Résultat:

FOR item IN [1, "a", "2", "b3", null]
RETURN count(*)

Résultat:

count(DISTINCT)

Vous pouvez inclure le quantificateur d'ensemble DISTINCT dans count() pour retourner le nombre de lignes distinctes dans l'entrée.

FOR item IN [1, 1, "a", "2", "b3"]
RETURN count(DISTINCT item)

Résultat:

max()

Retourne la valeur maximale dans un ensemble de valeurs.

MATCH (n)
RETURN max(n.score)

Résultat:

FOR item IN [1, "a", "2.1", "b3"]
RETURN max(item)

Résultat:

min()

Retourne la valeur minimale dans un ensemble de valeurs.

MATCH (n)
RETURN min(n.score)

Résultat:

FOR item IN [3, "a", "0.2", "b2"]
RETURN min(item)

Résultat:

percentile_cont()

Calcule la valeur percentile continue sur un ensemble de valeurs.

percentile_cont() est calculé en utilisant les étapes suivantes :

• Trier les valeurs dans l'ordre croissant.
• Calculer la position percentile comme p = percentile × (n − 1) + 1, où n est le nombre de valeurs non nulles.
• Déterminer la valeur percentile en utilisant l'interpolation linéaire :
  • Si p est un entier, la valeur correspondante à cette position est la valeur percentile.
  • Si p est un décimal entre deux entiers p1 et p2 (p1 < p < p2), interpoler entre la valeur v1 à la position p1 et la valeur v2 à la position p2 pour calculer la valeur percentile comme v1 + (p - p1) × (v2 - v1).

FOR item IN [3, 9, 4, 7, 6]
RETURN percentile_cont(item, 0.4)

Résultat:

FOR item IN [3, 9, 4, 7, 6]
RETURN percentile_cont(item, 0.5)

Résultat:

percentile_disc()

Calcule la valeur percentile discrète sur un ensemble de valeurs.

percentile_disc() est calculé en utilisant les étapes suivantes :

• Trier les valeurs dans l'ordre croissant.
• Calculer la position percentile comme p = percentile × (n − 1) + 1, où n est le nombre de valeurs non nulles.
• Déterminer la valeur percentile :
  • Si p est un entier, la valeur à cette position exacte est sélectionnée comme valeur percentile.
  • Si p n'est pas un entier, supprimer la partie décimale de p et obtenir p', la valeur à la position p' est sélectionnée comme valeur percentile.

FOR item IN [3, 9, 4, 7, 6]
RETURN percentile_disc(item, 0.4)

Résultat:

FOR item IN [3, 9, 4, 7, 6]
RETURN percentile_disc(item, 0.5)

Résultat:

stddev_pop()

Calcule l'écart-type de population d'un ensemble de valeurs.

MATCH (n)
RETURN stddev_pop(n.score)

Résultat:

stddev_samp()

Calcule l'écart-type d'échantillon d'un ensemble de valeurs.

MATCH (n)
RETURN stddev_samp(n.score)

Résultat:

sum()

Calcule la somme d'un ensemble de valeurs.

MATCH (n)
RETURN sum(n.score)

Résultat:

FOR item IN [3, "a", "1.2", "b2"]
RETURN sum(item)

Résultat: