Ancestors (многомерные выражения)

Функция, возвращающая набор предков заданного элемента на заданном уровне или заданном расстоянии от элемента. При использовании служб Analysis Services возвращаемый набор всегда будет состоять из одного члена. Службы Analysis Services не поддерживают несколько родителей для одного члена.

Синтаксис

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

Аргументы

Member_Expression
Допустимое многомерное выражение, возвращающее элемент.

Level_Expression
Допустимое многомерное выражение, возвращающее уровень.

Расстояние
Допустимое числовое выражение, указывающее расстояние от заданного элемента.

Замечания

Функция "Предки" предоставляет функцию с выражением члена многомерных выражений, а затем предоставляет выражение многомерных выражений уровня, являющегося предком этого элемента или числовым выражением, которое представляет число уровней выше этого элемента. С этой информацией функция "Предки " возвращает набор элементов (который будет набором, состоящим из одного члена) на этом уровне.

Заметка

Чтобы вернуть член предка, а не набор предков, используйте функцию Предка .

Если задано выражение уровня, функция Предки возвращает набор всех предков указанного элемента на указанном уровне. Если заданный элемент не входит в ту же иерархию, что и заданный уровень, функция вернет ошибку.

Если задано расстояние, функция Предки возвращает набор всех элементов, которые являются числом шагов, указанных в иерархии, указанной выражением члена. Элемент может быть определен как элемент иерархии атрибута, пользовательской иерархии или при некоторых обстоятельствах иерархии типа «родители-потомки». Число 1 возвращает набор элементов на родительском уровне, а число 2 возвращает набор элементов на прародительском уровне (если такой существует). Число 0 вернет набор, включающий только сам элемент.

Заметка

Используйте эту форму функции "Предки" для случаев, когда уровень родительского объекта неизвестен или не может быть назван.

Примеры

В следующем примере функция "Предки" используется для возврата меры "Объем продаж в Интернете" для члена, его родителя и бабушки и дедушки. В этом примере используются выражения уровня для определения уровней, которые должны быть возвращены. Уровни находятся в той же иерархии, что и заданный элемент в выражении элемента.

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]  

В следующем примере функция "Предки" используется для возврата меры "Объем продаж в Интернете" для члена, его родителя и бабушки и дедушки. В этом примере используются числовые выражения для определения уровней, которые должны быть возвращены. Уровни находятся в той же иерархии, что и заданный элемент в выражении элемента.

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]  

В следующем примере функция "Предки" используется для возврата меры "Объем продаж в Интернете" для родительского элемента иерархии атрибутов. В этом пример используются числовые выражения для определения уровня, который должен быть возвращен. Поскольку элемент в выражении элемента является элементом иерархии атрибута, его родителем является уровень «Все».

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

См. также

Справочник по функции многомерных выражений (многомерные выражения)