Root (MDX)
Retourne un tuple constitué des membres All (Tous) de chaque hiérarchie d'attribut dans l'étendue actuelle d'un cube, d'une dimension ou d'un tuple. Pour plus d'informations sur l'étendue, consultez Instruction SCOPE (MDX).
[!REMARQUE]
Si une hiérarchie d'attributs n'a pas de membre All, le tuple contient le membre par défaut pour cette hiérarchie.
Syntaxe
Cube syntax
Root ()
Dimension syntax
Root( Dimension_Name )
Tuple syntax
Root( Tuple_Expression ] )
Arguments
Dimension_Name
Expression de chaîne valide qui précise le nom d'une dimension.Tuple_Expression
Expression MDX (Multidimensional Expressions) valide qui retourne un tuple.
Notes
Si ni un nom de dimension, ni une expression de tuple ne sont spécifiés, la fonction Root retourne un tuple qui contient le membre All (ou le membre par défaut si le membre All n'existe pas) de chaque hiérarchie d'attribut dans le cube. L'ordre des membres dans le tuple dépend de la séquence dans laquelle les hiérarchies d'attributs sont définies au sein du cube.
Si un nom de dimension est spécifié, la fonction Root retourne un tuple qui contient le membre All (ou le membre par défaut si le membre All n'existe pas) de chaque hiérarchie d'attribut dans la dimension spécifiée en fonction du contexte du membre actuel. L'ordre des membres dans le tuple dépend de la séquence dans laquelle les hiérarchies d'attributs sont définies au sein de la dimension.
[!REMARQUE]
Si un nom de hiérarchie est spécifié; la fonction Tuple extrait le nom de la dimension du nom de hiérarchie spécifié.
Si une expression de tuple est spécifiée, la fonction Root retourne un tuple qui contient l'intersection du tuple spécifié et des membres All de tous les autres attributs de dimension non explicitement inclus dans le tuple spécifié. Le tuple spécifié ne doit référencer qu'une seule dimension, sinon une erreur se produit.
Exemples
L'exemple ci-dessous retourne le tuple contenant le membre All (ou le membre par défaut si le membre All n'existe pas) de chaque hiérarchie dans le cube Adventure Works.
SELECT Root()ON 0
FROM [Adventure Works]
L'exemple ci-dessous retourne le tuple contenant le membre All (ou le membre par défaut si le membre All n'existe pas) de chaque hiérarchie de la dimension Date au sein du cube Adventure Works, ainsi que la valeur du membre spécifié de la dimension de mesures située à l'intersection de ces membres par défaut.
SELECT Root([Date]) ON 0
FROM [Adventure Works]
WHERE [Measures].[Order Count]
L'exemple ci-dessous retourne le tuple contenant le membre de tuple défini (1er juillet 2001 avec le membre All ou le membre par défaut si le membre All n'existe pas) de chaque hiérarchie non spécifiée de la dimension Date au sein du cube Adventure Works, ainsi que la valeur du membre spécifié de la dimension de mesures située à l'intersection de ces membres.
SELECT Root([Date].[July 1, 2001]) ON 0
FROM [Adventure Works]
WHERE [Measures].[Order Count]