StrToTuple （MDX）

傳回多維度運算式 （MDX） 格式字串所指定的 Tuple。

語法

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

引數

Tuple_Specification
直接或間接指定 Tuple 的有效字串運算式。

備註

StrToTuple 函式 會傳回指定的集合。 StrToTuple 函式通常與使用者定義的函式搭配使用，以將 Tuple 規格從外部函式傳回 MDX 語句。

• 使用 CONSTRAINED 旗標時，Tuple 規格必須包含限定或未限定的成員名稱。 此旗標可用來降低透過指定字串進行插入式攻擊的風險。 如果提供的字串無法直接解析為限定或未限定的成員名稱，則會出現下列錯誤：「違反 STRTOTUPLE 函式中 CONSTRAINED 旗標的限制。

• 未使用 CONSTRAINED 旗標時，指定的 Tuple 可以解析為傳回 Tuple 的有效 MDX 運算式。

範例

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

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

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

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 量值。 提供的 Tuple 規格包含有效的 MDX Tuple 運算式。

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

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

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

另請參閱

MDX 函數參考 （MDX）