StrToTuple (MDX)
Restituisce la tupla specificata da una stringa in formato MDX (Multidimensional Expressions).
Sintassi
StrToTuple(Tuple_Specification [,CONSTRAINED] )
Argomenti
Tuple_Specification
Espressione stringa valida che specifica, in modo diretto o indiretto, una tupla.
Osservazioni:
La funzione StrToTuple restituisce il set specificato. La funzione StrToTuple viene in genere usata con funzioni definite dall'utente per restituire una specifica di tupla da una funzione esterna a un'istruzione MDX.
Quando viene utilizzato il flag CONSTRAINED, la tupla specificata deve contenere nomi di membri completi o non qualificati. Questo flag viene utilizzato per ridurre il rischio di attacchi intrusivi tramite la stringa specificata. 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".
Quando non viene utilizzato il flag CONSTRAINED, la tupla specificata può essere risolta in un'espressione MDX valida che restituisce una tupla.
Esempi
Nell'esempio seguente la funzione viene utilizzata per restituire la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004. La specifica della tupla fornita contiene un'espressione di tupla MDX valida.
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. La specifica della tupla fornita contiene nomi di membri qualificati, come richiesto dal flag CONSTRAINED.
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. La specifica della tupla fornita contiene un'espressione di tupla MDX valida.
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. Nonostante la tupla specificata contenga un'espressione di tupla MDX valida, il flag CONSTRAINED richiede in essa nomi di membri completi o non qualificati.
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]