StrToMember(MDX)StrToMember (MDX)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

MDX(Multidimensional Expression) 형식 문자열에 의해 지정된 멤버를 반환합니다.Returns the member specified by a Multidimensional Expressions (MDX)–formatted string.

구문Syntax


StrToMember(Member_Name [,CONSTRAINED] )   

인수Arguments

Member_NameMember_Name
직접 또는 간접적으로 멤버를 지정하는 유효한 문자열 식입니다.A valid string expression specifying, directly or indirectly, a member.

주의Remarks

StrToMember 함수는 문자열 식에 지정 된 멤버를 반환 합니다.The StrToMember function returns the member specified in the string expression. StrToMember 함수는 대개 다시 MDX 문으로 경우, 또는 MDX 쿼리에 매개 변수가 외부 함수의 멤버 사양을 반환 사용자 정의 함수와 함께 사용 됩니다.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.

  • CONSTRAINED 플래그를 사용할 경우 멤버 이름은 정규화되거나 정규화되지 않은 멤버 이름으로 직접 확인될 수 있어야 합니다.When the CONSTRAINED flag is used, the member name must be directly resolvable to a qualified or unqualified member name. 이 플래그를 사용하면 지정한 문자열을 통한 삽입 공격 위험을 줄일 수 있습니다.This flag is used to reduce the risk of injection attacks via the specified string. 다음과 같은 오류가 표시 되는 문자열이 제공 정규화 되거나 정규화 되지 않은 멤버 이름으로 직접 확인할 수 없는 경우: "설정한 제한을 CONSTRAINED 플래그 STRTOMEMBER 함수에서 위반 했습니다."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."

  • CONSTRAINED 플래그를 사용하지 않을 경우 지정된 멤버는 멤버 이름으로 직접 확인되거나 이름으로 확인되는 MDX 식으로 확인될 수 있습니다.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.

  • 집합과 멤버의 차이를 더 잘 이해하려면 집합 식 사용 및 멤버 식 사용을 참조하십시오.To better understand the differences between sets and members, see Using Set Expressions and Using Member Expressions.

Examples

다음 예에서는 사용 하 여 State-province 특성 계층의 Bayern 멤버에 대 한 Reseller Sales Amount 측정값을 반환 된 StrToMember 함수입니다.The following example returns the Reseller Sales Amount measure for the Bayern member in the State-Province attribute hierarchy using the StrToMember function. 지정된 문자열은 정규화된 멤버 이름을 제공합니다.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]  

사용 하 여 Bayern 멤버에 대 한 Reseller Sales Amount 측정값을 반환 하는 다음 예제는 StrToMember 함수입니다.The following example returns the Reseller Sales Amount measure for the Bayern member using the StrToMember function. 멤버 이름 문자열은 정규화되지 않은 멤버 이름만 제공하므로 해당 쿼리는 Reseller Sales와 교차하지 않는 Customer 차원의 Customer Geography 계층에서 발생하는 지정된 멤버의 첫 번째 인스턴스를 반환합니다.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. 결과가 예상대로 나타나도록 하려면 정규화된 이름을 지정하는 것이 좋습니다.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]  

다음 예에서는 사용 하 여 State-province 특성 계층의 Bayern 멤버에 대 한 Reseller Sales Amount 측정값을 반환 된 StrToMember 함수입니다.The following example returns the Reseller Sales Amount measure for the Bayern member in the State-Province attribute hierarchy using the StrToMember function. 지정된 멤버 이름 문자열은 정규화된 멤버 이름으로 확인됩니다.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]  

다음 예에서는 CONSTRAINED 플래그로 인해 오류가 반환됩니다.The following example returns an error due to the CONSTRAINED flag. 지정된 멤버 이름 문자열에는 정규화된 멤버 이름으로 확인되는 유효한 MDX 멤버 식이 들어 있지만 CONSTRAINED 플래그가 있으므로 멤버 이름 문자열에 정규화되거나 정규화되지 않은 멤버 이름이 필요합니다.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]  

참고 항목See Also

MDX 함수 참조 ( Mdx)MDX Function Reference (MDX)