Ancestors(MDX)Ancestors (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 set of all ancestors of a specified member at a specified level or at a specified distance from the member. MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services, 반환 되는 집합은 항상 단일 멤버로 구성 되며 Analysis ServicesAnalysis Services 단일 멤버에 대 한 여러 부모를 지원 하지 않습니다.With MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services, the set returned will always consist of a single member - Analysis ServicesAnalysis Services does not support multiple parents for a single member.

구문Syntax


Level syntax  
Ancestors(Member_Expression, Level_Expression)  

Numeric syntax  
Ancestors(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 Ancestors 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 that member or a numeric expression that represents the number of levels above that member. 이 정보는 상위 함수는 해당 수준의 멤버 (한 멤버의 구성 된 집합을 됩니다)의 집합을 반환 합니다.With this information, the Ancestors function returns the set of members (which will be a set consisting of one member) at that level.

참고

상위 집합을 사용 하는 것이 아니라 상위 멤버를 사용 하 여 반환 하는 상위 함수입니다.To return an ancestor member, rather than an ancestor set, use the Ancestor function.

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

거리를 지정 하는 경우는 상위 함수는 멤버 식으로 지정 된 계층에 지정 된 단계 수 만큼 위에 있는 모든 멤버 집합을 반환 합니다.If a distance is specified, the Ancestors function returns the set of all members that are 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 the set of members at the parent level and a number of 2 returns the set of members at the grandparent level (if one exists). 숫자 0은 멤버만 포함된 집합을 반환합니다.A number of 0 returns the set including only the member itself.

참고

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

Examples

다음 예제에서는 상위 멤버, 부모 및 최상위 항목에 대 한 Internet Sales Amount 측정값을 반환 하는 함수입니다.The following example uses the Ancestors function to return the Internet Sales Amount measure for a member, its parent, and its grandparent. 이 예에서는 수준 식을 사용하여 반환할 수준을 지정합니다.This example uses level expressions to specify the levels to be returned. 수준은 멤버 식에 지정된 멤버와 동일한 계층에 있습니다.The levels are in the same hierarchy as the member specified in the member expression.

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]  

다음 예제에서는 상위 멤버, 부모 및 최상위 항목에 대 한 Internet Sales Amount 측정값을 반환 하는 함수입니다.The following example uses the Ancestors function to return the Internet Sales Amount measure for a member, its parent, and its grandparent. 이 예에서는 숫자 식을 사용하여 반환할 수준을 지정합니다.This example uses numeric expressions to specify the levels being returned. 수준은 멤버 식에 지정된 멤버와 동일한 계층에 있습니다.The levels are in the same hierarchy as the member specified in the member expression.

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]  

다음 예제에서는 상위 특성 계층의 멤버의 부모에 대 한 Internet Sales Amount 측정값을 반환 하는 함수입니다.The following example uses the Ancestors function to return the Internet Sales Amount measure for the parent of a member of an attribute hierarchy. 이 예에서는 숫자 식을 사용하여 반환할 수준을 지정합니다.This example uses a numeric expression to specify the level being returned. 멤버 식의 멤버는 특성 계층의 멤버이므로 해당 부모는 [All] 수준입니다.Since the member in the member expression is a member of an attribute hierarchy, its parent is the [All] level.

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

관련 항목:See Also

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