Descendants (MDX)

Retorna o conjunto de descendentes de um membro em uma distância ou nível especificado, incluindo ou excluindo, opcionalmente, descendentes em outros níveis.

Sintaxe

  
Member expression syntax using a level expression  
Descendants(Member_Expression [ , Level_Expression [ ,Desc_Flag ] ] )  
  
Member expression syntax using a numeric expression  
Descendants(Member_Expression [ , Distance [ ,Desc_Flag ] ] )  
  
Set expression syntax using a level expression  
Descendants(Set_Expression [ , Level_Expression [ ,Desc_Flag ] ] )  
  
Member expression syntax using a numeric expression  
Descendants(Set_Expression [ , Distance [ ,Desc_Flag ] ] )  
  

Argumentos

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

Set_Expression
Uma expressão MDX válida que retorna um conjunto.

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.

Desc_Flag
Uma expressão de cadeia de caracteres válida que especifica um sinalizador de descrição que distingue entre possíveis conjuntos de descendentes.

Comentários

Se um nível for especificado, a função Descendentes retornará um conjunto que contém os descendentes do membro especificado ou os membros do conjunto especificado, em um nível especificado, opcionalmente modificado por um sinalizador especificado em Desc_Flag.

Se Distance for especificado, a função Descendentes retornará um conjunto que contém os descendentes do membro especificado ou os membros do conjunto especificado que são o número especificado de níveis de distância na hierarquia do membro especificado, opcionalmente modificado por um sinalizador especificado em Desc_Flag. Normalmente, você usa esta função com o argumento Distance para lidar com hierarquias com rotas. Se a distância especificada for zero (0), a função retornará um conjunto composto apenas pelo membro especificado ou pelo conjunto especificado.

Se uma expressão de conjunto for especificada, a função Descendentes será resolvida individualmente para cada membro do conjunto e o conjunto será criado novamente. Em outras palavras, a sintaxe usada para a função Descendentes é funcionalmente equivalente à função MDX Generate .

Se nenhum nível ou distância for especificado, o valor padrão para o nível usado pela função será determinado chamando a função Level (<<Member>>. Nível) para o membro especificado (se um membro for especificado) ou chamando a função Level para cada membro do conjunto especificado (se um conjunto for especificado). Se nenhuma expressão de nível, distância ou sinalizadores forem especificados, a função será executada como se a sintaxe seguinte fosse usada:

Descendants

(

Member_Expression ,

Member_Expression.Level ,

SELF_BEFORE_AFTER

)

Se um nível for especificado e um sinalizador de descrição não for, a função será executada como se a sintaxe seguinte fosse usada.

Descendants

(

Member_Expression ,

Level_Expression,

SELF

)

Alterando o valor do sinalizador de descrição, você pode incluir ou excluir descendentes no nível ou na distância especificada, o filho antes ou depois de um nível ou distância especificada (até o nó folha), e a folha filha, independentemente do nível ou da distância especificada. A tabela a seguir descreve os sinalizadores permitidos no argumento Desc_Flag .

Exemplos

O exemplo a seguir retorna o membro especificado (Estados Unidos) e os membros entre o membro especificado (Estados Unidos) e os membros do nível anterior ao nível especificado (Cidade). O exemplo retorna o próprio membro especificado (Estados Unidos) e os membros do nível Estado-Província (o nível antes do nível Cidade). Esse exemplo inclui argumentos comentados para permitir que você teste outros argumentos facilmente para essa função.

SELECT Descendants  
   ([Geography].[Geography].[Country].&[United States]  
      //, [Geography].[Geography].[Country]  
   , [Geography].[Geography].[City]  
      //, [Geography].[Geography].Levels (3)  
      //, SELF   
      //, AFTER  
      , BEFORE  
      // BEFORE_AND_AFTER  
      //, SELF_AND_AFTER  
      //, SELF_AND_BEFORE  
      //,SELF_BEFORE_AFTER  
      //,LEAVES   
   ) ON 0  
FROM [Adventure Works]   

O exemplo a seguir retorna a média diária da Measures.[Gross Profit Margin] medida, calculada ao longo dos dias de cada mês no ano fiscal de 2003, do cubo Adventure Works . A função Descendentes retorna um conjunto de dias determinado do membro atual da [Date].[Fiscal] hierarquia.

WITH MEMBER Measures.[Avg Gross Profit Margin] AS Avg  
   (  
      Descendants( [Date].[Fiscal].CurrentMember,   
           [Date].[Fiscal].[Date]  
          ),   
        Measures.[Gross Profit Margin]  
   )  
SELECT  
   Measures.[Avg Gross Profit Margin] ON COLUMNS,  
   [Date].[Fiscal].[Month].Members ON ROWS  
FROM [Adventure Works]  
WHERE ([Date].[Fiscal Year].&[2003])  

O exemplo a seguir usa uma expressão de nível e retorna o Valor de Vendas pela Internet para cada Estado-Província da Austrália, e retorna a porcentagem do total do Valor de Vendas pala Internet para a Austrália para cada Estado-Província. Este exemplo usa a função Item para extrair a primeira tupla (e somente) do conjunto retornado pela função Ancestors .

WITH MEMBER Measures.x AS   
   [Measures].[Internet Sales Amount] /   
   ( [Measures].[Internet Sales Amount],  
      Ancestors   
         ( [Customer].[Customer Geography].CurrentMember,   
           [Customer].[Customer Geography].[Country]  
         ).Item (0)  
   ), FORMAT_STRING = '0%'  
SELECT {[Measures].[Internet Sales Amount], Measures.x} ON 0,  
{Descendants   
   ( [Customer].[Customer Geography].[Country].&[Australia],   
     [Customer].[Customer Geography].[State-Province], SELF   
   )    
} ON 1  
FROM [Adventure Works]  
  

Consulte Também

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