StrToTuple (MDX)StrToTuple (MDX)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2008)noDatabase SQL di AzurenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Restituisce la tupla specificata da una stringa in formato MDX (Multidimensional Expression).Returns the tuple specified by a Multidimensional Expressions (MDX)–formatted string.

SintassiSyntax


StrToTuple(Tuple_Specification [,CONSTRAINED] )   

ArgomentiArguments

Tuple_SpecificationTuple_Specification
Espressione stringa valida che specifica, in modo diretto o indiretto, una tupla.A valid string expression specifying, directly or indirectly, a tuple.

OsservazioniRemarks

Il StrToTuple funzione restituisce il set specificato.The StrToTuple function returns the specified set. Il StrToTuple funzione viene in genere utilizzata con funzioni definite dall'utente per la restituzione di una tupla specificata da una funzione esterna a un'istruzione MDX.The StrToTuple function is typically used with user-defined functions to return a tuple specification from an external function back to an MDX statement.

  • Quando viene utilizzato il flag CONSTRAINED, la tupla specificata deve contenere nomi di membri completi o non qualificati.When the CONSTRAINED flag is used, the tuple specification must contain qualified or unqualified member names. Questo flag viene utilizzato per ridurre il rischio di attacchi intrusivi tramite la stringa specificata.This flag is used to reduce the risk of injection attacks via the specified string. Se viene specificata una stringa non direttamente risolvibile in nomi di membri completi o non qualificati, viene visualizzato l'errore seguente: "Le restrizioni imposte dal flag CONSTRAINED nella funzione STRTOTUPLE sono state violate".If a string is provided that is not directly resolvable to qualified or unqualified member names, the following error appears: "The restrictions imposed by the CONSTRAINED flag in the STRTOTUPLE function were violated."

  • Quando non viene utilizzato il flag CONSTRAINED, la tupla specificata può essere risolta in un'espressione MDX valida che restituisce una tupla.When the CONSTRAINED flag is not used, the specified tuple can resolve to a valid MDX expression that returns a tuple.

EsempiExamples

Nell'esempio seguente la funzione viene utilizzata per restituire la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004.The following example returns the Reseller Sales Amount measure for the Bayern member for calendar year 2004. La specifica della tupla fornita contiene un'espressione di tupla MDX valida.The tuple specification that is provided contains a valid MDX tuple expression.

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

Nell'esempio seguente la funzione viene utilizzata per restituire la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004.The following example returns the Reseller Sales Amount measure for the Bayern member for calendar year 2004. La specifica della tupla fornita contiene nomi di membri qualificati, come richiesto dal flag CONSTRAINED.The tuple specification that is provided contains qualified member names, as required by the CONSTRAINED flag.

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

Nell'esempio seguente la funzione viene utilizzata per restituire la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004.The following example returns the Reseller Sales Amount measure for the Bayern member for calendar year 2004. La specifica della tupla fornita contiene un'espressione di tupla MDX valida.The tuple specification that is provided contains a valid MDX tuple expression.

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

Nell'esempio seguente viene restituito un errore a causa del flag CONSTRAINED.The following example returns an error due to the CONSTRAINED flag. Nonostante la tupla specificata contenga un'espressione di tupla MDX valida, il flag CONSTRAINED richiede in essa nomi di membri completi o non qualificati.While the tuple specification provided contains a valid MDX tuple expression, the CONSTRAINED flag requires qualified or unqualified member names in the tuple specification.

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

Vedere ancheSee Also

Riferimento alla funzione MDX ( MDX )MDX Function Reference (MDX)