Fonctions d’agrégation - maximalesAggregate Functions - max

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

Renvoie, à partir d’une séquence de valeurs atomiques, $arg, le seul élément dont la valeur est supérieure à celle de toutes les autres.Returns from a sequence of atomic values, $arg, the one item whose value is greater than that of all the others.

SyntaxeSyntax


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

ArgumentsArguments

$arg$arg
Séquence de valeurs atomiques à partir de laquelle la valeur maximale est renvoyée.Sequence of atomic values from which to return the maximum value.

NotesRemarks

Tous les types de valeurs atomisées transmises à max() doivent être des sous-types du même type de base.All types of the atomized values that are passed to max() have to be subtypes of the same base type. Types de base acceptés sont les types qui prennent en charge la gt opération.Base types that are accepted are the types that support the gt operation. Ces types incluent les trois types numériques de base intégrés, les types de base date/heure et les types xs:string (chaîne), xs:boolean (booléen) et xdt:untypedAtomic (atomique non typé).These types include the three built-in numeric base types, the date/time base types, xs:string, xs:boolean, and xdt:untypedAtomic. Les valeurs de type xdt:untypedAtomic sont converties en xs:double.Values of type xdt:untypedAtomic are cast to xs:double. S’il existe un mélange de ces types, ou si d’autres valeurs d’autres types sont passés, une erreur statique est déclenchée.If there is a mixture of these types, or if other values of other types are passed, a static error is raised.

Le résultat de max() reçoit le type de base des types transmis, tel que xs : double dans le cas de xdt : untypedAtomic.The result of max() 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 (valeur empty) de façon statique, « empty » est alors implicite et une erreur statique est émise.If the input is statically empty, empty is implied and a static error is raised.

Le max() fonction retourne la valeur de la séquence qui est supérieure à un autre dans la séquence d’entrée.The max() function returns the one value in the sequence that is greater than any other in the input sequence. Pour les valeurs xs:string, le classement par défaut des points de code Unicode est utilisé.For xs:string values, the default Unicode Codepoint Collation is being used. 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 ignored in the input sequence, $arg. Si l'entrée est une séquence vide calculée de manière dynamique, la séquence vide est renvoyée.If the input is a dynamically calculated empty sequence, the empty sequence is returned.

ExemplesExamples

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

A.A. Utilisation de la fonction XQuery max() pour localiser les postes de travail du processus de fabrication enregistrant le plus d'heures de main-d'œuvreUsing the max() XQuery function to find work center locations in the manufacturing process that have the most labor hours

La requête fournie dans fonction min (XQuery) peut être réécrit pour utiliser le max() (fonction).The query provided in min function (XQuery) can be rewritten to use the max() function.

Limites de mise en œuvreImplementation Limitations

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

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

  • Le max() fonction sur des valeurs de type xs : Duration n’est pas pris en charge.The max() 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.

  • L'option syntaxique fournissant un classement n'est pas prise en charge.The syntactic option that provides a collation is not supported.

Voir aussiSee Also

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