StrToTuple (MDX)

多次元式 (MDX) 形式の文字列で指定されたタプルを返します。

構文

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

引数

Tuple_Specification
直接的または間接的に組を指定する有効な文字列式です。

解説

StrToTuple 関数は、指定したセットを返します。 StrToTuple 関数は、通常、外部関数から MDX ステートメントにタプル仕様を返すために、ユーザー定義関数と共に使用されます。

• CONSTRAINED フラグを使用するときは、組指定に修飾されているメンバー名または修飾されていないメンバー名を含める必要があります。 このフラグは、指定された文字列を介したインジェクション攻撃のリスクを軽減するために使用されます。 修飾メンバー名または非修飾メンバー名に対して直接解決できない文字列が指定されている場合、次のエラーが表示されます。"STRTOTUPLE 関数の CONSTRAINTED フラグによって課される制限に違反しました。

• CONSTRAINED フラグを使用しない場合、組を返す有効な MDX 式に解決される組を指定できます。

例

次の例では、2004 年のバイエルメンバーの Reseller Sales Amount メジャーを返します。 組の指定には、有効な MDX 組式が含まれています。

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')  
ON 0  
FROM [Adventure Works]  
  

次の例では、2004 年のバイエルメンバーの Reseller Sales Amount メジャーを返します。 提供されるタプル仕様には、CONSTRAINTED フラグで必要とされる修飾メンバー名が含まれています。

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  
  

次の例では、2004 年のバイエルメンバーの Reseller Sales Amount メジャーを返します。 組の指定には、有効な MDX 組式が含まれています。

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')  
ON 0  
FROM [Adventure Works]  
  

次の例では、CONSTRAINTED フラグが原因でエラーが返されます。 指定されたタプル仕様には有効な MDX タプル式が含まれていますが、CONSTRAINTED フラグには、タプル仕様で修飾されたメンバー名または非修飾メンバー名が必要です。

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  

参照

MDX 関数リファレンス (MDX)