Ancestor(MDX)Ancestor (MDX)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

지정된 수준이나 지정된 멤버로부터 지정된 거리만큼 떨어진 수준에서 지정된 멤버의 상위 항목을 반환하는 함수입니다.A function that returns the ancestor of a specified member at a specified level or at a specified distance from the member.

구문Syntax


Level syntax  
Ancestor(Member_Expression, Level_Expression)  

Numeric syntax  
Ancestor(Member_Expression, Distance)  

인수Arguments

Member_ExpressionMember_Expression
멤버를 반환하는 유효한 MDX 식입니다.A valid Multidimensional Expressions (MDX) expression that returns a member.

Level_ExpressionLevel_Expression
수준을 반환하는 유효한 MDX 식입니다.A valid Multidimensional Expressions (MDX) expression that returns a level.

거리Distance
지정된 멤버와의 거리를 지정하는 유효한 숫자 식입니다.A valid numeric expression that specifies the distance from the specified member.

주의Remarks

상위 함수를 제공 하는 함수 MDX 멤버 식을 사용 하 여 고 멤버의 상위 항목인 수준의 MDX 식 또는 해당 멤버 위의 수준 수를 나타내는 숫자 식을 제공 합니다.With the Ancestor function, you provide the function with an MDX member expression and then provide either an MDX expression of a level that is an ancestor of the member or a numeric expression that represents the number of levels above that member. 이 정보는 상위 함수는 해당 수준의 상위 멤버를 반환 합니다.With this information, the Ancestors function returns the ancestor member at that level.

참고

상위 멤버 뿐 아니라 상위 멤버를 포함 하는 집합을 반환 하려면 사용 된 상위 요소 ( Mdx) 함수입니다.To return a set containing the ancestor member, instead of just the ancestor member, use the Ancestors (MDX) function.

수준 식이 지정 되는 상위 함수는 지정된 된 수준에서 지정 된 멤버의 상위 항목을 반환 합니다.If a level expression is specified, the Ancestor function returns the ancestor of specified member at the specified level. 지정된 멤버가 지정된 수준과 동일한 계층 내에 없으면 이 함수는 오류를 반환합니다.If the specified member is not within the same hierarchy as specified level, the function returns an error.

거리를 지정 하는 경우는 상위 함수는 멤버 식으로 지정 된 계층에서 지정 된 단계 수를 지정된 된 멤버의 상위 항목을 반환 합니다.If a distance is specified, the Ancestor function returns the ancestor of the specified member that is the number of steps specified up in the hierarchy specified by the member expression. 멤버는 특성 계층, 사용자 정의 계층 또는 경우에 따라 부모-자식 계층의 멤버로 지정될 수 있습니다.A member may be specified as a member of an attribute hierarchy, a user-defined hierarchy, or in some cases, a parent-child hierarchy. 숫자 1은 멤버의 부모를 반환하고 숫자 2는 멤버의 최상위 항목(있는 경우)을 반환합니다.A number of 1 returns a member's parent and a number of 2 returns a member's grandparent (if one exists). 숫자 0은 해당 멤버 자체만 반환합니다.A number of 0 returns the member itself.

참고

이 형식을 사용 하 여는 상위 함수 경우은 부모의 수준을 알 수 없는 또는 명명할 수 없습니다.Use this form of the Ancestor function for cases in which the level of the parent is unknown or cannot be named.

Examples

다음 예에서는 수준 식을 사용하고 Australia의 각 State-Province에 대한 Internet Sales Amount와 Australia의 총 Internet Sales Amount에 대한 이 값의 백분율을 반환합니다.The following example uses a level expression and returns the Internet Sales Amount for each State-Province in Australia and its percent of the total Internet Sales Amount for Australia.

WITH MEMBER Measures.x AS [Measures].[Internet Sales Amount] /   
   (  
   [Measures].[Internet Sales Amount],    
      Ancestor   
         (  
         [Customer].[Customer Geography].CurrentMember,  
            [Customer].[Customer Geography].[Country]  
         )  
   ), 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]  

다음 예에서는 숫자 식을 사용하고 Australia의 각 State-Province에 대한 Internet Sales Amount와 모든 국가의 총 Internet Sales Amount에 대한 이 값의 백분율을 반환합니다.The following example uses a numeric expression and returns the Internet Sales Amount for each State-Province in Australia and its percent of the total Internet Sales Amount for all countries.

WITH MEMBER Measures.x AS [Measures].[Internet Sales Amount] /   
   (  
      [Measures].[Internet Sales Amount],  
         Ancestor   
            ([Customer].[Customer Geography].CurrentMember, 2)  
   ), 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]  

관련 항목:See Also

MDX 함수 참조 ( Mdx)MDX Function Reference (MDX)