StrToSet (MDX)

Gibt die durch eine Multidimensional Expressions (MDX)-formatierte Zeichenkette spezifizierte Menge zurück.

Syntax

  
StrToSet(Set_Specification [,CONSTRAINED] )   

Argumente

Set_Specification
Ein gültiger String-Ausdruck, der direkt oder indirekt eine Menge angibt.

Bemerkungen

Die StrToSet-Funktion gibt die im String-Ausdruck angegebene Menge zurück. Die StrToSet-Funktion wird typischerweise zusammen mit benutzerdefinierten Funktionen verwendet, um eine Set-Spezifikation von einer externen Funktion zurück zu einer MDX-Anweisung zurückzugeben oder wenn eine MDX-Abfrage parametrisiert wird.

  • Wenn die CONSTRAINED Flagge verwendet wird, muss die Set-Spezifikation qualifizierte oder nicht qualifizierte Mitgliedernamen oder eine Reihe von Tupeln enthalten, die qualifizierte oder nicht qualifizierte Mitgliedernamen enthalten, die von Klammern {}umgeben sind. Dieses Flag wird verwendet, um das Risiko von Injektionsangriffen über die angegebene Zeichenkette zu verringern. Wird ein String angegeben, der nicht direkt auf qualifizierte oder unqualifizierte Mitgliedernamen auflösbar ist, erscheint folgender Fehler: "Die durch das CONSTRAINED Flag in der STRTOSET-Funktion auferlegten Einschränkungen wurden verletzt."

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

  • Um die Unterschiede zwischen Mengen und Elementen besser zu verstehen, siehe Using Set Expressions and Using Member Expressions.

Beispiele

Das folgende Beispiel gibt die Menge der Mitglieder der State-Province Attributhierarchie mit der StrToSet-Funktion zurück. Die Mengenspezifikation liefert einen gültigen MDX-Mengenausdruck.

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

Das folgende Beispiel liefert einen Fehler aufgrund des CONSTRAINED Flags. Während die Set-Spezifikation einen gültigen MDX-Set-Ausdruck liefert, erfordert das CONSTRAINED Flag qualifizierte oder unqualifizierte Mitgliedernamen in der Set-Spezifikation.

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

Das folgende Beispiel liefert das Maß Wiederverkäuferumsatzbetrag für Deutschland und Kanada zurück. Die in der angegebenen Zeichenkette bereitgestellte Set-Spezifikation enthält qualifizierte Mitgliedernamen, wie es vom CONSTRAINED Flag gefordert wird.

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