Descendants (MDX)

Sintassi

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

Argomenti

• Member_Expression
  Espressione MDX (Multidimensional Expression) valida che restituisce un membro.

• Set_Expression
  Espressione MDX (Multidimensional Expression) valida che restituisce un set.

• Level_Expression
  Espressione MDX (Multidimensional Expression) valida che restituisce un livello.

• Distance
  Espressione numerica valida che specifica la distanza dal membro specificato.

• Desc_Flag
  Espressione stringa valida che specifica un flag descrittivo che distingue i possibili set di discendenti.

Osservazioni

Se viene specificato un livello, la funzione Descendants restituisce un set contenente i discendenti del membro specificato o dei membri del set specificato, al livello specificato, modificato facoltativamente da un flag specificato in Desc_Flag.

Se si specifica Distance, la funzione Descendants restituisce un set contenente i discendenti del membro specificato o dei membri del set specificato che si trovano al numero di livelli di distanza specificato nella gerarchia del membro specificato, modificato facoltativamente da un flag specificato in Desc_Flag. Questa funzione viene in genere utilizzata con l'argomento Distance per gestire gerarchie incomplete. Se la distanza specificata è zero (0), la funzione restituisce un set costituito soltanto dal membro specificato o dal set specificato.

Se viene specificata un'espressione set, la funzione Descendants viene risolta singolarmente per ogni membro del set e il set viene creato nuovamente. In altri termini, la sintassi utilizzata per la funzione Descendants equivale dal punto di vista funzionale alla funzione MDX Generate.

Se non si specifica un livello o una distanza, il valore predefinito del livello utilizzato dalla funzione viene determinato chiamando la funzione Level (<<Member>>.Level) per il membro specificato, se è indicato un membro, oppure chiamando la funzione Level per ogni membro del set specificato, se è indicato un set. Se non si specifica un'espressione di livello o la distanza o non vengono specificati flag, la funzione viene eseguita come se fosse stata utilizzata la sintassi seguente:

Descendants

(

Member_Expression ,

Member_Expression.Level ,

SELF_BEFORE_AFTER

)

Se si specifica un livello e non viene specificato un flag descrittivo, la funzione viene eseguita come se fosse stata utilizzata la sintassi seguente:

Descendants

(

Member_Expression ,

Level_Expression,

SELF

)

Modificando il valore del flag descrittivo è possibile includere o escludere i discendenti alla distanza o al livello specificato, gli elementi figlio prima o dopo la distanza o il livello specificato (fino al nodo foglia) e tutti gli elementi figlio di tipo foglia indipendentemente dalla distanza o dal livello specificato. Nella tabella seguente vengono descritti i flag consentiti nell'argomento Desc_Flag.

Esempi

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]

Vedere anche

Riferimento