Fonctions d’agrégation - moyenneAggregate Functions - avg

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Retourne la moyenne d'une série de nombres.Returns the average of a sequence of numbers.

SyntaxeSyntax


fn:avg($arg as xdt:anyAtomicType*) as xdt:anyAtomicType?  

ArgumentsArguments

$arg$arg
Série de valeurs atomiques dont la moyenne est calculée.The sequence of atomic values whose average is computed.

NotesRemarks

Tous les types de valeurs atomisées transmises à avg() doivent être un sous-type d’exactement un des trois types de base numériques intégrés ou xdt : untypedAtomic.All the types of the atomized values that are passed to avg() have to be a subtype of exactly one of the three built-in numeric base types or xdt:untypedAtomic. Ils ne peuvent pas être un mélange.They cannot be a mixture. Les valeurs de type xdt:untypedAtomic sont traitées comme valeurs xs:double.Values of type xdt:untypedAtomic are treated as xs:double. Le résultat de avg() reçoit le type de base des types transmis, tel que xs : double dans le cas de xdt : untypedAtomic.The result of avg() receives the base type of the passed in types, such as xs:double in the case of xdt:untypedAtomic.

Si l'entrée est vide statiquement, le caractère vide en est déduit et une erreur statique est générée.If the input is statically empty empty is implied and a static error is raised.

Le avg() fonction retourne la moyenne des nombres calculés.The avg() function returns the average of the numbers computed. Exemple :For example:

SUM ( $arg ) div count ( $arg )sum( $arg ) div count( $arg )

Si $arg est une séquence vide, la séquence vide est retournée.If $arg is an empty sequence, the empty sequence is returned.

Si une valeur xdt : untypedAtomic ne peut pas être convertie en xs : double, la valeur est ignorée dans la séquence d’entrée, $arg.If an xdt:untypedAtomic value cannot be cast to xs:double, the value is disregarded in the input sequence, $arg.

Dans tous les autres cas, la fonction retourne une erreur statique.In all other cases, the function returns a static error.

ExemplesExamples

Cette rubrique fournit des exemples de XQuery relatifs à des instances XML stockés dans différentes xml colonnes de type dans la base de données AdventureWorks.This topic provides XQuery examples against XML instances that are stored in various xml type columns in the AdventureWorks database.

A.A. Utilisation de la fonction XQuery avg() pour rechercher les ateliers dans le processus de fabrication, dans lesquels le nombre d'heures de travail est supérieur à la moyenne de tous les ateliers.Using the avg() XQuery function to find work center locations in the manufacturing process in which labor hours are greater than the average for all work center locations.

Vous pouvez réécrire la requête fournie dans fonction min (XQuery) à utiliser le avg() (fonction).You can rewrite the query provided in min function (XQuery) to use the avg() function.

Limites de mise en œuvreImplementation Limitations

Les limitations suivantes s'appliquent :These are the limitations:

  • Le avg() fonction mappe tous les entiers à xs : decimal.The avg() function maps all integers to xs:decimal.

  • Le avg() fonction sur des valeurs de type xs : Duration n’est pas pris en charge.The avg() function on values of type xs:duration is not supported.

  • Les séquences faisant intervenir plusieurs types dérivés de différents types de base ne sont pas prises en charge.Sequences that mix types across base type boundaries are not supported.

Voir aussiSee Also

Fonctions XQuery impliquant le type de données xmlXQuery Functions against the xml Data Type