StrToSet (MDX)
Gibt die durch eine Zeichenfolge im MDX-Format (Multidimensional Expressions) angegebene Menge zurück.
Syntax
StrToSet(Set_Specification [,CONSTRAINED] )
Argumente
- Set_Specification
Ein gültiger Zeichenfolgenausdruck, der direkt oder indirekt eine Menge angibt.
Hinweise
Die StrToSet-Funktion gibt den im Zeichenfolgenausdruck angegebenen Satz zurück. Die StrToSet-Funktion wird in der Regel zusammen mit benutzerdefinierten Funktionen verwendet, um eine Mengenspezifikation aus einer externen Funktion an eine MDX-Anweisung zurückzugeben, oder wenn eine MDX-Abfrage parametrisiert wird.
Wenn das CONSTRAINED-Flag verwendet wird, muss die Mengenspezifikation qualifizierte oder nicht qualifizierte Elementnamen enthalten oder eine Menge von Tupeln, die qualifizierte oder nicht qualifizierte Elementnamen in geschweiften Klammern {} enthalten. Das CONSTRAINED-Flag wird verwendet, um das Risiko von Injection-Angriffen über die angegebene Zeichenfolge zu minimieren. 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 die Menge der Elemente 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 Reseller Sales Amount-Measure für die Country-Elemente Germany und Canada 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]