返回由多维表达式（MDX）格式字符串指定的元组。
Syntax
StrToTuple(Tuple_Specification [,CONSTRAINED] )
Arguments
Tuple_Specification
一个有效的字符串表达式，直接或间接指定一个元组。
Remarks
StrToTuple函数返回指定的集合。 StrToTuple函数通常与用户自定义函数一起使用，用于返回外部函数的元组规范，返回MDX语句。
当使用受限标志时，元组规范必须包含合格或不限定的成员名称。 该标志用于降低通过指定字符串发生注入攻击的风险。 如果提供的字符串无法直接解析到合格或不限定成员名，则会出现以下错误：“CONSTRAINED 标志在 STRTTOUPLE 函数中施加的限制已被违反。”
当未使用CONSTRAIND标志时，指定的元组可以解析为有效的MDX表达式返回元组。
示例
以下示例返回了2004年日历年度巴伐利亚成员的经销商销售金额度量。 所提供的元组规范包含一个有效的MDX元组表达式。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
以下示例返回了2004年日历年度巴伐利亚成员的经销商销售金额度量。 所提供的元组规范包含符合 CONSTRAINED 标志要求的合格成员名称。
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元组表达式，但CONSTRAINED flag要求元组规范中包含合格或不限定的成员名称。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]