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 linguagem MDX 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 número inteiro for especificado, a função Item retornará a tupla que está na posição baseada em 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 da Internet para cada Estado da Austrália e seu percentual do Valor de Vendas da Internet para a Austrália. Esse exemplo usa a função Item para extrair a primeira (e única) tupla 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]