StrToTuple (MDX)

更新： 2006 年 7 月 17 日

傳回由多維度運算式 (MDX) 指定的 Tuple–格式化字串。

語法

StrToTuple(Tuple_Specification [,CONSTRAINED] )

StrToTuple 函數會傳回指定的集合。StrToTuple 函數一般會搭配使用者自訂函數使用，將來自外部函數的 Tuple 規格傳回至 MDX 陳述式。

使用 CONSTRAINED 旗標時，Tuple 規格必須包含限定或未限定成員名稱。這個旗標用於降低遭到由指定字串發動資料隱碼攻擊的風險。如果所提供的字串不能直接解析成限定或未限定成員名稱，會出現下列錯誤：「違反了 STRTOTUPLE 函數中 CONSTRAINED 旗標所加諸的限制。」
沒有使用 CONSTRAINED 旗標時，指定的 Tuple 會解析成傳回 Tuple 的有效 MDX 運算式。

下列範例會傳回 2004 日曆年 Bayern 成員的 Reseller Sales Amount 量值。所提供的 Tuple 規格包含有效的 MDX Tuple 運算式。

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

下列範例會傳回 2004 日曆年 Bayern 成員的 Reseller Sales Amount 量值。所提供的 Tuple 規格包含 CONSTRAINED 旗標所需的限定成員名稱。

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

下列範例會傳回 2004 日曆年 Bayern 成員的 Reseller Sales Amount 量值。所提供的 Tuple 規格包含有效的 MDX Tuple 運算式。

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

下列範例傳回因為 CONSTRAINED 旗標而發生的錯誤。雖然所提供的 Tuple 規格包含有效 MDX Tuple 運算式，但 CONSTRAINED 旗標要求 Tuple 規格中包含限定或未限定成員名稱。

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

版本	歷程記錄
2006 年 7 月 17 日	變更的內容：更新了語法及引數，以便更加清楚地表示。新增更新的範例。