StrToTuple(MDX)

  • 아티클

MDX(Multidimensional Expressions) 형식 문자열로 지정된 튜플을 반환합니다.

구문

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )

인수

Tuple_Specification
직접 또는 간접적으로 튜플을 지정하는 유효한 문자열 식입니다.

설명

StrToTuple 함수는 지정된 집합을 반환합니다. StrToTuple 함수는 일반적으로 사용자 정의 함수와 함께 외부 함수에서 MDX 문으로 튜플 사양을 반환하는 데 사용됩니다.

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

  • CONSTRAINED 플래그를 사용하지 않으면 지정된 튜플이 튜플을 반환하는 유효한 MDX 식으로 확인할 수 있습니다.

예

다음 예제에서는 2004년의 바이에른 멤버에 대한 Reseller Sales Amount 측정값을 반환합니다. 제공되는 튜플 사양에는 유효한 MDX 튜플 식이 포함되어 있습니다.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')  
ON 0  
FROM [Adventure Works]

다음 예제에서는 2004년의 바이에른 멤버에 대한 Reseller Sales Amount 측정값을 반환합니다. 제공된 튜플 사양에는 CONSTRAINED 플래그에 필요한 정규화된 멤버 이름이 포함됩니다.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)  
ON 0  
FROM [Adventure Works]

다음 예제에서는 2004년의 바이에른 멤버에 대한 Reseller Sales Amount 측정값을 반환합니다. 제공되는 튜플 사양에는 유효한 MDX 튜플 식이 포함되어 있습니다.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')  
ON 0  
FROM [Adventure Works]

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

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)  
ON 0  
FROM [Adventure Works]

참고 항목

MDX 함수 참조(MDX)