StrToMember (MDX)StrToMember (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 membro specificato da una stringa in formato MDX (Multidimensional Expression).Returns the member specified by a Multidimensional Expressions (MDX)–formatted string.

SintassiSyntax


StrToMember(Member_Name [,CONSTRAINED] )   

ArgomentiArguments

Member_NameMember_Name
Espressione stringa valida che specifica, in modo diretto o indiretto, un membro.A valid string expression specifying, directly or indirectly, a member.

OsservazioniRemarks

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

  • Quando viene utilizzato il flag CONSTRAINED, il nome del membro deve essere direttamente risolvibile in un nome di membro completo o non qualificato.When the CONSTRAINED flag is used, the member name must be directly resolvable to a qualified or unqualified member name. 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 un nome di membro completo o non qualificato, viene visualizzato l'errore seguente: "Le restrizioni imposte dal flag CONSTRAINED nella funzione STRTOMEMBER sono state violate".If a string is provided that is not directly resolvable to a qualified or unqualified member name, the following error appears: "The restrictions imposed by the CONSTRAINED flag in the STRTOMEMBER function were violated."

  • Quando non viene utilizzato il flag CONSTRAINED, il membro specificato può essere risolto direttamente nel nome di un membro oppure in un'espressione MDX risolvibile in un nome.When the CONSTRAINED flag is not used, the specified member can resolve either directly to a member name or can resolve to an MDX expression that resolves to a name.

  • 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 la misura Reseller Sales Amount relativa al membro Bayern nella gerarchia dell'attributo State-Province tramite la StrToMember (funzione).The following example returns the Reseller Sales Amount measure for the Bayern member in the State-Province attribute hierarchy using the StrToMember function. La stringa specificata ha indicato il nome completo del membro.The specified string provided the qualified member name.

SELECT {StrToMember ('[Geography].[State-Province].[Bayern]')}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]  

L'esempio seguente restituisce la misura Reseller Sales Amount relativa al membro Bayern utilizzando il StrToMember (funzione).The following example returns the Reseller Sales Amount measure for the Bayern member using the StrToMember function. Poiché con la stringa del nome del membro è stato specificato soltanto un nome di membro non qualificato, la query restituisce la prima istanza del membro specificato, che si trova nella gerarchia Customer Geography della dimensione Customer, che non si interseca con Reseller Sales.Since the member name string provided only an unqualified member name, the query returns the first instance of the specified member, which happens to be in the Customer Geography hierarchy in the Customer dimension, which does not intersect with the Reseller Sales. Le procedure consigliate prevedono la specifica del nome completo in modo da garantire i risultati previsti.Best practices dictate specifying the qualified name to ensure expected results.

SELECT {StrToMember ('[Bayern]').Parent}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]  

L'esempio seguente restituisce la misura Reseller Sales Amount relativa al membro Bayern nella gerarchia dell'attributo State-Province tramite la StrToMember (funzione).The following example returns the Reseller Sales Amount measure for the Bayern member in the State-Province attribute hierarchy using the StrToMember function. La stringa del nome del membro specificata viene risolta in un nome di membro completo.The member name string provided resolves to a qualified member name.

SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
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 stringa del nome del membro specificata contenga un'espressione di membro MDX valida che viene risolta in un nome di membro completo, il flag CONSTRAINED richiede nomi di membro completi o non qualificati nella stringa del nome del membro.While the member name string provided contains a valid MDX member expression that resolves to a qualified member name, the CONSTRAINED flag requires qualified or unqualified member names in the member name string.

SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  

Vedere ancheSee Also

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