Condividi tramite


StrToTuple (MDX)

Data aggiornamento: 17 luglio 2006

Restituisce la tupla specificata da una stringa in formato MDX (Multidimensional Expression).

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 utilizzata con funzioni definite dall'utente per la restituzione di una tupla specificata 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 viene restituita la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004. La tupla specificata contiene un'espressione di tupla MDX valida.

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

Nell'esempio seguente viene restituita la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004. La tupla specificata contiene nomi di membri completi, come richiesto dal flag CONSTRAINED.

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

Nell'esempio seguente viene restituita la misura Reseller Sales Amount relativa al membro Bayern per l'anno di calendario 2004. La tupla specificata contiene un'espressione di tupla MDX valida.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)')
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].LastChild)', CONSTRAINED)
ON 0
FROM [Adventure Works]

Vedere anche

Riferimento

Guida di riferimento alle funzioni MDX (MDX)

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione Cronologia

17 luglio 2006

Contenuto modificato:
  • Aggiornamento della sintassi e degli argomenti per maggiore chiarezza.
  • Aggiunta di esempi aggiornati.