StrToSet (MDX)StrToSet (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 il set specificato da una stringa con formattazione MDX (Multidimensional Expression).Returns the set specified by a Multidimensional Expressions (MDX)–formatted string.

SintassiSyntax


StrToSet(Set_Specification [,CONSTRAINED] )   

ArgomentiArguments

Set_SpecificationSet_Specification
Espressione stringa valida che specifica, direttamente o indirettamente, un set.A valid string expression specifying, directly or indirectly, a set.

OsservazioniRemarks

Il StrToSet funzione restituisce il set specificato nell'espressione stringa.The StrToSet function returns the set specified in the string expression. Il StrToSet funzione viene in genere utilizzata con funzioni definite dall'utente per restituire una specifica di set da una funzione esterna a un'istruzione MDX o quando una query MDX con parametri.The StrToSet function is typically used with user-defined functions to return a set specification from an external function back to an MDX statement, or when an MDX query is parameterized.

  • Quando viene utilizzato il flag CONSTRAINED, la specifica di set deve includere nomi di membri completi o non qualificati o un set di tuple contenenti nomi di membri completi o non qualificati racchiusi tra parentesi graffe {}.When the CONSTRAINED flag is used, the set specification must contain qualified or unqualified member names or a set of tuples containing qualified or unqualified member names enclosed by braces {}. 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 si specifica una stringa non direttamente risolvibile in nomi di membro completi o non qualificati, verrà visualizzato l'errore seguente: "Le restrizioni imposte dal flag CONSTRAINED nella funzione STRTOSET 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 STRTOSET function were violated."

  • Quando non viene utilizzato il flag CONSTRAINED, è possibile risolvere la specifica di set specificata in un'espressione MDX (Multidimensional Expression) valida che restituisce un set.When the CONSTRAINED flag is not used, the specified set specification can resolve to a valid Multidimensional Expressions (MDX) expression that returns a set.

  • Per comprendere meglio le differenze tra set e membri, vedere Utilizzo di espressioni set e Utilizzo delle espressioni di membro.To better understand the differences between sets and members, see Using Set Expressions and Using Member Expressions.

EsempiExamples

L'esempio seguente restituisce il set di membri della gerarchia dell'attributo State-Province tramite la StrToSet (funzione).The following example returns the set of members of the State-Province attribute hierarchy using the StrToSet function. La specifica di set contiene un'espressione set MDX valida.The set specification provides a valid MDX set expression.

SELECT StrToSet ('[Geography].[State-Province].Members')  
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. Sebbene la specifica di set contenga un'espressione MDX valida, per il flag CONSTRAINED la specifica di set deve includere nomi di membri completi o non qualificati.While the set specification provides a valid MDX set expression, the CONSTRAINED flag requires qualified or unqualified member names in the set specification.

SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  

Nell'esempio seguente viene restituita la misura Reseller Sales Amount per Germania e Canada.The following example returns the Reseller Sales Amount measure for the countries of Germany and Canada. La specifica di set inclusa nella stringa specificata contiene nomi di membri completi, come richiesto dal flag CONSTRAINED.The set specification provided in the specified string contains qualified member names, as required by the CONSTRAINED flag.

SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  

Vedere ancheSee Also

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