StrToTuple (MDX)

Returnerar den tupel som specificeras av en Multidimensional Expressions (MDX)-formaterad sträng.

Syntax

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Arguments

Tuple_Specification
Ett giltigt stränguttryck som specificerar, direkt eller indirekt, en tuple.

Remarks

StrToTuple-funktionen returnerar den specificerade mängden. Funktionen StrToTuple används vanligtvis tillsammans med användardefinierade funktioner för att returnera en tuplespecifikation från en extern funktion tillbaka till en MDX-sats.

  • När CONSTRAINED flaggan används måste tuplespecifikationen innehålla kvalificerade eller okvalificerade medlemsnamn. Denna flagga används för att minska risken för injektionsattacker via den angivna strängen. Om en sträng anges som inte kan lösas direkt till kvalificerade eller okvalificerade medlemsnamn, visas följande fel: "Begränsningarna som införts av CONSTRAINED flaggan i STRTOTUPLE-funktionen har brutits."

  • När CONSTRAINED flaggan inte används kan den angivna tuplen upplösas till ett giltigt MDX-uttryck som returnerar en tuple.

Examples

Följande exempel returnerar måttet Återförsäljarförsäljningsbelopp för Bayern-medlemmen för kalenderåret 2004. Tuplespecifikationen som tillhandahålls innehåller ett giltigt MDX-tupleuttryck.

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

Följande exempel returnerar måttet Återförsäljarförsäljningsbelopp för Bayern-medlemmen för kalenderåret 2004. Tuplespecifikationen som tillhandahålls innehåller kvalificerade medlemsnamn, enligt kravet på CONSTRAINED flaggan.

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

Följande exempel returnerar måttet Återförsäljarförsäljningsbelopp för Bayern-medlemmen för kalenderåret 2004. Tuplespecifikationen som tillhandahålls innehåller ett giltigt MDX-tupleuttryck.

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

Följande exempel ger ett fel på grund av CONSTRAINED flaggan. Medan tuplespecifikationen innehåller ett giltigt MDX-tupleuttryck, kräver CONSTRAINED flaggan kvalificerade eller okvalificerade medlemsnamn i tuplespecifikationen.

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