Descendants (MDX)

Restituisce il set di discendenti di un membro al livello o alla distanza specificata, includendo o escludendo facoltativamente i discendenti in altri livelli.

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

Espressione_membro
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.

Distanza
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 si specifica un livello, la funzione Descendants restituisce un set contenente i discendenti del membro specificato o i membri del set specificato, a un livello specificato, facoltativamente modificato da un flag specificato in Desc_Flag.

Se si specifica Distance , la funzione Descendants restituisce un set contenente i discendenti del membro specificato o i membri del set specificato che sono il numero specificato di livelli di distanza nella gerarchia del membro specificato, facoltativamente modificato 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 nuovamente creato. In altre parole, la sintassi usata per la funzione Descendants è funzionalmente equivalente alla funzione MDX Generate .

Se non viene specificato alcun livello o distanza, il valore predefinito per il livello usato dalla funzione viene determinato chiamando la funzione Level (<<Member>>). Livello) per il membro specificato (se è specificato un membro) o chiamando la funzione Level per ogni membro del set specificato (se è specificato 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 .

Contrassegno Descrizione
SELF Restituisce soltanto i membri discendenti alla distanza indicata o del livello specificato. La funzione include il membro specificato, se il livello specificato corrisponde al livello di tale membro.
DOPO Restituisce i membri discendenti di tutti i livelli subordinati alla distanza indicata o al livello specificato.
PRIMA Restituisce i membri discendenti di tutti i livelli tra il membro specificato e il livello specificato oppure alla distanza indicata. Include il membro specificato, ma non i membri della distanza indicata o del livello specificato.
BEFORE_AND_AFTER Restituisce i membri discendenti di tutti i livelli subordinati al livello del membro specificato. Include il membro specificato, ma non i membri del livello specificato o alla distanza indicata.
SELF_AND_AFTER Restituisce i membri discendenti del livello specificato o alla distanza indicata e di tutti i livelli subordinati al livello specificato oppure alla distanza indicata.
SELF_AND_BEFORE Restituisce i membri discendenti del livello specificato o alla distanza indicata e di tutti i livelli tra il membro specificato e il livello specificato oppure alla distanza indicata, includendo il membro specificato.
SELF_BEFORE_AFTER Restituisce i membri discendenti di tutti i livelli subordinati al livello del membro specificato, includendo tale membro.
LEAVES Restituisce i membri discendenti di tipo foglia tra il membro specificato e il livello specificato oppure alla distanza indicata.

Esempi

Nell'esempio seguente vengono restituiti il membro specificato (Stati Uniti) e i membri tra il membro specificato (Stati Uniti) e i membri del livello che precede il livello specificato (City). Vengono quindi restituiti il membro specificato stesso (Stati Uniti) e i membri del livello State-Province, che precede il livello City. Nell'esempio sono inclusi argomenti impostati come commenti che consentono di testare facilmente altri argomenti per questa funzione.

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]   

Nell'esempio seguente viene restituita la media giornaliera della Measures.[Gross Profit Margin] misura, calcolata nei giorni di ogni mese nell'anno fiscale 2003, dal cubo Adventure Works . La funzione Descendants restituisce un set di giorni determinato dal membro corrente della [Date].[Fiscal] gerarchia.

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

Nell'esempio seguente viene utilizzata un'espressione di livello e vengono restituiti l'importo delle vendite su Internet per ogni State-Province in Australia e la percentuale sul totale delle vendite su Internet per l'Australia per ogni State-Province. In questo esempio viene utilizzata la funzione Item per estrarre la prima tupla (e solo) dal set restituito dalla funzione Predecessors .

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]  
  

Vedi anche

Guida di riferimento alle funzioni MDX (MDX)