Ancestrais (MDX)

Uma função que retorna o conjunto de todos os ancestrais de um membro especificado em um nível especificado ou a uma distância determinada do membro. Com o Analysis Services, o conjunto retornado sempre consistirá em um único membro – o Analysis Services não suporta múltiplos pais para um único membro.

Sintaxe

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

Argumentos

Member_Expression
Uma expressão MDX (Expressões Multidimensionais) válida que retorna um membro.

Level_Expression
Uma expressão válida de Expressões Multidimensionais (MDX) que retorna um nível.

Distância
Uma expressão numérica válida que especifica a distância do membro especificado.

Remarks

Com a função Ancestors , você fornece à função uma expressão de membro MDX e então fornece uma expressão MDX de um nível que é ancestral desse membro ou uma expressão numérica que representa o número de níveis acima desse membro. Com essa informação, a função Ancestrais retorna o conjunto de membros (que será um conjunto composto por um membro) nesse nível.

Se uma expressão de nível for especificada, a função Ancestors retorna o conjunto de todos os ancestrais do membro especificado no nível especificado. Se o membro especificado não estiver dentro da mesma hierarquia do nível especificado, a função retorna um erro.

Se uma distância for especificada, a função Ancestrais retorna o conjunto de todos os membros que correspondem ao número de passos especificados na hierarquia especificada pela expressão dos membros. Um membro pode ser especificado como membro de uma hierarquia de atributos, uma hierarquia definida pelo usuário ou, em alguns casos, uma hierarquia pai-filho. Um número 1 retorna o conjunto de membros no nível pai e um número 2 retorna o conjunto de membros no nível dos avós (se existir). Um número 0 retorna o conjunto incluindo apenas o próprio membro.

Exemplos

O exemplo a seguir utiliza a função Ancestrais para retornar a medida de Valor de Vendas na Internet para um membro, seu pai ou mãe e seu avô. Este exemplo usa expressões de nível para especificar os níveis a serem retornados. Os níveis estão na mesma hierarquia do membro especificado na expressão do membro.

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]  

O exemplo a seguir utiliza a função Ancestrais para retornar a medida de Valor de Vendas na Internet para um membro, seu pai ou mãe e seu avô. Este exemplo usa expressões numéricas para especificar os níveis retornados. Os níveis estão na mesma hierarquia do membro especificado na expressão do membro.

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]  

O exemplo a seguir usa a função Ancestrais para retornar a medida de Valor de Vendas na Internet para o pai de um membro de uma hierarquia de atributos. Este exemplo usa uma expressão numérica para especificar o nível que será retornado. Como o membro na expressão do membro é um membro de uma hierarquia de atributos, seu pai é o nível [Todos].

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

Conteúdo relacionado

• Referência de função MDX (MDX)