Antepassados (MDX)

Uma função que devolve o conjunto de todos os antepassados de um membro especificado a um nível especificado ou a uma distância determinada do membro. Com os Serviços de Análise, o conjunto devolvido será sempre composto por um único membro – os Serviços de Análise não suportam múltiplos pais para um único membro.

Syntax

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

Arguments

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

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

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

Observações

Com a função Ancestors , fornece à função uma expressão de membro MDX e depois fornece ou uma expressão MDX de um nível que é antepassado desse membro ou uma expressão numérica que representa o número de níveis acima desse membro. Com esta informação, a função Ancestors devolve o conjunto de membros (que será um conjunto composto por um elemento) nesse nível.

Note

Para devolver 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 devolve o conjunto de todos os antepassados 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 devolve um erro.

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

Note

Utilize esta forma da função dos Antepassados para casos em que o nível do progenitor é desconhecido ou não pode ser nomeado.

Examples

O exemplo seguinte utiliza a função Ancestrais para devolver a medida do Valor das Vendas na Internet para um membro, o seu progenitor e o seu avô. Este exemplo utiliza expressões de nível para especificar os níveis a devolver. 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 seguinte utiliza a função Ancestrais para devolver a medida do Valor das Vendas na Internet para um membro, o seu progenitor e o seu avô. Este exemplo utiliza expressões numéricas para especificar os níveis que estão a ser devolvidos. 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 seguinte utiliza a função Ancestors para devolver a medida do Valor das Vendas na Internet para o pai de um membro de uma hierarquia de atributos. Este exemplo utiliza uma expressão numérica para especificar o nível a ser devolvido. Como o membro na expressão membro pertence a uma hierarquia de atributos, o 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

  • Last updated on