Item (Tupla) (MDX)

Devolve uma tupla de um conjunto.

Syntax

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

Arguments

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

String_Expression1
Uma expressão de cadeia válida que é tipicamente uma tupla expressa numa cadeia.

String_Expression2
Uma expressão de cadeia válida que é tipicamente uma tupla expressa numa cadeia.

Índice
Uma expressão numérica válida que especifica a tupla específica por posição dentro do conjunto a ser devolvida.

Observações

A função Item devolve uma tupla do conjunto especificado. Existem três formas possíveis de chamar a função Item :

  • Se for especificada uma única expressão de string, a função Item devolve a tupla especificada. Por exemplo, "([2005]. P3, [Store05])".

  • Se for especificada mais do que uma expressão de string, a função Item devolve a tupla definida pelas coordenadas especificadas. O número de cadeias deve corresponder ao número de eixos, e cada cadeia deve identificar uma hierarquia única. Por exemplo, "[2005]. Q3", "[Store05]".

  • Se for especificado um inteiro, a função Item devolve a tuplo que está na posição baseada em zero especificada pelo Índice.

Examples

O seguinte exemplo retorna ([1996],Vendas):

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

O exemplo seguinte utiliza uma expressão de nível e devolve o Montante das Vendas na Internet para cada State-Province na Austrália e a sua percentagem do montante total das Vendas na Internet para a Austrália. Este exemplo usa a função Item para extrair a primeira (e única tupla) do conjunto devolvido 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]