Item (Tupla) (MDX)

Retorna uma tupla de um conjunto.

Sintaxe

  
Index syntax  
Set_Expression.Item(Index)  
  
String expression syntax  
Set_Expression.Item(String_Expression1 [ ,String_Expression2,...n])  

Argumentos

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

String_Expression1
Uma expressão de cadeia de caracteres válida que normalmente é uma tupla expressa em uma cadeia de caracteres.

String_Expression2
Uma expressão de cadeia de caracteres válida que normalmente é uma tupla expressa em uma cadeia de caracteres.

Index
Uma expressão numérica válida que especifica a tupla específica através da posição dentro do conjunto a ser retornado.

Comentários

A função Item retorna uma tupla do conjunto especificado. Há três maneiras possíveis de chamar a função Item :

• Se uma única expressão de cadeia de caracteres for especificada, a função Item retornará a tupla especificada. Por exemplo, “([2005] .Q3, [Store05])”.

• Se mais de uma expressão de cadeia de caracteres for especificada, a função Item retornará a tupla definida pelas coordenadas especificadas. O número de cadeias de caracteres deve corresponder ao número de eixos e cada cadeia de caracteres deve identificar uma hierarquia exclusiva. Por exemplo, “[2005].Q3”, “[Store05]”.

• Se um inteiro for especificado, a função Item retornará a tupla que está na posição de base zero especificada por Index.

Exemplos

O exemplo a seguir retorna ([1996],Vendas):

{([1996],Sales), ([1997],Sales), ([1998],Sales)}.Item(0)

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 seu percentual do Valor de Vendas pala Internet para a Austrália. Este exemplo usa a função Item para extrair a primeira (e somente tupla) do conjunto retornado pela função Ancestrales .

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)