• Article

Item (Tuple) (MDX)

Retourne un tuple d'un jeu.

Syntaxe

Index syntax
Set_Expression.Item(Index)

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

Arguments

  • Set_Expression
    Expression MDX (Multidimensional Expressions) valide qui retourne un jeu.

  • String_Expression1
    Expression de chaîne valide qui correspond généralement à un tuple exprimé dans une chaîne.

  • String_Expression2
    Expression de chaîne valide qui correspond généralement à un tuple exprimé dans une chaîne.

  • Index
    Expression numérique valide qui précise le tuple spécifique par position dans le jeu à retourner.

Notes

La fonction Item retourne un tuple du jeu spécifié. La fonction Item peut être appelée de trois manières différentes :

  • Si une expression de chaîne unique est spécifiée, la fonction Item retourne le tuple spécifié. Par exemple, « ([2005].Q3, [Store05]) ».

  • Si plusieurs expressions de chaîne sont spécifiées, la fonction Item retourne le tuple défini par les coordonnées spécifiées. Le nombre de chaînes doit correspondre au nombre d'axes, et chaque chaîne doit identifier une hiérarchie unique. Par exemple, « [2005].Q3 », « [Store05] ».

  • Si un entier est spécifié, la fonction Item retourne le tuple situé dans la position de base zéro spécifiée par Index.

Exemples

L'exemple ci-dessous retourne ([1996],Sales) :

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

L'exemple suivant utilise une expression de niveau et retourne la mesure Internet Sales Amount (volume de vente Internet) pour chaque State-Province (état-Province) en Australie ; il dévoile également le pourcentage de volume de vente Internet total pour l'Australie. L'exemple utilise la fonction Item pour extraire le premier (et unique) tuple du jeu que retourne la fonction 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]