StrToTuple (MDX)

更新日期: 2006 年 7 月 17 日

返回由多维表达式 (MDX) 格式的字符串指定的元组。

语法

StrToTuple(Tuple_Specification [,CONSTRAINED] ) 

参数

  • Tuple_Specification
    直接或间接指定元组的有效字符串表达式。

备注

StrToTuple 函数返回指定的集。StrToTuple 函数通常与用户定义函数一起使用,以将外部函数中的元组规范返回到 MDX 语句。

  • 如果使用 CONSTRAINED 标志,则元组规范必须包含限定或未限定的成员名称。此标志通过指定字符串可降低注入攻击的风险。如果所提供的字符串无法直接解析为限定或未限定的成员名称,将出现以下错误:“违反了 STRTOTUPLE 函数中 CONSTRAINED 标志所规定的限制。”
  • 如果未使用 CONSTRAINED 标志,则指定的元组可以解析为有效的 MDX 表达式以返回元组。

示例

下面的示例返回 2004 日历年 Bayern 成员的 Reseller Sales Amount 度量值。所提供的元组规范包含有效的 MDX 元组表达式。

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

下面的示例返回 2004 日历年 Bayern 成员的 Reseller Sales Amount 度量值。所提供的元组规范包含 CONSTRAINED 标志要求的限定的成员名称。

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

下面的示例返回 2004 日历年 Bayern 成员的 Reseller Sales Amount 度量值。所提供的元组规范包含有效的 MDX 元组表达式。

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)')
ON 0
FROM [Adventure Works]

下面的示例返回因 CONSTRAINED 标志而引起的错误。虽然所提供的元组规范包含有效的 MDX 元组表达式,但是 CONSTRAINED 标志要求元组规范包含限定或未限定的成员名称。

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)', CONSTRAINED)
ON 0
FROM [Adventure Works]

请参阅

参考

MDX 函数参考 (MDX)

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

2006 年 7 月 17 日

更改的内容:
  • 更新了语法和参数,以使表述更加清晰。
  • 添加了更新的示例。