StrToSet (MDX)
多次元式 (MDX) 形式の文字列で指定されたセットを返します。
構文
StrToSet(Set_Specification [,CONSTRAINED] )
引数
Set_Specification
直接的または間接的にセットを指定する有効な文字列式です。
解説
StrToSet 関数は、文字列式で指定されたセットを返します。 StrToSet 関数は、通常、ユーザー定義関数と共に使用され、外部関数から MDX ステートメントに戻されるセット仕様、または MDX クエリがパラメーター化されるときに返されます。
CONSTRAINED フラグを使用する場合、セット仕様には、修飾メンバー名または非修飾メンバー名、または中かっこ {}で囲まれた修飾メンバー名または非修飾メンバー名を含むタプルのセットが含まれている必要があります。 このフラグは、指定された文字列を介したインジェクション攻撃のリスクを軽減するために使用されます。 修飾されているメンバー名または修飾されていないメンバー名に直接解決できない文字列が指定されると、"STRTOSET 関数の CONSTRAINED フラグによって設定された制限に違反しました。" というエラーが表示されます。
CONSTRAINED フラグを使用しない場合、セットを返す有効な多次元式 (MDX) 式に解決されるセットの指定を指定できます。
セットとメンバーの違いをより深く理解するには、「Set Expressions の使用」と「メンバー式の使用」を参照してください。
例
次の例では、 StrToSet 関数を使用して、State-Province属性階層のメンバーのセットを返します。 セット仕様では、有効な MDX セット式が提供されます。
SELECT StrToSet ('[Geography].[State-Province].Members')
ON 0
FROM [Adventure Works]
次の例では、CONSTRAINED フラグが原因でエラーが返されます。 セットの指定には有効な MDX セット式が指定されていますが、CONSTRAINED フラグを使用する場合は、セットの指定に修飾されたメンバー名または修飾されていないメンバー名を含める必要があります。
SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)
ON 0
FROM [Adventure Works]
次の例では、ドイツとカナダの Reseller Sales Amount メジャーを返します。 指定された文字列に指定された set 仕様には、CONSTRAINED フラグで必要とされる修飾メンバー名が含まれています。
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]