StrToTuple (MDX)

  • Artículo

Devuelve la tupla especificada por una cadena con formato MDX (Expresiones multidimensionales).

Sintaxis

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )

Argumentos

Tuple_Specification
Expresión de cadena válida que especifica, directa o indirectamente, una tupla.

Comentarios

La función StrToTuple devuelve el conjunto especificado. La función StrToTuple se usa normalmente con funciones definidas por el usuario para devolver una especificación de tupla de una función externa a una instrucción MDX.

  • Cuando se utiliza la marca CONSTRAINED, la especificación de tupla debe contener nombres de miembro calificados o no calificados. Esta marca se utiliza para reducir el riesgo de ataques por inyección de código a través de la cadena especificada. Si se proporciona una cadena que no se resuelve directamente en nombres de miembro calificados o no calificados, aparece el siguiente error: "Se infringieron las restricciones impuestas por la marca CONSTRAINED en la función STRTOTUPLE."

  • Cuando no se utiliza la marca CONSTRAINED, la tupla especificada se puede resolver en una expresión MDX válida que devuelve una tupla.

Ejemplos

El ejemplo siguiente devuelve la medida Reseller Sales Amount del miembro Bayern para el año natural 2004. La especificación de la tupla que se proporciona contiene una expresión de tupla MDX válida.

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

El ejemplo siguiente devuelve la medida Reseller Sales Amount del miembro Bayern para el año natural 2004. La especificación de tupla que se proporciona contiene nombres de miembros calificados, según sea necesario para la marca CONSTRAINED.

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

El ejemplo siguiente devuelve la medida Reseller Sales Amount del miembro Bayern para el año natural 2004. La especificación de la tupla que se proporciona contiene una expresión de tupla MDX válida.

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

El ejemplo siguiente devuelve un error debido a la marca CONSTRAINED. Mientras que la especificación de tupla proporcionada contiene una expresión de tupla MDX válida, la marca CONSTRAINED necesita nombres de miembro calificados o no calificados en la especificación de tupla.

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

Consulte también

Referencia de funciones MDX (MDX)