StrToTuple (MDX)

Mis à jour : 17 juillet 2006

Retourne le tuple spécifié par une chaîne au format MDX (Multidimensional Expressions).

Syntaxe

StrToTuple(Tuple_Specification [,CONSTRAINED] ) 

Arguments

• Tuple_Specification
  Expression de chaîne valide qui spécifie, directement ou indirectement, un tuple.

Notes

La fonction StrToTuple retourne le jeu spécifié. La fonction StrToTuple est généralement utilisée avec des fonctions définies par l'utilisateur pour retourner un tuple spécifié d'une fonction externe vers une instruction MDX.

• En cas d'utilisation de l'indicateur CONSTRAINED, le tuple spécifié doit contenir des noms de membres qualifiés ou non qualifiés. Cet indicateur est employé pour réduire les risques d'attaques par injection au travers de la chaîne spécifiée. Si une chaîne qui ne peut être directement résolue à des noms de membres qualifiés ou non qualifiés est fournie, l'erreur suivante s'affiche : « Les restrictions imposées par l'indicateur CONSTRAINED dans la fonction STRTOTUPLE n'ont pas été respectées. »
• Si l'indicateur CONSTRAINED n'est pas utilisé, vous pouvez résoudre le tuple spécifié à une expression MDX valide qui retourne un tuple.

Exemples

L'exemple ci-dessous retourne la mesure Reseller Sales Amount (volume de vente du revendeur) du membre Bayern pour l'année civile 2004. Le tuple spécifié fourni contient une expression de tuple MDX valide.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004])')
ON 0
FROM [Adventure Works]

L'exemple ci-dessous retourne la mesure Reseller Sales Amount (volume de vente du revendeur) du membre Bayern pour l'année civile 2004. Le tuple spécifié fourni contient des noms de membres qualifiés, conformément aux exigences de l'indicateur CONSTRAINED.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004])', CONSTRAINED)
ON 0
FROM [Adventure Works]

L'exemple ci-dessous retourne la mesure Reseller Sales Amount (volume de vente du revendeur) du membre Bayern pour l'année civile 2004. Le tuple spécifié fourni contient une expression de tuple MDX valide.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)')
ON 0
FROM [Adventure Works]

L'exemple ci-dessous retourne une erreur liée à l'indicateur CONSTRAINED. Tandis que le tuple spécifié fournit une expression de tuple MDX valide, l'indicateur CONSTRAINED exige l'usage de noms de membres qualifiés ou non qualifiés dans le tuple spécifié.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)', CONSTRAINED)
ON 0
FROM [Adventure Works]

Voir aussi

Référence

Guide de référence des fonctions MDX (MDX)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications