Voorouders (MDX)

Een functie die de verzameling van alle voorouders van een gespecificeerd lid op een gespecificeerd niveau of op een bepaalde afstand van het lid teruggeeft. Bij Analysis Services bestaat de teruggegeven set altijd uit één lid - Analysis Services ondersteunt niet meerdere ouders voor één lid.

Syntax

  
Level syntax  
Ancestors(Member_Expression, Level_Expression)  
  
Numeric syntax  
Ancestors(Member_Expression, Distance)  

Arguments

Member_Expression
Een geldige Multidimensional Expressions (MDX) expressie die een lid teruggeeft.

Level_Expression
Een geldige Multidimensional Expressions (MDX) expressie die een niveau teruggeeft.

Afstand
Een geldige numerieke uitdrukking die de afstand tot het gespecificeerde lid specificeert.

Remarks

Met de Ancestors-functie geef je de functie een MDX-lidexpressie en vervolgens ofwel een MDX-expressie van een niveau dat een voorouder van dat lid is, of een numerieke uitdrukking die het aantal niveaus boven dat lid weergeeft. Met deze informatie geeft de Ancestors-functie de verzameling leden (die een verzameling uit één lid zal zijn) op dat niveau terug.

Als een niveau-expressie wordt gespecificeerd, geeft de Ancestors-functie de verzameling van alle voorouders van het gespecificeerde lid op het gespecificeerde niveau terug. Als het gespecificeerde lid niet binnen dezelfde hiërarchie valt als het gespecificeerde niveau, geeft de functie een foutmelding terug.

Als een afstand wordt gespecificeerd, geeft de Ancestors-functie de verzameling van alle leden terug die het aantal stappen zijn dat hoog in de hiërarchie is gespecificeerd door de lidexpressie. Een lid kan worden gespecificeerd als lid van een attribuuthiërarchie, een door de gebruiker gedefinieerde hiërarchie, of in sommige gevallen een ouder-kindhiërarchie. Een getal van 1 geeft de set leden op het ouderniveau terug en een getal van 2 geeft de set leden op het grootouderniveau terug (als die er is). Een aantal 0 geeft de verzameling terug, inclusief alleen het lid zelf.

Examples

Het volgende voorbeeld gebruikt de Vooroudersfunctie om de Internet Sales Amount-maat terug te geven voor een lid, zijn moeder en zijn grootouder. Dit voorbeeld gebruikt niveau-expressies om de niveaus te specificeren die teruggegeven moeten worden. De niveaus bevinden zich in dezelfde hiërarchie als het lid dat in de lidexpressie is gespecificeerd.

SELECT {  
    Ancestors([Product].[Product Categories].[Product].[Mountain-100 Silver, 38],[Product].[Product Categories].[Category]),  
    Ancestors([Product].[Product Categories].[Product].[Mountain-100 Silver, 38],[Product].[Product Categories].[Subcategory]),  
    Ancestors([Product].[Product Categories].[Product].[Mountain-100 Silver, 38],[Product].[Product Categories].[Product])  
    } ON 0,  
[Measures].[Internet Sales Amount] ON 1  
FROM [Adventure Works]  

Het volgende voorbeeld gebruikt de Vooroudersfunctie om de Internet Sales Amount-maat terug te geven voor een lid, zijn moeder en zijn grootouder. Dit voorbeeld gebruikt numerieke expressies om de teruggegeven niveaus aan te geven. De niveaus bevinden zich in dezelfde hiërarchie als het lid dat in de lidexpressie is gespecificeerd.

SELECT {  
   Ancestors(  
      [Product].[Product Categories].[Product].[Mountain-100 Silver, 38],2  
      ),  
   Ancestors(  
      [Product].[Product Categories].[Product].[Mountain-100 Silver, 38],1  
      ),  
   Ancestors(  
      [Product].[Product Categories].[Product].[Mountain-100 Silver, 38],0  
      )  
   } ON 0,  
[Measures].[Internet Sales Amount] ON 1  
FROM  [Adventure Works]  

Het volgende voorbeeld gebruikt de Ancestors-functie om de Internet Sales Amount-maat terug te geven voor de ouder van een lid van een attribuuthiërarchie. Dit voorbeeld gebruikt een numerieke expressie om het niveau dat wordt teruggegeven aan te geven. Aangezien het lid in de lidexpressie lid is van een attribuuthiërarchie, is de ouder het [All]-niveau.

SELECT {  
   Ancestors(  
      [Product].[Product].[Mountain-100 Silver, 38],1  
      )  
   } ON 0,  
[Measures].[Internet Sales Amount] ON 1  
FROM [Adventure Works]  

Verwante onderwerpen

• MDX-functiereferentie (MDX)