Ancestors (MDX)

Uma função que retorna o conjunto de todos os ancestrais de um membro especificado em um nível especificado, ou à distância especificada, a partir do membro. Com o Analysis Services, o conjunto retornado sempre consistirá em um único membro – o Analysis Services não dá suporte a vários pais para um único membro.

Sintaxe

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

Argumentos

Member_expression
Uma linguagem MDX válida que retorna um membro.

Level_expression
Uma linguagem MDX válida que retorna um nível.

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

Comentários

Com a função Ancestrales , você fornece a função com uma expressão de membro MDX e, em seguida, fornece uma expressão MDX de um nível que é um ancestral desse membro ou uma expressão numérica que representa o número de níveis acima desse membro. Com essas informações, a função Ancestors retorna o conjunto de membros (que será um conjunto que consiste em um membro) nesse nível.

Observação

Para retornar um membro ancestral, em vez de um conjunto ancestral, use a função Ancestral .

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

Se uma distância for especificada, a função Ancestors retornará o conjunto de todos os membros que são o número de etapas especificadas na hierarquia especificada pela expressão membro. Um membro pode ser especificado como um 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 avô (se houver um). Um número 0 retorna o conjunto que inclui só o próprio membro.

Observação

Use essa forma da função Ancestors para casos em que o nível do pai é desconhecido ou não pode ser nomeado.

Exemplos

O exemplo a seguir usa a função Ancestrales para retornar a medida Valor de Vendas pela Internet para um membro, seu pai 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 que o membro especificado na expressão de 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 usa a função Ancestrales para retornar a medida Valor de Vendas pela Internet para um membro, seu pai e seu avô. Este exemplo usa expressões numéricas para especificar os níveis que são retornados. Os níveis estão na mesma hierarquia que o membro especificado na expressão de 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 Ancestors para retornar a medida Valor de Vendas pela 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 é retornado. Desde que o membro na expressão de membro seja um membro de uma hierarquia de atributo, seu pai é o nível [All].

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

Consulte Também

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