共用方式為


上階 (MDX)

函式,傳回指定層級上指定成員的所有上階集合,或從成員的指定距離傳回。 使用 Analysis Services 時,傳回的集合一律會包含單一成員 - Analysis Services 不支援單一成員的多個父系。

語法

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

引數

Member_Expression
傳回成員的有效多維度運算式 (MDX) 運算式。

Level_Expression
傳回層級的有效多維度運算式 (MDX) 運算式。

距離
有效的數值運算式,指定與指定成員的距離。

備註

使用上階函 式時,您會提供具有 MDX 成員運算式的函式,然後提供該成員上階層級的 MDX 運算式,或代表該成員上方層級數目的數值運算式。 利用這項資訊, 上階函 式會傳回該層級的成員集(也就是由一個成員組成的集合)。

注意

若要傳回上階成員,而不是上階集合,請使用 上階 函式。

如果指定了層級運算式, 則 Ancestors 函 式會傳回指定層級上指定成員的所有上階集合。 如果指定的成員不在與指定層級相同的階層內,函式會傳回錯誤。

如果指定距離, 則 Ancestors 函 式會傳回成員運算式所指定階層中所指定步驟數目的所有成員集合。 成員可以指定為屬性階層的成員、使用者定義的階層,或在某些情況下,指定父子式階層。 數位 1 會傳回父層級的成員集,而數位 2 會傳回祖父母層級的成員集合(如果有的話)。 數位 0 會傳回集合,只包含成員本身。

注意

針對父系層級未知或無法命名的情況,請使用這個形式的 上階函 式。

範例

下列範例會使用 上階函 式傳回成員、其父系和祖父母的 Internet Sales Amount 量值。 此範例會使用層級運算式來指定要傳回的層級。 層級與成員運算式中指定的成員位於相同的階層中。

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 量值。 這個範例會使用數值運算式來指定所傳回的層級。 層級與成員運算式中指定的成員位於相同的階層中。

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 量值。 這個範例會使用數值運算式來指定所傳回的層級。 由於成員運算式中的成員是屬性階層的成員,因此其父系是 [All] 層級。

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

另請參閱

MDX 函數參考 (MDX)