Guide de référence des fonctions MDX (MDX)
Analysis Services fournit l’utilisation de fonctions dans la syntaxe MDX (Multidimensional Expressions). Ces fonctions peuvent être employées dans n'importe quelle instruction MDX valide ; elles sont souvent utilisées dans des requêtes, des définitions de cumul personnalisées et d'autres calculs. Cette section fournit des informations sur les fonctions MDX.
Vous pouvez utiliser les tableaux ci-après pour rechercher des fonctions selon le type de valeurs qu'elles retournent, ou bien sélectionner une fonction par son nom dans la liste alphabétique du sommaire.
Fonctions de tableau
| Fonction | Description |
|---|---|
| SetToArray (MDX) | Convertit un ou plusieurs jeux en tableau utilisé par une fonction définie par l'utilisateur. |
Fonctions de hiérarchie
| Fonction | Description |
|---|---|
| Hierarchy (MDX) | Retourne la hiérarchie qui contient le membre ou le niveau spécifié. |
| Dimension (MDX) | Retourne la dimension qui contient un membre, un niveau ou une hiérarchie spécifiés. |
| Dimensions (MDX) | Retourne la hiérarchie spécifiée par une expression numérique ou de chaîne. |
Fonctions de niveau
| Fonction | Description |
|---|---|
| Level (MDX) | Retourne le niveau d'un membre. |
| Levels (MDX) | Retourne le niveau dont la position dans une dimension ou une hiérarchie est spécifiée par une expression numérique ou dont le nom est spécifié par une expression de chaîne. |
Fonctions logiques
| Fonction | Description |
|---|---|
| IsAncestor (MDX) | Retourne une valeur indiquant si un membre spécifié est un ancêtre d'un autre membre spécifié. |
| IsEmpty (MDX) | Retourne une valeur indiquant si l'expression évaluée est la valeur de la cellule vide. |
| IsGeneration (MDX) | Retourne une valeur indiquant si un membre spécifié est dans une génération spécifiée. |
| IsLeaf (MDX) | Retourne une valeur indiquant si un membre spécifié est un membre feuille. |
| IsSibling (MDX) | Retourne une valeur indiquant si un membre spécifié est un frère d'un autre membre spécifié. |
Fonctions de membre
| Fonction | Description |
|---|---|
| Ancestor (MDX) | Retourne l'ancêtre d'un membre au niveau spécifié ou à la distance spécifiée. |
| ClosingPeriod (MDX) | Retourne le dernier frère parmi les descendants d'un membre à un niveau spécifique. |
| Cousin (MDX) | Retourne le membre enfant avec la même position relative sous un membre parent que le membre enfant spécifié. |
| CurrentMember (MDX) | Retourne le membre actuel dans une dimension ou une hiérarchie spécifiée au cours d'une itération. |
| DataMember (MDX) | Retourne le membre de données générées par le système associé à un membre non-feuille d'une dimension. |
| DefaultMember (MDX) | Retourne le membre par défaut d'une dimension ou d'une hiérarchie. |
| FirstChild (MDX) | Retourne le premier enfant d'un membre. |
| FirstSibling (MDX) | Retourne le premier enfant du parent d'un membre. |
| Item (Member) (MDX) | Retourne un membre à partir d'un tuple spécifié. |
| Lag (MDX) | Retourne le membre qui est un nombre spécifié de positions avant un membre spécifié le long de la dimension du membre. |
| LastChild (MDX) | Retourne le dernier enfant d'un membre spécifié. |
| LastSibling (MDX) | Retourne le dernier enfant du parent d'un membre spécifié. |
| Lead (MDX) | Retourne un membre qui est un nombre spécifié de positions après un membre spécifié le long de la dimension du membre. |
| LinkMember (MDX) | Retourne le membre équivalent à un membre spécifié dans une hiérarchie spécifique. |
| Members (String) (MDX) | Retourne un membre spécifié par une expression de chaîne. |
| NextMember (MDX) | Retourne le membre suivant dans le niveau qui contient le membre spécifié. |
| OpeningPeriod (MDX) | Retourne le premier frère parmi les descendants d'un niveau spécifié, éventuellement à un membre spécifié. |
| ParallelPeriod (MDX) | Retourne un membre d'une période antérieure dans la même position relative que le membre spécifié. |
| Parent (MDX) | Retourne le parent d'un membre. |
| PrevMember (MDX) | Retourne le membre précédent dans le niveau qui contient le membre spécifié. |
| StrToMember (MDX) | Retourne le membre spécifié par une chaîne au format MDX. |
| UnknownMember (MDX) | Retourne le membre inconnu associé à un niveau ou un membre. |
| ValidMeasure (MDX) | Retourne une mesure valide dans un cube virtuel en forçant les dimensions inapplicables à leur niveau maximum. |
Fonctions numériques
| Fonction | Description |
|---|---|
| Aggregate (MDX) | Retourne une valeur scalaire calculée par agrégation soit de mesures soit d'une expression numérique spécifiée éventuellement sur les tuples d'un jeu spécifié. |
| Avg (MDX) | Retourne la valeur moyenne des mesures ou la valeur moyenne d'une expression numérique facultative, évaluée sur un jeu spécifié. |
| CalculationCurrentPass (MDX) | Retourne le test de calcul actuel d'un cube pour le contexte de requête spécifié. |
| CalculationPassValue (MDX) | Retourne la valeur d’une expression MDX évaluée sur la passe de calcul spécifiée d’un cube. |
| CoalesceEmpty (MDX) | Fusionne la valeur d'une cellule vide avec un nombre ou une chaîne et retourne la valeur fusionnée. |
| Correlation (MDX) | Retourne le coefficient de corrélation de deux séries évaluées sur un jeu. |
| Count (Dimension) (MDX) | Retourne le nombre de dimensions contenues dans un cube. |
| Count (Hierarchy Levels) (MDX) | Retourne le nombre de niveaux d'une dimension ou d'une hiérarchie. |
| Count (Set) (MDX) | Retourne le nombre de cellules d'un jeu. |
| Count (Tuple) (MDX) | Retourne le nombre de dimensions d'un tuple. |
| Covariance (MDX) | Retourne la covariance de remplissage de deux séries évaluées sur un jeu, à l'aide de la formule de remplissage biaisée. |
| CovarianceN (MDX) | Retourne l'exemple de covariance de deux séries évaluées sur un jeu, à l'aide de la formule de remplissage non biaisée. |
| DistinctCount (MDX) | Retourne le nombre des différents tuples non vides d'un jeu. |
| IIf (MDX) | Retourne l'une des deux valeurs déterminées par un test logique. |
| LinRegIntercept (MDX) | Calcule la régression linéaire d’un jeu et retourne la valeur de l’intercept dans la ligne de régression, y = ax + b. |
| LinRegPoint (MDX) | Calcule la régression linéaire d’un ensemble et retourne la valeur de y dans la ligne de régression, y = ax + b. |
| LinRegR2 (MDX) | Calcule la régression linéaire d'un jeu et retourne R2 (coefficient de détermination). |
| LinRegSlope (MDX) | Calcule la régression linéaire d’un ensemble et retourne la valeur de la pente dans la ligne de régression, y = ax + b. |
| LinRegVariance (MDX) | Calcule la régression linéaire d’un ensemble et retourne la variance associée à la ligne de régression, y = ax + b. |
| LookupCube (MDX) | Retourne la valeur d'une expression MDX évaluée sur un autre cube spécifié dans la même base de données. |
| Max (MDX) | Retourne la valeur maximale d'une expression numérique évaluée sur un jeu. |
| Median (MDX) | Retourne la valeur médiane d'une expression numérique évaluée sur un jeu. |
| Min (MDX) | Retourne la valeur minimale d'une expression numérique évaluée sur un jeu. |
| Ordinal (MDX) | Retourne la valeur ordinale de base zéro associée à un niveau. |
| Predict (MDX) | Retourne une valeur d'expression numérique évaluée sur un modèle d'exploration de données. |
| Rank (MDX) | Retourne le rang de base un d'un tuple dans un jeu. |
| RollupChildren (MDX) | Retourne une valeur générée par le cumul des valeurs des enfants d'un membre spécifié à l'aide de l'opérateur unaire spécifié. |
| Stddev (MDX) | Alias pour Stdev (MDX). |
| StddevP (MDX) | Alias pour StdevP (MDX). |
| Stdev (MDX) | Retourne l'écart-type d'une expression numérique évaluée sur un jeu, à l'aide de la formule de remplissage non biaisée. |
| StdevP (MDX) | Retourne l'écart-type du remplissage d'une expression numérique évaluée sur un jeu, à l'aide de la formule de remplissage biaisée. |
| StrToValue (MDX) | Retourne la valeur spécifiée par une chaîne au format MDX. |
| Sum (MDX) | Retourne la somme d'une expression numérique évaluée sur un jeu. |
| Value (MDX) | Retourne la valeur d'une mesure. |
| Var (MDX) | Retourne l'exemple de variance d'une expression numérique évaluée sur un jeu, à l'aide de la formule de remplissage non biaisée. |
| Variance (MDX) | Alias pour Var (MDX). |
| VarianceP (MDX) | Alias pour VarP (MDX). |
| VarP (MDX) | Retourne la variance du remplissage d'une expression numérique évaluée sur un jeu, à l'aide de la formule de remplissage biaisée. |
Fonctions de jeu
| Fonction | Description |
|---|---|
| AddCalculatedMembers (MDX) | Retourne un jeu généré par l'ajout de membres calculés à un jeu spécifié. |
| AllMembers (MDX) | Retourne un jeu qui contient tous les membres de la dimension, de la hiérarchie ou du niveau spécifié, notamment les membres calculés. |
| Ancestors (MDX) | Retourne un jeu de tous les ancêtres d'un membre à un niveau spécifié ou à une distance spécifiée. |
| Ascendants (MDX) | Retourne le jeu des ascendants du membre spécifié, notamment le membre lui-même. |
| Axis (MDX) | Retourne un jeu défini dans un axe. |
| BottomCount (MDX) | Trie un jeu en ordre croissant et retourne le nombre spécifié de tuples avec les valeurs les plus basses. |
| BottomPercent (MDX) | Trie un jeu en ordre croissant, et retourne un jeu de tuples avec les valeurs les plus basses dont le total cumulé est égal ou inférieur à un pourcentage spécifié. |
| BottomSum (MDX) | Trie un jeu en ordre croissant et retourne un jeu de tuples avec les valeurs les plus basses dont le total est égal ou inférieur à une valeur spécifiée. |
| Children (MDX) | Retourne les enfants d'un membre spécifié. |
| Crossjoin (MDX) | Retourne le produit croisé d'un ou plusieurs jeux. |
| CurrentOrdinal (MDX) | Retourne le numéro d'itération actuel dans un jeu lors d'une itération. |
| Descendants (MDX) | Retourne le jeu de descendants d'un membre à un niveau spécifié ou à une distance spécifiée, en incluant ou en excluant éventuellement des descendants dans d'autres niveaux. |
| Distinct (MDX) | Retourne un jeu et supprime les tuples dupliqués à partir d'un jeu spécifié. |
| DrilldownLevel (MDX) | Extrait vers le bas les membres d'un jeu d'un niveau sous le niveau le plus bas représenté dans le jeu, ou d'un niveau sous le niveau facultatif d'un membre représenté dans le jeu. |
| DrilldownLevelBottom (MDX) | Extrait vers le bas les membres les plus bas d'un jeu, d'un niveau à partir d'un niveau spécifié. |
| DrilldownLevelTop (MDX) | Extrait vers le bas les membres les plus hauts d'un jeu, d'un niveau à partir du niveau spécifié. |
| DrilldownMember (MDX) | Extrait vers le bas les membres dans un jeu spécifié, qui sont présents dans un second jeu spécifié. La fonction peut également explorer un ensemble de tuples. |
| DrilldownMemberBottom (MDX) | Extrait vers le bas les membres dans un jeu spécifié qui sont présents dans un second jeu spécifié, ce qui limite l'ensemble de résultats à un nombre spécifique de membres. Cette fonction permet également d'extraire vers le bas un jeu de tuples. |
| DrilldownMemberTop (MDX) | Extrait vers le bas les membres dans un jeu spécifié qui sont présents dans un second jeu spécifié, ce qui limite l'ensemble de résultats à un nombre spécifique de membres. Cette fonction permet également d’explorer un ensemble de tuples. |
| DrillupLevel (MDX) | Extrait vers le haut les membres d'un jeu situé au-dessous du niveau spécifié. |
| DrillupMember (MDX) | Extrait vers le haut les membres d'un ensemble spécifié qui sont présents dans un second jeu. |
| Except (MDX) | Recherche la différence entre deux jeux, en conservant éventuellement les doublons. |
| Exists (MDX) | Retourne le jeu des membres d'un jeu qui existe avec un ou plusieurs tuples d'un ou plusieurs autres jeux. |
| Extract (MDX) | Retourne un jeu de tuples à partir d'éléments de dimension extraits. |
| Filter (MDX) | Retourne le jeu résultant du filtrage d'un jeu spécifié selon une condition de recherche. |
| Generate (MDX) | Applique un jeu à chaque membre d'un autre jeu, puis effectue la jointure par union des jeux résultants. Cette fonction retourne également une chaîne concaténée créée par l'évaluation d'une expression de chaîne sur un jeu. |
| Head (MDX) | Retourne le premier nombre spécifié d'éléments dans un jeu, en conservant les doublons. |
| Hierarchize (MDX) | Ordonne les membres d'un jeu en hiérachie. |
| Intersect (MDX) | Retourne l'intersection de deux ensembles d'entrée, en conservant éventuellement les doublons. |
| LastPeriods (MDX) | Retourne le jeu des membres antérieurs à et incluant un membre spécifié. |
| Members (Set) (MDX) | Retourne le jeu des membres d'une dimension, d'un niveau ou d'une hiérarchie. |
| Mtd (MDX) | Retourne un jeu des membres frères de même niveau qu'un membre donné, commençant par le premier frère et se terminant par le membre donné, conformément à la contrainte du niveau Year de la dimension Time. |
| NameToSet (MDX) | Retourne un jeu qui contient le membre spécifié par une chaîne au format MDX. |
| NonEmptyCrossjoin (MDX) | Retourne le produit croisé d'un ou plusieurs jeux sous la forme d'un jeu, en excluant les tuples vides et les tuples qui ne sont associés à aucune table de faits. |
| Order (MDX) | Organise les membres d'un jeu spécifié, en conservant ou non la hiérarchie. |
| PeriodsToDate (MDX) | Retourne un jeu des membres frères de même niveau qu'un membre donné, commençant par le premier frère et se terminant par le membre donné, conformément à la contrainte du niveau spécifié de la dimension Time. |
| Qtd (MDX) | Retourne un ensemble de membres frères du même niveau qu’un membre donné, commençant par le premier frère et se terminant par le membre donné, tel que limité par le niveau Quarter dans la dimension Temps. |
| Siblings (MDX) | Retourne les frères d'un membre spécifié, notamment le membre lui-même. |
| StripCalculatedMembers (MDX) | Retourne un jeu généré en supprimant les membres calculés à partir d'un jeu spécifique. |
| StrToSet (MDX) | Retourne le jeu spécifié par une chaîne au format MDX. |
| Subset (MDX) | Retourne un sous-ensemble de tuples d'un jeu spécifié. |
| Tail (MDX) | Retourne un sous-ensemble de la fin d'un jeu. |
| ToggleDrillState (MDX) | Fait basculer l'état d'extraction des membres. |
| TopCount (MDX) | Trie un jeu en ordre décroissant et retourne le nombre spécifié d'éléments avec les valeurs les plus élevées. |
| TopPercent (MDX) | Trie un jeu en ordre décroissant et retourne un jeu de tuples avec les valeurs les plus élevées dont le total cumulé est égal ou inférieur à un pourcentage spécifié. |
| TopSum (MDX) | Trie un jeu et retourne les éléments situés le plus en haut, dont le total cumulatif est au moins une valeur spécifiée. |
| Union (MDX) | Retourne l'union de deux jeux, en conservant éventuellement les doublons. |
| Unorder (MDX) | Supprime tout classement appliqué d'un jeu spécifié. |
| VisualTotals (MDX) | Retourne un jeu généré en effectuant le total des membres enfants de manière dynamique dans un jeu spécifié, en utilisant éventuellement un modèle pour le nom du membre parent dans le jeu de cellules résultant. |
| Wtd (MDX) | Retourne un jeu des membres frères de même niveau qu'un membre donné, commençant par le premier frère et se terminant par le membre donné, conformément à la contrainte du niveau Week de la dimension Time. |
| Ytd (MDX) | Retourne un ensemble de membres frères du même niveau qu’un membre donné, commençant par le premier frère et se terminant par le membre donné, tel que limité par le niveau Year dans la dimension Time. |
Fonctions de chaîne
| Fonction | Description |
|---|---|
| CalculationPassValue (MDX) | Retourne la valeur d'une expression MDX évaluée sur le test de calcul spécifié d'un cube. |
| CoalesceEmpty (MDX) | Fusionne la valeur d'une cellule vide avec un nombre ou une chaîne et retourne la valeur fusionnée. |
| Generate (MDX) | Applique un jeu à chaque membre d'un autre jeu, puis effectue la jointure par union des jeux résultants. Cette fonction retourne également une chaîne concaténée créée par l'évaluation d'une expression de chaîne sur un jeu. |
| IIf (MDX) | Retourne l'une des deux valeurs déterminées par un test logique. |
| LookupCube (MDX) | Retourne la valeur d'une expression MDX évaluée sur un autre cube spécifié dans la même base de données. |
| MemberToStr (MDX) | Retourne une chaîne au format MDX qui correspond à un membre spécifié. |
| Name (MDX) | Retourne le nom d'une dimension, d'une hiérarchie, d'un niveau ou d'un membre. |
| Properties (MDX) | Retourne une chaîne ou une valeur fortement typée, contenant une valeur de propriété de membre. |
| SetToStr (MDX) | Retourne une chaîne au format MDX correspondant à un jeu spécifié. |
| TupleToStr (MDX) | Retourne une chaîne au format MDX qui correspond au tuple spécifié. |
| UniqueName (MDX) | Retourne le nom unique d'une dimension, d'une hiérarchie, d'un niveau ou d'un membre spécifié. |
| UserName (MDX) | Retourne le nom de domaine et le nom d'utilisateur de la connexion en cours. |
Fonctions de sous-cube
| Fonction | Description |
|---|---|
| This (MDX) | Retourne le sous-cube actuel. |
| Leaves (MDX) | Retourne le jeu des membres feuilles situés dans la dimension, le membre ou le tuple spécifié. |
fonctions de tuple
| Fonction | Description |
|---|---|
| Current (MDX) | Retourne le tuple actif dans un jeu lors d'une itération. |
| Item (Tuple) (MDX) | Retourne un tuple d'un jeu. |
| Root (MDX) | Retourne un tuple qui se compose des membres Tous les membres de chaque hiérarchie d’attributs dans un cube, une dimension ou un tuple. |
| StrToTuple (MDX) | Retourne le tuple spécifié par une chaîne au format MDX. |
Autres fonctions
| Fonction | Description |
|---|---|
| Error (MDX) | Génère une erreur, et fournit éventuellement un message d'erreur spécifié. |