Descendants (MDX)

Mis à jour : 17 juillet 2006

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.

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

L'exemple ci-après retourne le membre spécifié (United States) et les membres situés entre le membre spécifié (United States) et les membres du niveau avant le niveau spécifié (City). Il retourne le membre spécifié lui-même (United States) et les membres du niveau State-Province (niveau avant le niveau City). Cet exemple inclut des arguments avec commentaires qui vous permettent de tester facilement d'autres arguments pour cette fonction.

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] 

L'exemple qui suit renvoie la moyenne quotidienne de la mesure Measures.[Gross Profit Margin], calculée sur les jours de chaque mois de l'année fiscale 2003 dans le cube Adventure Works. La fonction Descendants renvoie une série de jours déterminés à partir du membre actuel de la hiérarchie [Date].[Fiscal].

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])

L'exemple suivant utilise une expression de niveau et retourne la mesure Internet Sales Amount (volume de vente Internet) pour chaque State-Province (état-province) en Australie ; de même, il retourne le pourcentage de volume de vente Internet total pour l'Australie par état-province. L'exemple utilise la fonction Item pour extraire le premier (et unique) tuple du jeu que retourne la fonction Ancestors.

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

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

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications