StrToMember (MDX)

Vrací člen specifikovaný řetězcem ve formátu Multidimensional Expressions (MDX).

Syntax

  
StrToMember(Member_Name [,CONSTRAINED] )   

Arguments

Member_Name
Platný řetězcový výraz, který přímo či nepřímo specifikuje člena.

Remarks

Funkce StrToMember vrací člen specifikovaný v řetězcovém výrazu. Funkce StrToMember se obvykle používá s uživatelsky definovanými funkcemi k vrácení specifikace člena z externí funkce zpět do příkazu MDX, nebo když je parametrizován dotaz MDX.

  • Když je použit příznak CONSTRAINED, musí být jméno člena přímo rozlišitelné na kvalifikované nebo nekvalifikované jméno člena. Tento příznak se používá ke snížení rizika injekčních útoků přes specifikovaný řetězec. Pokud je zadán řetězec, který není přímo řešitelný na kvalifikované nebo nekvalifikované jméno člena, objeví se následující chyba: "Omezení uložená příznakem CONSTRAINED ve funkci STRTOMEMBER byla porušena."

  • Pokud se příznak CONSTRAINED nepoužije, může se specifikovaný člen vyřešit buď přímo na jméno člena, nebo na MDX výraz, který se vyřeší na jméno.

  • Pro lepší pochopení rozdílů mezi množinami a členy viz Používání výrazů sad a Používání výrazů členů.

Examples

Následující příklad vrací míru prodeje prodeje pro člena Bayernu v hierarchii atributů State-Province pomocí funkce StrToMember . Specifikovaný řetězec poskytoval kvalifikované jméno člena.

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

Následující příklad vrací míru prodeje prodeje pro člena Bayernu pomocí funkce StrToMember . Protože řetězec jmen člena poskytl pouze nekvalifikované jméno člena, dotaz vrací první instanci určeného člena, která se nachází v hierarchii Geografie zákazníka v dimenzi zákazníka, která se neprotíná s prodejem Reselleru. Nejlepší postupy vyžadují specifikaci kvalifikovaného názvu, aby byly zajištěny očekávané výsledky.

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

Následující příklad vrací míru prodeje prodeje pro člena Bayernu v hierarchii atributů State-Province pomocí funkce StrToMember . Řetězec jmen člena se vyřeší na kvalifikované jméno člena.

SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]  
  

Následující příklad vrací chybu způsobenou příznakem CONSTRAINED. Zatímco řetězec jmen člena obsahuje platný MDX výraz člena, který se vyřeší na kvalifikované jméno člena, příznak CONSTRAINED vyžaduje kvalifikovaná nebo nekvalifikovaná jména členů v řetězci jmen člena.

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