Fonctions de partition
La partition est un moyen de regrouper une série de valeurs plus ou moins continues en un petit nombre de "partitions".
| Fonction | Description |
|---|---|
| AutoBinNumeric | Tente de regrouper les valeurs d'une colonne spécifiée dans le nombre de partitions défini. Cependant, le nombre de partitions peut être inférieur ou supérieur au nombre défini, car cette méthode génère toujours des partitions dont les limites sont faciles à lire (avec autant de nombres pairs que possible).
Le premier argument est la colonne à partitionner et le second argument le nombre de partitions souhaitées.
Exemple : AutoBinNumeric([Column], 10) |
| BinByDateTime | Regroupe les valeurs dans les partitions à partir d'une hiérarchie naturelle de dates, de dates et heures ou d'heures.
Le premier argument est la colonne Date, Time ou DateTime à partitionner. Le deuxième argument définit les niveaux de la hiérarchie. Les niveaux de hiérarchie doivent être rédigés sous forme de chaîne contenant les parties de date souhaitées, séparées par des points, par exemple « Year.Quarter.Month ». Le troisième argument est le niveau d'élagage spécifiant le niveau de la hiérarchie à afficher. Si vous rédigez une expression personnalisée basée sur une expression BinByDateTime, un sélecteur de colonne s'affiche avec tous les niveaux de la hiérarchie disponible spécifiée, mais avec le curseur de hiérarchie positionné au niveau d'élagage défini.
Les arguments valides pour Arg2 sont une combinaison de : « year » ou « yy » - L'année. « quarter » ou « qq » - Le trimestre. « month » ou « mm » - Le mois. « day of year » ou « dy » - Le jour de l'année. « day » ou « dd » - Le jour. « week » ou « wk » - La semaine. « day of week » ou « dw » - Le jour de la semaine. « hour » ou « hh » - L'heure. « minute » ou « mi » - La minute. « second » ou « ss » - La seconde. « millisecond » ou « ms » - La milliseconde.
Exemple : BinByDateTime([Column],"Year.Quarter.Month.Day",2) Pour une colonne de date appelée Date de commande, l'expression ci-dessus produit le sélecteur de colonne et le curseur de hiérarchie présentés ci-dessous, si elle est utilisée dans une expression personnalisée : Pour le niveau d'élagage 0, le curseur est placé à la position « Année », pour le niveau 1, à la position Trimestre ; pour le niveau 2, à la position Mois et pour le niveau 3, la position Jour. |
| BinByEvenDistance | Regroupe les valeurs dans la colonne spécifiée afin d'obtenir une distance égale entre toutes les partitions.
Le premier argument est la colonne à partitionner et le second est la longueur des intervalles. Le troisième argument (facultatif) spécifie l'emplacement de départ du décompte. Si aucun argument de départ n'est spécifié, la première partition débute à zéro.
Exemples : BinByEvenDistance([Column], 10) BinByEvenDistance([Column], 10, 5) |
| BinByEvenDistribution | Regroupe les valeurs dans la colonne spécifiée afin que chaque partition (groupe) ait le même nombre de valeurs uniques que les autres. La dernière partition peut comporter davantage de valeurs uniques que les autres.
Le premier argument est la colonne à partitionner et le second argument le nombre de partitions. Les valeurs non valides génèrent un résultat non valide.
Exemple : BinByEvenDistribution([Column], 5) BinByEvenDistribution(Rank([Column])*Count() + RowId(), 3) |
| BinByEvenIntervals | Regroupe les valeurs dans la colonne spécifiée afin que la plage de valeurs soit divisée en intervalles égales. Le premier argument est la colonne à partitionner et le second argument le nombre de partitions.
Exemple : BinByEvenIntervals([Column], 5) |
| BinBySpecificLimits | Regroupe les valeurs dans la colonne spécifiées par limites définies pour les partitions (groupes). Le premier argument est la colonne à partitionner et les arguments suivants représentent les limites des partitions. Toutes les lignes dont les valeurs sont supérieures à la plus grande limite auront la même valeur partitionnée. Les valeurs non valides génèrent un résultat non valide.
Exemple : BinBySpecificLimits([Column], 1, 2, 3, 10) |
| BinByStdDev | Regroupe les valeurs dans différentes partitions selon leur distance de la valeur moyenne, mesurée en écart type. Le premier argument est la colonne à partitionner et les arguments suivants sont le nombre d'écarts type à afficher par rapport à la moyenne. Les arguments d'écart type devront être fournis dans l'ordre croissant et toutes les valeurs doivent être positives.
Exemple : BinByStdDev([Column], 0.5, 1) Cette fonction permettra de créer une partition pour : ≤ -1 écart type écart type -1 écart type -0,5 écart type 0.5 écart type 1 écart type > 1 |
| BinBySubstring | Regroupe les valeurs en partitions selon le caractère de début ou de fin de la valeur. Cela signifie que vous pourrez utiliser cette méthode pour regrouper toutes les valeurs commençant par un « A » dans une partition, celles commençant par un « B » dans une autre, et ainsi de suite.
Le premier argument est la colonne String à partitionner et le suivant est le nombre de caractères contenus dans la sous-chaîne. Si l'argument suivant est négatif, la sous-chaîne démarre à la fin de la valeur.
Exemples : BinBySubstring([Column], 1) BinBySubstring([Column], -4) BinBySubstring(String([Integer Column]), 1) |
| BinByTimeSpan | Regroupe les valeurs en partitions selon une période.
Le premier argument est la colonne TimeSpan à partitionner. Le deuxième argument est la définition du niveau de hiérarchie écrite sous forme de chaîne contenant les périodes souhaitées, séparées par des points (« Hours.Minutes », par exemple). Le troisième argument est le niveau d'élagage de base zéro spécifiant le niveau de la hiérarchie à afficher. Les arguments valides pour Arg2 sont une combinaison de : « Days » - Les jours. « Hours » - Les heures. « Minutes » - Les minutes. « Seconds » - Les secondes. « Milliseconds » - Les millisecondes. Exemple : BinByTimeSpan([Column],"Days.Hours.Minutes.Seconds",2) Pour une colonne TimeSpan intitulée Différence de temps, l'expression ci-dessus entraîne l'affichage du sélecteur de colonne et du curseur de hiérarchie suivants lorsqu'ils sont utilisés dans une expression personnalisée : |
| FiscalBinByDateTime | Regroupe les valeurs en partitions selon une hiérarchie naturelle de dates ou de dates et heures, avec un décalage des niveaux correspondant au nombre de mois indiqué.
Le premier argument est la colonne Date ou DateTime à partitionner. Le deuxième argument est la définition du niveau de hiérarchie écrite sous la forme d'une chaîne contenant les parties de date souhaitées, séparées par des points (par exemple, « Year.Quarter.Month »). Seules les valeurs Year, Quarter et Month sont prises en charge. Le troisième argument est le niveau d'élagage spécifiant le niveau de la hiérarchie à afficher. Le quatrième argument (facultatif) correspond au nombre de mois à décaler. Si cet argument n'a pas été défini, la valeur FiscalYearOffset de la propriété du document est utilisée.
Exemples : FiscalBinByDateTime([Date Column], "Year.Quarter.Month", 1, 2) FiscalBinByDateTime([Date Column], "Year.Quarter.Month", 2) |
Voir aussi Fonctions.
Exemple
Prenons l'exemple d'une colonne avec les valeurs suivantes :
Si la colonne est partitionnée à l'aide des méthodes de partition ci-dessous, les limites obtenues s'affichent comme suit :
| Méthode de partition | Résultat |
|---|---|
| AutoBinNumeric([Column],5) | 
|
| BinByEvenDistance([Column],5) | 
|
| BinByEvenDistribution([Column],5) | 
|
| BinByEvenIntervals([Column],5) | 
|
| BinBySpecificLimits([Column],-2,4,10,16,22) | 
|