StrToSet (MDX)

  • Artikel

Gibt den Satz zurück, der durch eine MDX-formatierte Zeichenfolge (Multidimensional Expressions) angegeben wurde.

Syntax

  
StrToSet(Set_Specification [,CONSTRAINED] )

Argumente

Set_Specification
Ein gültiger Zeichenfolgenausdruck, der direkt oder indirekt eine Menge angibt.

Bemerkungen

Die StrToSet-Funktion gibt den im Zeichenfolgenausdruck angegebenen Satz zurück. Die StrToSet-Funktion wird in der Regel mit benutzerdefinierten Funktionen verwendet, um eine Satzspezifikation von einer externen Funktion zurück an eine MDX-Anweisung zurückzugeben, oder wenn eine MDX-Abfrage parametrisiert wird.

  • Wenn das CONSTRAINED-Flag verwendet wird, muss die Setspezifikation qualifizierte oder nicht qualifizierte Membernamen oder eine Reihe von Tupeln enthalten, die qualifizierte oder nicht qualifizierte Membernamen enthalten, die von Klammern {}eingeschlossen sind. Dieses Flag wird verwendet, um das Risiko von Einschleusungsangriffen über die angegebene Zeichenfolge zu verringern. Wenn eine Zeichenfolge bereitgestellt wird, die nicht direkt zu qualifizierten oder nicht qualifizierten Elementnamen aufgelöst werden kann, wird eine Fehlermeldung angezeigt, die besagt, dass die durch das CONSTRAINED-Flag in der STRTOSET-Funktion vorgegebenen Einschränkungen verletzt wurden.

  • Wenn das CONSTRAINED-Flag nicht verwendet wird, kann der angegebene Mengenausdruck zu einem gültigen MDX-Ausdruck (Multidimensional Expressions) aufgelöst werden, der eine Menge zurückgibt.

  • Weitere Informationen zu den Unterschieden zwischen Mengen und Elementen finden Sie in den Abschnitten "Verwenden von Mengenausdrücken" und "Verwenden von Elementausdrücken".

Beispiele

Im folgenden Beispiel wird der Satz von Elementen der State-Province Attributhierarchie mithilfe der StrToSet-Funktion zurückgegeben. Die Mengenspezifikation stellt einen gültigen MDX-Mengenausdruck bereit.

SELECT StrToSet ('[Geography].[State-Province].Members')  
ON 0  
FROM [Adventure Works]

Im folgenden Beispiel wird aufgrund des CONSTRAINED-Flags ein Fehler zurückgegeben. Die Mengenspezifikation stellt zwar einen gültigen MDX-Mengenausdruck bereit, das CONSTRAINED-Flag erfordert jedoch qualifizierte oder nicht qualifizierte Elementnamen in der Mengenspezifikation.

SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)  
ON 0  
FROM [Adventure Works]

Im folgenden Beispiel wird das Measure "Reseller Sales Amount" für Deutschland und Kanada zurückgegeben. Die in der angegebenen Zeichenfolge bereitgestellte Mengenspezifikation enthält qualifizierte Elementnamen, wie vom CONSTRAINED-Flag angefordert.

SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)  
ON 0  
FROM [Adventure Works]

Weitere Informationen

MDX-Funktionsreferenz (MDX)