Membro Atual (MDX)

Retorna o membro atual ao longo de uma hierarquia especificada durante a iteração.

Sintaxe

  
Hierarchy_Expression.CurrentMember  

Argumentos

Hierarchy_Expression
Uma expressão válida de Expressões Multidimensionais (MDX) que retorna uma hierarquia.

Remarks

Ao iterar por um conjunto de membros da hierarquia, em cada etapa da iteração, o membro em que está sendo operado é o membro atual. A função CurrentMember devolve esse membro.

Importante

Quando uma dimensão contém apenas uma única hierarquia visível, a hierarquia pode ser referida tanto pelo nome da dimensão quanto pelo nome da hierarquia, pois o nome da dimensão é resolvido para sua única hierarquia visível. Por exemplo, Measures.CurrentMember é uma expressão MDX válida porque ela resolve para a única hierarquia na dimensão Medidas.

Exemplos

A consulta a seguir mostra como o Currentmember pode ser usado para encontrar o membro atual a partir de hierarquias nas Colunas, Linhas e eixo de fatia:

WITH
  MEMBER MEASURES.CURRENTDATE AS [Date].[Calendar].CURRENTMEMBER.NAME
  MEMBER MEASURES.CURRENTPRODUCT AS [Product].[Product Categories].CURRENTMEMBER.NAME
  MEMBER MEASURES.CURRENTMEASURE AS MEASURES.CURRENTMEMBER.NAME
  MEMBER MEASURES.CURRENTCUSTOMER AS [Customer].[Customer Geography].CURRENTMEMBER.NAME
SELECT
 [Product].[Product Categories].[Category].MEMBERS *
 {MEASURES.CURRENTDATE,
    MEASURES.CURRENTPRODUCT,
    MEASURES.CURRENTMEASURE,
    MEASURES.CURRENTCUSTOMER} ON 0, 
 [Date].[Calendar].MEMBERS ON 1  
FROM [Adventure Works]
WHERE ([Customer].[Customer Geography].[Country].&[Australia])

O membro atual muda em uma hierarquia usada em um eixo em uma consulta. Portanto, o membro atual em outras hierarquias na mesma dimensão que não são usadas em um eixo também pode mudar; esse comportamento é chamado de 'auto-existe' e mais detalhes podem ser encontrados em Conceitos-Chave em MDX (Serviços de Análise). Por exemplo, a consulta abaixo mostra como o membro atual na hierarquia de Ano Civil da dimensão Data muda com o membro atual na hierarquia Calendário, quando este último é exibido no eixo Linhas:

WITH
  MEMBER MEASURES.CURRENTYEAR AS [Date].[Calendar Year].CURRENTMEMBER.NAME
SELECT
 {MEASURES.CURRENTYEAR} ON 0,
 [Date].[Calendar].MEMBERS ON 1  
FROM [Adventure Works]

O CurrentMember é muito importante para tornar os cálculos cientes do contexto da consulta em que estão sendo usados. O exemplo a seguir retorna a quantidade de pedido de cada produto e a porcentagem de quantidades de pedidos por categoria e modelo, do cubo Adventure Works . A função CurrentMember identifica o produto cuja quantidade de pedido deve ser usada durante o cálculo.

WITH   
   MEMBER [Measures].[Order Percent by Category] AS  
   CoalesceEmpty  
(   
      ([Product].[Product Categories].CurrentMember,  
        Measures.[Order Quantity]) /   
          (  
           Ancestor  
           ( [Product].[Product Categories].CurrentMember,   
             [Product].[Product Categories].[Category]  
           ), Measures.[Order Quantity]  
       ), 0  
   ), FORMAT_STRING='Percent'  
SELECT   
   {Measures.[Order Quantity],  
      [Measures].[Order Percent by Category]} ON COLUMNS,  
{[Product].[Product].Members} ON ROWS  
FROM [Adventure Works]  
WHERE {[Date].[Calendar Year].[Calendar Year].&[2003]}