Root (MDX)

Retourne un tuple qui se compose de tous les membres de chaque hiérarchie d’attributs dans l’étendue actuelle dans un cube, une dimension ou un tuple. Pour plus d’informations sur l’étendue, consultez INSTRUCTION SCOPE (MDX).

Notes

Si une hiérarchie d’attributs n’a pas de membre All , le tuple contient le membre par défaut de 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.

Remarques

Si ni un nom de dimension ni une expression de tuple n’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’attributs 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’attributs 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.

Notes

Si un nom de hiérarchie est spécifié, la fonction Tuple choisit le nom de la dimension à partir 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é.

Exemples

L’exemple suivant retourne le tuple contenant le membre All (ou la valeur 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 suivant retourne le tuple contenant le membre All (ou la valeur par défaut si le membre All n’existe pas) de chaque hiérarchie de la dimension Date dans le cube Adventure Works et la valeur du membre spécifié de la dimension Measures qui croise ces membres par défaut.

SELECT Root([Date]) ON 0  
FROM [Adventure Works]  
WHERE [Measures].[Order Count]  

L’exemple suivant retourne le tuple contenant le membre tuple spécifié (1er juillet 2001, ainsi que le membre All (ou la valeur par défaut si le membre All n’existe pas) de chaque hiérarchie non spécifiée dans le cube Adventure Works de la dimension Date et la valeur du membre spécifié de la dimension Mesures qui croise ces membres.

SELECT Root([Date].[July 1, 2001]) ON 0  
FROM [Adventure Works]  
WHERE [Measures].[Order Count]  

Voir aussi

Guide de référence des fonctions MDX (MDX)