StrToTuple (MDX)

Devuelve la tupla especificada por una cadena formateada en Multidimensional Expressions (MDX).

Sintaxis

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Argumentos

Tuple_Specification
Una expresión válida de cadenas que especifica, directa o indirectamente, una tupla.

Remarks

La función StrToTuple devuelve el conjunto especificado. La función StrToTuple se utiliza típicamente con funciones definidas por el usuario para devolver una especificación de tupla de una función externa a una sentencia MDX.

  • Cuando se utiliza la bandera CONSTRAINED (CONSTRAINED flag), la especificación de la tupla debe contener nombres de miembros cualificados o no calificados. Esta bandera se utiliza para reducir el riesgo de ataques de inyección mediante la cadena especificada. Si se proporciona una cadena que no puede resolverse directamente a nombres de miembros cualificados o no cualificados, aparece el siguiente error: "Se violaron las restricciones impuestas por la bandera CONSTRAINED en la función STRTOTUPLE."

  • Cuando no se utiliza la bandera CONSSTRINGED, la tupla especificada puede resolver en una expresión MDX válida que devuelva una tupla.

Examples

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

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

El siguiente ejemplo devuelve la medida de Importe de Ventas por Revendedores para el miembro de Bayern para el año natural 2004. La especificación de la tupla que se proporciona contiene nombres de miembros calificados, según lo requiera la bandera CONSTRAINED (CONSTRAIND).

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

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

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

El siguiente ejemplo devuelve un error debido a la bandera CONSTRAINED (CONSTRAINED Flag). Aunque la especificación de la tupla proporcionada contiene una expresión válida de la tupla MDX, la bandera CONSTRAINED requiere nombres de miembros cualificados o no cualificados en la especificación de la tupla.

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