GENERATESERIES

Syntaxe

Paramètres

Description

Cette fonction permet de retourner une table à une colonne contenant une série arithmétique de valeurs.

Remarques

• Concept et objectif de GENERATESERIES : La fonction GENERATESERIES est utilisée pour créer une table à une colonne contenant une série arithmétique de valeurs. Elle génère automatiquement toutes les valeurs entre startValue et endValue selon un incrément défini. Cette fonctionnalité est utile pour créer des tables de référence, des intervalles de dates ou de nombres, et sert souvent de base pour des mesures ou des calculs dynamiques dans Power BI.
• Rôle du paramètre startValue : Le paramètre startValue définit le point de départ de la série. Cette valeur peut être un nombre entier, décimal ou le résultat d'une expression DAX. Elle marque la première ligne de la table générée et sert de référence pour le calcul des valeurs suivantes selon l'incrément spécifié.
• Rôle du paramètre endValue : Le paramètre endValue définit la limite supérieure de la série. La génération de valeurs s'arrête lorsqu'on atteint ou dépasse cette valeur. Il est important de choisir ce paramètre avec soin pour éviter de générer des séries trop longues, ce qui pourrait nuire aux performances dans des modèles volumineux.
• Utilité du paramètre incrementValue : Le paramètre incrementValue permet de définir l'écart entre chaque valeur de la série. S'il n'est pas spécifié, DAX utilise la valeur par défaut de 1. En modifiant cet incrément, il est possible de générer des séries personnalisées, par exemple pour créer des intervalles de 0,5, 10 ou toute autre unité pertinente à l'analyse souhaitée.
• Application pratique dans les modèles : GENERATESERIES est particulièrement utile pour créer des tables de référence pour des axes de graphique, des intervalles de temps ou des plages de valeurs. Par exemple, elle peut générer une série de numéros de mois, de tranches de valeurs pour des histogrammes ou de séquences d'identifiants pour des tests et simulations.
• Comportement avec des nombres négatifs ou décimaux : La fonction accepte des valeurs négatives et des nombres décimaux, ce qui permet de générer des séries non seulement ascendantes mais aussi descendantes ou fractionnaires. Il est essentiel de vérifier la cohérence des paramètres pour s'assurer que la série produite correspond aux besoins analytiques et ne dépasse pas la limite définie par endValue.
• Utilisation dans les mesures et colonnes calculées : GENERATESERIES est généralement utilisée pour créer des tables calculées plutôt que des colonnes individuelles. Ces tables peuvent ensuite être utilisées dans des relations, des axes de graphique ou des mesures dynamiques. L'utilisation dans une mesure est moins fréquente, mais peut être combinée avec d'autres fonctions DAX comme ADDCOLUMNS pour générer des séries enrichies avec des calculs.
• Bonnes pratiques et performances : Il est recommandé de limiter la taille de la série pour éviter une explosion de lignes dans le modèle. L'usage de variables (VAR) pour stocker le résultat de GENERATESERIES permet d'optimiser les performances et d'améliorer la lisibilité du code. Documenter clairement l'objectif de la série générée facilite la maintenance et la compréhension du modèle par d'autres utilisateurs.