StrToSet (MDX)
多次元式 (MDX) 形式の文字列によって指定されているセットを返します。
構文
StrToSet(Set_Specification [,CONSTRAINED] )
引数
- Set_Specification
直接的または間接的にセットを指定する有効な文字列式です。
説明
StrToSet 関数は、文字列式で指定されたセットを返します。 通常、StrToSet 関数は、セットの指定を外部関数から MDX ステートメントに返す場合、または MDX クエリがパラメーター化される場合に、ユーザー定義関数と組み合わせて使用されます。
CONSTRAINED フラグを使用する場合、セットの指定には、修飾されているメンバー名か修飾されていないメンバー名を使用するか、修飾されているメンバー名か修飾されていないメンバー名を含む組のセットを中かっこ {} で囲んで使用する必要があります。 このフラグは、指定された文字列によるインジェクション攻撃の危険性を軽減するために使用します。 修飾されているメンバー名または修飾されていないメンバー名に直接解決できない文字列が指定されると、"STRTOSET 関数の CONSTRAINED フラグによって設定された制限に違反しました。" というエラーが表示されます。
CONSTRAINED フラグを使用しない場合、セットを返す有効な多次元式 (MDX) 式に解決されるセットの指定を指定できます。
セットとメンバーの違いについては、「セット式の使用」および「メンバー式の使用」を参照してください。
使用例
次の例では、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 メジャーを返しています。 セットの指定には、CONSTRAINED フラグによって必要とされる、修飾されたメンバー名が含まれています。
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]