Root (MDX)

Mis à jour : 17 juillet 2006

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]

Voir aussi

Référence

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

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications