StrToTuple (MDX)

Vrátí n-tici specifikovanou řetězcem ve formátu Multidimensional Expressions (MDX).

Syntax

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Arguments

Tuple_Specification
Platný řetězcový výraz, který přímo či nepřímo specifikuje n-tici.

Remarks

Funkce StrToTuple vrací zadanou množinu. Funkce StrToTuple se obvykle používá s uživatelsky definovanými funkcemi k vrácení specifikace n-tice z externí funkce zpět do příkazu MDX.

  • Když je použit příznak CONSTRAINED, specifikace n-tice musí obsahovat kvalifikovaná nebo nekvalifikovaná jména členů. Tento příznak se používá ke snížení rizika injekčních útoků přes specifikovaný řetězec. Pokud je zadán řetězec, který není přímo řešitelný pro kvalifikovaná nebo nekvalifikovaná jména členů, objeví se následující chyba: "Omezení uložená příznakem CONSTRAINED ve funkci STRTOTUPLE byla porušena."

  • Pokud není použit příznak CONSTRAINED, specifikovaná n-tice může vyřešit na platný MDX výraz, který vrátí n-tici.

Examples

Následující příklad vrací ukazatel Reseller Sales Amount pro člena Bayernu za kalendářní rok 2004. Specifikace n-tic, která je poskytována, obsahuje platný MDX n-ticový výraz.

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

Následující příklad vrací ukazatel Reseller Sales Amount pro člena Bayernu za kalendářní rok 2004. Specifikace n-tice, která je poskytována, obsahuje kvalifikovaná jména členů, jak vyžaduje příznak CONSTRAINED.

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

Následující příklad vrací ukazatel Reseller Sales Amount pro člena Bayernu za kalendářní rok 2004. Specifikace n-tic, která je poskytována, obsahuje platný MDX n-ticový výraz.

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

Následující příklad vrací chybu způsobenou příznakem CONSTRAINED. Zatímco specifikace n-tice obsahuje platný MDX výraz n-tice, příznak CONSTRAINED vyžaduje kvalifikovaná nebo nekvalifikovaná jména členů ve specifikaci n-tice.

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