• Article

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.

Notes

La fonction StrToSet retourne le jeu spécifié dans l'expression de chaîne. La fonction StrToSet est généralement utilisée avec des fonctions définies par l'utilisateur pour retourner un jeu spécifié d'une fonction externe vers une instruction MDX, ou lorsqu'une requête MDX est paramétrée.

  • En cas d'utilisation de l'indicateur CONSTRAINED, le jeu spécifié doit contenir des noms de membres qualifiés ou non qualifiés ou un jeu de tuples renfermant des noms de membres qualifiés ou non qualifiés entre 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 : « Les 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 ci-dessous retourne le jeu des membres de la hiérarchie d'attribut State-Province (état-province) à l'aide de la fonction StrToSet. Une expression d'ensemble MDX valide est fournie par le jeu spécifié.

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 ci-après retourne la mesure Reseller Sales Amount (montant des ventes du revendeur) 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]