Section courante

A propos

Section administrative du site

Alors que U-SQL utilise C# comme langage d'expression et dispose donc d'un grand nombre de bibliothèques CLR (Common Language Runtime) et de tous les opérateurs C# à la disposition de l'utilisateur, il ajoute également quelques fonctions U-SQL intégrées communes.

Voici un tableau de référence des différents fonctions du U-SQL (bulti-in functions) :

Nom Description
ANY_VALUE Cette fonction permet de sélectionner arbitrairement une valeur dans le groupe, y compris potentiellement une valeur nulle.
ARRAY_AGG Cette fonction permet de créer une nouvelle valeur SQL.ARRAY par groupe contenant les valeurs du groupe comme éléments.
AVG Cette fonction permet de calculer la moyenne d'un ensemble de valeurs numériques en divisant la somme de ces valeurs par le nombre de valeurs non nulles. Si la somme dépasse la valeur maximale pour le type de données de la valeur de retour, une erreur sera renvoyée.
COUNT Cette fonction permet de renvoyer le nombre d'éléments dans un groupe. Si COUNT(*) est spécifié, le décompte inclura des valeurs nulles, si une expression ou une référence de colonne est fournie, alors les valeurs nulles ne seront pas comptées.
CUME_DIST Cette fonction permet de calculer la distribution cumulée d'une valeur dans un groupe de valeurs.
DENSE_RANK Cette fonction permet de retourner le rang des lignes dans la partition d'une fenêtre, sans aucune lacune dans le classement. Le rang d'une ligne est un plus le nombre de rangs distincts précédant la ligne en question.
FILE.CREATED Cette fonction permet de retourner l'horodatage de création du fichier à l'emplacement spécifié au moment de la compilation sous la forme d'une valeur DateTime (Kind est non spécifié).
FILE.EXISTS Cette fonction permet de vérifier si un fichier à l'emplacement spécifié existe au moment de la compilation.
FILE.LENGTH Cette fonction permet de retourner la taille logique en octets du fichier à l'emplacement spécifié au moment de la compilation.
FILE.MODIFIED Cette fonction permet de retourner le dernier horodatage modifié du fichier à l'emplacement spécifié au moment de la compilation sous la forme d'une valeur DateTime (Kind est non spécifié).
FIRST_VALUE Cette fonction permet de retourner la première valeur d'un ensemble ordonné de valeurs fournies par l'expression de fenêtrage.
LAG Cette fonction permet d'accéder à une ligne à un décalage physique donné précédant la ligne actuelle. Utilisez cette fonction analytique dans une expression SELECT pour comparer les valeurs de la ligne actuelle avec les valeurs d'une ligne précédente.
LAST_VALUE Cette fonction permet de retourner la dernière valeur d'un ensemble ordonné de valeurs fournies par l'expression de fenêtrage.
LEAD Cette fonction permet d'accéder à une ligne à un décalage physique donné suivant la ligne actuelle. Utilisez cette fonction analytique dans une expression SELECT pour comparer les valeurs de la ligne actuelle avec les valeurs d'une ligne suivante.
MAP_AGG Cette fonction permet de prendre une paire clef/valeur et crée un SQL.MAP pour toutes les paires clef/valeur du groupe.
MAX Cette fonction permet de choisir la plus grande valeur du groupe ou null si l'expression ne renvoie que des nulles dans le groupe. Les valeurs doivent être comparables. Pour les types de chaîne de caractères, il utilise un ordre d'octets UTF-8 invariant à la culture.
MIN Cette fonction permet de choisir la plus petite valeur du groupe ou null si l'expression ne renvoie que des nulles dans le groupe. Les valeurs doivent être comparables. Pour les types de chaîne de caractères, il utilise un ordre d'octets UTF-8 invariant à la culture.
NTILE Cette fonction permet de retourner le numéro du groupe auquel appartient la ligne parmi les groupes dont la fonction de fenêtrage a distribué les lignes à l'aide d'une partition ordonnée.
PARTITION Cette fonction permet de retourner true si la partition spécifiée pour la table donnée existe et que l'utilisateur a accès à ladite table. Sinon, false est renvoyé. La fonction sera évaluée au moment de la compilation (et est donc pliable en permanence).
PERCENTILE_CONT Cette fonction permet de calculer un centile en fonction d'une distribution continue des valeurs dans la fenêtre. Le résultat est interpolé et peut ne pas être égal à l'une des valeurs spécifiques de la colonne.
PERCENTILE_DISC Cette fonction permet de calculer un centile spécifique pour les valeurs triées dans la fenêtre spécifiée en fonction d'une distribution discrète des valeurs de colonne. Le résultat est égal à une valeur spécifique dans la colonne.
PERCENT_RANK Cette fonction permet de calculer le classement relatif d'une ligne dans un groupe de lignes spécifié par l'expression de fenêtrage.
RANK Cette fonction permet de retourner le rang de chaque ligne dans la fenêtre. Le rang d'une ligne est un plus le nombre de rangs précédant la ligne en question.
ROW_NUMBER Cette fonction permet de retourner le numéro séquentiel d'une ligne dans une fenêtre, en commençant à 1 pour la première ligne de chaque fenêtre.
SUM Cette fonction permet de retourner la somme de toutes les valeurs du groupe. Les valeurs d'entrée doivent être de type numérique ou une erreur est générée. Les valeurs nulles sont ignorées.
STDEV Cette fonction permet de retourner l'écart type statistique de toutes les valeurs non nulles du groupe ou renvoie nul si toutes les valeurs d'entrée sont nulles. Les valeurs doivent être numériques ou une erreur est générée.
STDEVP Cette fonction permet de retourner l'écart type statistique de la population pour toutes les valeurs non nulles du groupe ou renvoie nul si toutes les valeurs d'entrée sont nulles. Les valeurs doivent être numériques ou une erreur est générée.
VAR Cette fonction permet de retourner la variance statistique de toutes les valeurs non NULL du groupe ou renvoie NULL si toutes les valeurs d'entrée sont NULL. Les valeurs doivent être numériques ou une erreur est générée.
VARP Cette fonction permet de retourner la variance statistique de la population pour toutes les valeurs non nulles du groupe ou renvoie la valeur nulle si toutes les valeurs d'entrée sont nulles. Les valeurs doivent être numériques ou une erreur est générée.


Dernière mise à jour : Mardi, le 13 juin 2023