StrToMember(MDX)

  • 아티클

MDX(Multidimensional Expressions) 형식 문자열로 지정된 멤버를 반환합니다.

구문

  
StrToMember(Member_Name [,CONSTRAINED] )

인수

Member_Name
멤버를 직접 또는 간접적으로 지정하는 유효한 문자열 식입니다.

설명

StrToMember 함수는 문자열 식에 지정된 멤버를 반환합니다. StrToMember 함수는 일반적으로 사용자 정의 함수와 함께 외부 함수에서 MDX 문으로 멤버 사양을 반환하거나 MDX 쿼리가 매개 변수화될 때 사용됩니다.

  • CONSTRAINED 플래그를 사용하는 경우 멤버 이름은 정규화되거나 정규화되지 않은 멤버 이름으로 직접 확인할 수 있어야 합니다. 이 플래그를 사용하면 지정한 문자열을 통한 삽입 공격 위험을 줄일 수 있습니다. 정규화되거나 정규화되지 않은 멤버 이름으로 직접 확인할 수 없는 문자열이 제공되면 다음 오류가 나타납니다. "STRTOMEMBER 함수의 CONSTRAINED 플래그에 의해 부과된 제한이 위반되었습니다."

  • CONSTRAINED 플래그를 사용하지 않는 경우 지정된 멤버는 멤버 이름으로 직접 확인하거나 이름으로 확인되는 MDX 식으로 확인할 수 있습니다.

  • 집합과 멤버의 차이를 더 잘 이해하려면 집합 식 사용 및 멤버 식 사용을 참조하십시오.

예

다음 예제에서는 StrToMember 함수를 사용하여 주-지방 특성 계층 구조의 바이에른 멤버에 대한 Reseller Sales Amount 측정값을 반환합니다. 지정된 문자열은 정규화된 멤버 이름을 제공합니다.

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

다음 예제에서는 StrToMember 함수를 사용하여 바이에른 멤버에 대한 Reseller Sales Amount 측정값을 반환합니다. 멤버 이름 문자열은 정규화되지 않은 멤버 이름만 제공했기 때문에 쿼리는 지정된 멤버의 첫 번째 인스턴스를 반환합니다. 이 인스턴스는 Customer 차원의 Customer Geography 계층 구조에 있으며 Reseller Sales와 교차하지 않습니다. 모범 사례는 예상된 결과를 보장하기 위해 정규화된 이름을 지정하는 것입니다.

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

다음 예제에서는 StrToMember 함수를 사용하여 주-지방 특성 계층 구조의 바이에른 멤버에 대한 Reseller Sales Amount 측정값을 반환합니다. 제공된 멤버 이름 문자열이 정규화된 멤버 이름으로 확인됩니다.

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

다음 예에서는 CONSTRAINED 플래그로 인해 오류가 반환됩니다. 제공된 멤버 이름 문자열에는 정규화된 멤버 이름으로 확인되는 유효한 MDX 멤버 식이 포함되어 있지만 CONSTRAINED 플래그에는 멤버 이름 문자열에 정규화된 멤버 또는 정규화되지 않은 멤버 이름이 필요합니다.

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

참고 항목

MDX 함수 참조(MDX)