AVG

Description

AVG

est une fonction d'agrégation de fenêtre qui partitionne les rangées en groupes, trie les rangées en fonction d'un champ et retourne la moyenne de toutes les valeurs numériques valides du groupe. Il additionne toutes les valeurs du groupe et les divise par le nombre de rangées valides (NOT NULL). Vous pouvez utiliser

AVG

pour calculer les moyennes mobiles.

PARTITION BY

La clause détermine quels champs utiliser pour partitionner un ensemble de rangées d'entrée en groupes. La

ORDER BY

La clause détermine comment classer les rangées dans la partition.

Workday sépare les rangées d'entrée en groupes en fonction des champs de partitionnement, trie les rangées en fonction des champs de classement, puis calcule l'expression agrégée (moyenne pour cette fonction) dans chaque groupe.

Syntaxe

AVG(input_field)OVER(
 PARTITION BY
partitioning_field[,partitioning_field]
 ORDER BY
ordering_field[ASC | DESC] [,ordering_field[ASC | DESC]]
 RANGE
BETWEEN
value
PRECEDING
AND
CURRENT ROW|
 ROWS
win_boundary|BETWEEN
win_boundary
AND
win_boundary
)
               
wherewin_boundarycan be:
               
 UNBOUNDED PRECEDING
value
PRECEDING
UNBOUNDED FOLLOWING
value
FOLLOWING
CURRENT ROW

Valeur de retour

Retourne une valeur de type

NUMERIC

DOUBLE

selon le type de Input_field.

Paramètres d'entrée

input_field: Est obligatoire. Le champ sur lequel exécuter la fonction d'agrégation. Vous pouvez utiliser n’importe quel champ numérique ou un champ Devise.
OVER(): Est obligatoire.
OVER
doit être utilisé dans un
AVG
l'expression.
PARTITION BY partitioning_field: Est obligatoire. Utilisez la
PARTITION BY
clause pour indiquer un ou plusieurs champs à utiliser pour partitionner un groupe de rangées d'entrée. Vous pouvez indiquer n’importe quel type de champ sauf Devise. Exemple : vous indiquez le champ Mois comme champ de partitionnement. Par conséquent, Workday regroupe dans une seule partition tous les enregistrements qui ont la même valeur pour le mois.
ORDER BY ordering_field: Est obligatoire. Utilisez la
ORDER BY
clause pour indiquer comment classer les rangées d'entrée dans la partition en utilisant les valeurs du champ précisé dans chaque partition. Vous pouvez indiquer n’importe quel type de champ sauf Devise. Toutefois, vous devez utiliser un type de champ numérique, tel qu'entier ou numérique lorsque vous utilisez la
RANGE
clause.
Vous pouvez utiliser le
DESC
ou
ASC
des mots-clés à trier par ordre décroissant (les valeurs de haut à bas, les valeurs NULL sont les dernières) ou par ordre croissant (les valeurs de bas à hautes, les valeurs de NULL sont les premières) pour chaque champ de tri. Si vous ne précisez pas d’ordre de tri pour un champ de tri, Workday trie automatiquement les rangées par ordre croissant.
LIGNES | GRANGE: Est obligatoire. La
ROWS
et
RANGE
Les clauses définissent le nombre précis de rangées (par rapport à la rangée actuelle) dans la partition en précisant un cadre de fenêtre. Vous définissez le cadre de la fenêtre en spécifiant des points de début et de fin à l’intérieur de la partition, appelés limites de la fenêtre. La structure de la fenêtre est l'ensemble de rangées d'entrée dans chaque partition sur laquelle calculer l'expression d'agrégation (moyenne pour cette fonction). Le cadre de fenêtre peut inclure une, plusieurs rangées ou toutes les rangées de la partition.

Les deux
ROWS
et
RANGE
indiquez la plage de rangées par rapport à la rangée actuelle, mais
RANGE
fonctionne de façon logique sur les valeurs (association logique) et
ROWS
exerce son action physique sur des rangées dans le jeu de données (association physique).

RANGE
limite le cadre de la fenêtre pour qu’il contienne les rangées dont les valeurs sont comprises dans la plage précisée, par rapport à la valeur actuelle.
ROWS
limite le cadre de la fenêtre pour qu'il contienne des rangées qui sont physiques à côté de la rangée actuelle.

Utiliser
RANGE
pour définir des limites de fenêtre absolues, telles que les trois derniers mois ou le cumul de l’année. Lorsque vous utilisez
RANGE
, le
ORDER BY
La clause doit utiliser un type de champ numérique, tel que Entier ou Numérique.

Exemple : vous avez un champ Nombre entier appelé MonthNum qui représente le numéro du mois de l’année (valeurs 1 à 12). Pour préciser toutes les valeurs des trois derniers mois, vous devez les classer par MonthNum et utiliser
RANGE BETWEEN 2 PRECEDING AND CURRENT ROW
. Cette clause RANGE inclut le mois en cours et les deux mois précédents, ce qui donne un total de 3 mois.

Lorsque vous publiez un jeu de données qui contient une fonction de fenêtre à l'aide de
RANGE
, le nombre de rangées dans la fenêtre doit être inférieur ou égal à 1 000. Si une fenêtre particulière dépasse 1 000 rangées, la tâche de publication échoue.
gains_boundary: Est obligatoire. Les limites de la fenêtre définissent les points de début et de fin du cadre de la fenêtre. Les limites de la fenêtre sont définies en fonction de la ligne actuelle.

A
PRECEDING
la clause définit une limite de fenêtre inférieure à la rangée actuelle (le nombre de rangées à inclure avant la rangée actuelle). La
FOLLOWING
La clause définit une limite de fenêtre qui est supérieure à la rangée actuelle (le nombre de rangées à inclure après la rangée actuelle).

Si vous indiquez une seule limite de fenêtre, Workday utilise la rangée actuelle comme autre limite dans le cadre de la fenêtre (la limite supérieure ou inférieure, selon la syntaxe de l’expression). La
UNBOUNDED
le mot-clé inclut toutes les rangées dans la direction indiquée. Lorsque vous devez indiquer à la fois une valeur de début et de fin de cadre de fenêtre, utilisez la
BETWEEN
et
AND
mots clés.

Lorsque vous précisez un nombre précis de rangées, la valeur doit être inférieure ou égale à 100.

Exemple :
ROWS 2 PRECEDING
signifie que la fenêtre a une taille de trois rangées, en commençant par deux rangées précédant la rangée actuelle et y compris celle-ci.

Exemple :
ROWS UNBOUNDED FOLLOWING
signifie que la fenêtre commence par la rangée actuelle et inclut la rangée actuelle et toutes les rangées qui suivent la rangée actuelle.

Exemples

Vous pouvez calculer la moyenne mobile (moyenne mobile ou moyenne mobile) des ventes pour chaque employé :

AVG([Sales]) OVER(
 PARTITION BY [Employee]
 ORDER BY [SalesDate] DESC
 ROWS UNBOUNDED PRECEDING)

Vous pouvez calculer les ventes moyennes globales pour chaque rangée de la partition, quels que soient les champs de la clause ORDER BY :

AVG([Sales]) OVER(
 PARTITION BY [Employee]
 ORDER BY [SalesDate] DESC
 ROWS BETWEEN UNBOUNDED PRECEDING
 AND UNBOUNDED FOLLOWING)

Vous pouvez calculer la moyenne sur 12 mois mobiles :

AVG([fieldA]) OVER(
 PARTITION BY [fieldB]
 ORDER BY [Month]
 RANGE 11 PRECEDING)

Month

Le champ doit être un type de champ numérique, tel que Entier ou Numérique.

Vous pouvez calculer la moyenne depuis le début de l’année précédente :

AVG([fieldA]) OVER(
 PARTITION BY [fieldB]
 ORDER BY [Year]
 RANGE 1 PRECEDING)

Year

Le champ doit être un type de champ numérique, tel que Entier ou Numérique.