StrToTuple (MDX)

Geeft de tuple terug die is gespecificeerd door een Multidimensional Expressions (MDX)-geformatteerde string.

Syntax

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Arguments

Tuple_Specification
Een geldige stringexpressie die, direct of indirect, een tuple specificeert.

Remarks

De StrToTuple-functie geeft de gespecificeerde set terug. De StrToTuple-functie wordt doorgaans gebruikt met door de gebruiker gedefinieerde functies om een tuple-specificatie van een externe functie terug te sturen naar een MDX-instructie.

  • Wanneer de CONSTRAINED vlag wordt gebruikt, moet de tuple-specificatie gekwalificeerde of niet-gekwalificeerde ledennamen bevatten. Deze vlag wordt gebruikt om het risico op injectie-aanvallen via de gespecificeerde string te verminderen. Als er een string wordt gegeven die niet direct oplosbaar is voor gekwalificeerde of niet-gekwalificeerde ledennamen, verschijnt de volgende fout: "De beperkingen opgelegd door de CONSTRAINED vlag in de STRTOTUPLE-functie zijn geschonden."

  • Wanneer de CONSTRAINED flag niet wordt gebruikt, kan de gespecificeerde tuple worden opgelost naar een geldige MDX-expressie die een tuple teruggeeft.

Examples

Het volgende voorbeeld geeft de Reseller Sales Amount-maat terug voor het Bayern-lid voor het kalenderjaar 2004. De tuple-specificatie die wordt gegeven bevat een geldige MDX-tuple-expressie.

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

Het volgende voorbeeld geeft de Reseller Sales Amount-maat terug voor het Bayern-lid voor het kalenderjaar 2004. De tuple-specificatie die wordt verstrekt bevat gekwalificeerde ledennamen, zoals vereist door de CONSTRAINED vlag.

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

Het volgende voorbeeld geeft de Reseller Sales Amount-maat terug voor het Bayern-lid voor het kalenderjaar 2004. De tuple-specificatie die wordt gegeven bevat een geldige MDX-tuple-expressie.

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

Het volgende voorbeeld geeft een foutmelding vanwege de CONSTRAINED flag. Hoewel de aangeboden tuple-specificatie een geldige MDX-tuple-expressie bevat, vereist de CONSTRAINED flag gekwalificeerde of niet-gekwalificeerde ledennamen in de tuple-specificatie.

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