StrToSet (MDX)

更新 : 2006 年 7 月 17 日

多次元式 (MDX) 形式の文字列によって指定されているセットを返します。

構文

StrToSet(Set_Specification [,CONSTRAINED] )

StrToSet 関数は、指定されたセットを返します。通常、StrToSet 関数は、セットの指定を外部関数から 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]

リリース	履歴
2006 年 7 月 17 日	変更内容 : わかりやすくするために構文および引数を更新しました。更新した例を追加しました。