Descendants (MDX)

Syntaxe

Member expression syntax using a level expression
Descendants(Member_Expression [ , Level_Expression [ ,Desc_Flag ] ] )

Member expression syntax using a numeric expression
Descendants(Member_Expression [ , Distance [ ,Desc_Flag ] ] )

Set expression syntax using a level expression
Descendants(Set_Expression [ , Level_Expression [ ,Desc_Flag ] ] )

Member expression syntax using a numeric expression
Descendants(Set_Expression [ , Distance [ ,Desc_Flag ] ] )

Arguments

• Member_Expression
  Expression MDX (Multidimensional Expressions) valide qui retourne un membre.

• Set_Expression
  Expression MDX (Multidimensional Expressions) valide qui retourne un jeu.

• Level_Expression
  Expression MDX (Multidimensional Expressions) valide qui retourne un niveau.

• Distance
  Expression numérique valide qui spécifie la distance depuis le membre spécifié.

• Desc_Flag
  Expression de chaîne valide qui précise un indicateur de description qui identifie de possibles jeux de descendants.

Notes

Si un niveau est spécifié, la fonction Descendants retourne un jeu qui contient les descendants du membre spécifié ou les membres du jeu spécifié, à un niveau spécifié, éventuellement modifié par un indicateur spécifique dans Desc_Flag.

Si le paramètre Distance est spécifié, la fonction Descendants retourne un jeu qui contient les descendants du membre spécifié ou les membres du jeu spécifié correspondant au nombre de niveaux précisé plus loin dans la hiérarchie du membre spécifié, éventuellement modifié par un indicateur spécifique dans Desc_Flag. En règle générale, cette fonction est utilisée avec l'argument Distance pour le travail avec des hiérarchies irrégulières. Si la distance précisée est zéro (0), la fonction retourne un jeu composé uniquement du membre ou du jeu spécifié.

Si une expression d'ensemble est spécifiée, la fonction Descendants est résolue individuellement pour chaque membre du jeu et le jeu est créé de nouveau. En d'autres termes, la syntaxe utilisée pour la fonction Descendants est fonctionnellement équivalente à la fonction MDX Generate.

Si aucun niveau ou aucune distance n'est spécifiée, la valeur par défaut du niveau utilisé par la fonction est déterminée en appelant la fonction Level (<<Member>>.Level) du membre spécifié (si un membre est spécifié) ou bien la fonction Level pour chaque membre du jeu spécifié (si un jeu est spécifié). Si aucune expression de niveau, distance ou aucun indicateur n'est spécifié, la fonction s'exécute comme si la syntaxe suivante était employée :

Descendants

(

Member_Expression ,

Member_Expression.Level ,

SELF_BEFORE_AFTER

)

Si vous spécifiez un niveau mais pas un indicateur de description, la fonction s'exécute comme si la syntaxe suivante était utilisée :

Descendants

(

Member_Expression ,

Level_Expression,

SELF

)

En modifiant la valeur de l'indicateur de description, vous pouvez inclure ou exclure des descendants au niveau spécifié ou à la distance spécifiée, les enfants avant ou après la distance ou le niveau spécifié (jusqu'au nœud feuille), ainsi que les enfants de la feuille quel que soit le niveau spécifié ou la distance spécifiée. Le tableau ci-dessous décrit les indicateurs autorisés dans l'argument Desc_Flag.

Exemples

SELECT Descendants
   ([Geography].[Geography].[Country].&[United States]
      //, [Geography].[Geography].[Country]
   , [Geography].[Geography].[City]
      //, [Geography].[Geography].Levels (3)
      //, SELF 
      //, AFTER
      , BEFORE
      // BEFORE_AND_AFTER
      //, SELF_AND_AFTER
      //, SELF_AND_BEFORE
      //,SELF_BEFORE_AFTER
      //,LEAVES 
   ) ON 0
FROM [Adventure Works] 

WITH MEMBER Measures.[Avg Gross Profit Margin] AS Avg
   (
      Descendants( [Date].[Fiscal].CurrentMember, 
           [Date].[Fiscal].[Date]
          ), 
        Measures.[Gross Profit Margin]
   )
SELECT
   Measures.[Avg Gross Profit Margin] ON COLUMNS,
   [Date].[Fiscal].[Month].Members ON ROWS
FROM [Adventure Works]
WHERE ([Date].[Fiscal Year].&[2003])

WITH MEMBER Measures.x AS 
   [Measures].[Internet Sales Amount] / 
   ( [Measures].[Internet Sales Amount],
      Ancestors 
         ( [Customer].[Customer Geography].CurrentMember, 
           [Customer].[Customer Geography].[Country]
         ).Item (0)
   ), FORMAT_STRING = '0%'
SELECT {[Measures].[Internet Sales Amount], Measures.x} ON 0,
{Descendants 
   ( [Customer].[Customer Geography].[Country].&[Australia], 
     [Customer].[Customer Geography].[State-Province], SELF 
   )  
} ON 1
FROM [Adventure Works]

Voir aussi

Référence