Förfäder (MDX)

En funktion som returnerar mängden av alla förfäder till en specificerad medlem på en specificerad nivå eller på ett angivet avstånd från medlemmen. Med Analysis Services kommer den returnerade uppsättningen alltid att bestå av en enda medlem – Analysis Services stöder inte flera föräldrar för en enda medlem.

Syntax

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

Arguments

Member_Expression
Ett giltigt Multidimensional Expressions (MDX)-uttryck som returnerar en medlem.

Level_Expression
Ett giltigt Multidimensional Expressions (MDX)-uttryck som returnerar en nivå.

Avstånd
Ett giltigt numeriskt uttryck som specificerar avståndet från den angivna medlemmen.

Remarks

Med Ancestors-funktionen ger du funktionen ett MDX-medlemsuttryck och ger sedan antingen ett MDX-uttryck på en nivå som är en förfader till den medlemmen eller ett numeriskt uttryck som representerar antalet nivåer ovanför den medlemmen. Med denna information returnerar Ancestors-funktionen mängden av medlemmar (som kommer att vara en mängd bestående av en medlem) på den nivån.

Om ett nivåuttryck specificeras, returnerar Ancestors-funktionen mängden av alla förfäder till den angivna medlemmen på den angivna nivån. Om den angivna medlemmen inte är inom samma hierarki som den angivna nivån, returnerar funktionen ett fel.

Om ett avstånd anges returnerar Ancestors-funktionen mängden av alla medlemmar som är antalet steg som anges uppåt i hierarkin som anges av medlemuttrycket. En medlem kan specificeras som medlem i en attributhierarki, en användardefinierad hierarki eller, i vissa fall, en förälder-barn-hierarki. Ett nummer 1 returnerar mängden medlemmar på föräldranivå och ett tal 2 returnerar mängden medlemmar på mor- eller farföräldernivå (om en sådan finns). Ett antal 0 returnerar mängden inklusive endast själva medlemmen.

Examples

Följande exempel använder funktionen Förfäder för att returnera måttet Internet Sales Amount för en medlem, dess moderbolag och dess morförälder. Detta exempel använder nivåuttryck för att specificera vilka nivåer som ska returneras. Nivåerna ligger i samma hierarki som medlemmen som anges i medlemsuttrycket.

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]  

Följande exempel använder funktionen Förfäder för att returnera måttet Internet Sales Amount för en medlem, dess moderbolag och dess morförälder. Detta exempel använder numeriska uttryck för att specificera vilka nivåer som returneras. Nivåerna ligger i samma hierarki som medlemmen som anges i medlemsuttrycket.

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]  

Följande exempel använder funktionen Ancestors för att returnera Internet Sales Amount-måttet för föräldern till en medlem i en attributhierarki. Detta exempel använder ett numeriskt uttryck för att ange vilken nivå som returneras. Eftersom medlemmen i medlemsuttrycket är medlem i en attributhierarki, är dess förälder [All]-nivån.

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

Relaterat innehåll

• Referens för MDX-funktioner (MDX)