多次元表現(MDX)フォーマットの文字列で指定されたタプルを返します。
構文
StrToTuple(Tuple_Specification [,CONSTRAINED] )
引数
Tuple_Specification
タプルを直接的または間接的に指定する有効な文字列式。
Remarks
StrToTuple関数は指定された集合を返します。 StrToTuple関数は通常、ユーザー定義関数と組み合わせて、外部関数からMDX文へのタプル仕様を返すために使用されます。
CONSTRAINDフラグを使用する場合、タプル仕様には限定または無条件のメンバー名を含める必要があります。 このフラグは指定された文字列による注入攻撃のリスクを減らすために使われます。 もし文字列が限定または無条件のメンバー名に直接解決できない場合、次のエラーが表示されます:「CONSTRAINDフラグによってSTRTTOTUPLE関数で課された制限が違反されました。」
CONSTRAINDフラグが使われない場合、指定されたタプルは有効なMDX式に解決され、タプルを返すことができます。
Examples
以下の例は、2004年のカレンダーイヤーにおけるバイエルン加盟国のリセラー販売額指標を返します。 提供されるタプル仕様には有効なMDXタプル式が含まれています。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
以下の例は、2004年のカレンダーイヤーにおけるバイエルン加盟国のリセラー販売額指標を返します。 提供されるタプル仕様には、CONSTRAINDフラグで求められる条件付きメンバー名が含まれています。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]
以下の例は、2004年のカレンダーイヤーにおけるバイエルン加盟国のリセラー販売額指標を返します。 提供されるタプル仕様には有効なMDXタプル式が含まれています。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
以下の例はCONSTRAINDフラグによるエラーを返します。 提供されたタプル仕様には有効なMDXタプル式が含まれていますが、CONSTRAINDフラグはタプル仕様に限定または非限定のメンバー名が必要です。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]