StrToSet (MDX)
Retourne le jeu spécifié par une chaîne au format MDX (Multidimensional Expressions).
Syntaxe
StrToSet(Set_Specification [,CONSTRAINED] )
Arguments
Set_Specification
Expression de chaîne valide spécifiant, directement ou indirectement, un jeu.
Remarques
La fonction StrToSet retourne le jeu spécifié dans l’expression de chaîne. La fonction StrToSet est généralement utilisée avec les fonctions définies par l’utilisateur pour renvoyer une spécification d’ensemble d’une fonction externe à une instruction MDX, ou lorsqu’une requête MDX est paramétrée.
Lorsque l’indicateur CONTRAINTE est utilisé, la spécification de l’ensemble doit contenir des noms de membres qualifiés ou non qualifiés ou un ensemble de tuples contenant des noms de membres qualifiés ou non qualifiés entourés {}d’accolades . 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 : restrictions imposées par l'indicateur CONSTRAINED dans la fonction STRTOSET n'ont pas été respectées. »
Si l'indicateur CONSTRAINED n'est pas utilisé, vous pouvez résoudre le jeu spécifié à une expression MDX (Multidimensional Expressions) valide qui retourne un jeu.
Pour mieux comprendre les différences entre jeux et membres, consultez Utilisation d'expressions de jeu et Utilisation d'expressions de membre.
Exemples
L’exemple suivant retourne l’ensemble des membres de la hiérarchie d’attributs State-Province à l’aide de la fonction StrToSet . La spécification set fournit une expression de jeu MDX valide.
SELECT StrToSet ('[Geography].[State-Province].Members')
ON 0
FROM [Adventure Works]
L'exemple ci-dessous retourne une erreur liée à l'indicateur CONSTRAINED. Tandis que le jeu spécifié fournit une expression d'ensemble MDX valide, l'indicateur CONSTRAINED exige l'usage de noms de membres qualifiés ou non qualifiés dans le jeu spécifié.
SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)
ON 0
FROM [Adventure Works]
L’exemple suivant retourne la mesure Reseller Sales Amount pour l’Allemagne et le Canada. Le jeu spécifié fourni dans la chaîne spécifiée contient des noms de membres qualifiés, conformément aux exigences de l'indicateur CONSTRAINED.
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]