StrToTuple(MDX)StrToTuple (MDX)

적용 대상:예SQL Server Analysis Services아니요Azure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services

MDX(Multidimensional Expressions) 형식 문자열에 의해 지정된 튜플을 반환합니다.Returns the tuple specified by a Multidimensional Expressions (MDX)–formatted string.

구문Syntax


StrToTuple(Tuple_Specification [,CONSTRAINED] )   

인수Arguments

Tuple_SpecificationTuple_Specification
직접 또는 간접적으로 튜플을 지정하는 유효한 문자열 식입니다.A valid string expression specifying, directly or indirectly, a tuple.

주의Remarks

StrToTuple 함수는 지정 된 집합을 반환 합니다.The StrToTuple function returns the specified set. StrToTuple 함수는 대개에 MDX 문에 다시 외부 함수의 튜플 사양을 반환 사용자 정의 함수와 함께 사용 됩니다.The StrToTuple function is typically used with user-defined functions to return a tuple specification from an external function back to an MDX statement.

  • CONSTRAINED 플래그를 사용할 경우 튜플 사양에는 정규화되거나 정규화되지 않은 멤버 이름을 포함해야 합니다.When the CONSTRAINED flag is used, the tuple specification must contain qualified or unqualified member names. 이 플래그를 사용하면 지정한 문자열을 통한 삽입 공격 위험을 줄일 수 있습니다.This flag is used to reduce the risk of injection attacks via the specified string. 다음 오류가 표시 됩니다는 문자열이 직접 확인할 수 없는 정규화 되거나 정규화 되지 않은 멤버 이름이 아닌 경우 이면: "CONSTRAINED 설정한 제한을 STRTOTUPLE 함수에서 플래그 위반 했습니다."If a string is provided that is not directly resolvable to qualified or unqualified member names, the following error appears: "The restrictions imposed by the CONSTRAINED flag in the STRTOTUPLE function were violated."

  • CONSTRAINED 플래그를 사용하지 않을 경우 지정한 튜플은 튜플을 반환하는 유효한 MDX 식으로 확인될 수 있습니다.When the CONSTRAINED flag is not used, the specified tuple can resolve to a valid MDX expression that returns a tuple.

Examples

다음 예에서는 2004년에 대한 Bayern 멤버의 Reseller Sales Amount 측정값을 반환합니다.The following example returns the Reseller Sales Amount measure for the Bayern member for calendar year 2004. 제공되는 튜플 사양에는 유효한 MDX 튜플 식이 포함됩니다.The tuple specification that is provided contains a valid MDX tuple expression.

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

다음 예에서는 2004년에 대한 Bayern 멤버의 Reseller Sales Amount 측정값을 반환합니다.The following example returns the Reseller Sales Amount measure for the Bayern member for calendar year 2004. 제공되는 튜플 사양에는 CONSTRAINED 플래그에 필요한 정규화된 멤버 이름이 포함됩니다.The tuple specification that is provided contains qualified member names, as required by the CONSTRAINED flag.

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

다음 예에서는 2004년에 대한 Bayern 멤버의 Reseller Sales Amount 측정값을 반환합니다.The following example returns the Reseller Sales Amount measure for the Bayern member for calendar year 2004. 제공되는 튜플 사양에는 유효한 MDX 튜플 식이 포함됩니다.The tuple specification that is provided contains a valid MDX tuple expression.

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

다음 예에서는 CONSTRAINED 플래그로 인해 오류가 반환됩니다.The following example returns an error due to the CONSTRAINED flag. 지정된 튜플 사양에 유효한 MDX 튜플 식이 들어 있지만 CONSTRAINED 플래그가 있으므로 튜플 사양에 정규화되거나 정규화되지 않은 멤버 이름이 필요합니다.While the tuple specification provided contains a valid MDX tuple expression, the CONSTRAINED flag requires qualified or unqualified member names in the tuple specification.

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

관련 항목:See Also

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