StrToTuple (MDX)

Actualizado: 17 de julio de 2006

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

Sintaxis

StrToTuple(Tuple_Specification [,CONSTRAINED] ) 

Argumentos

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

Notas

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

• Cuando se utiliza el indicador CONSTRAINED, la especificación de tupla debe contener nombres de miembro calificados o no calificados. Este indicador 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 el indicador CONSTRAINED en la función STRTOTUPLE."
• Cuando no se utiliza el indicador 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 2004. La especificación de tupla que se proporciona contiene una expresión de tupla MDX válida.

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

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

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

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

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)')
ON 0
FROM [Adventure Works]

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

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)', CONSTRAINED)
ON 0
FROM [Adventure Works]

Vea también

Referencia

Referencia de funciones MDX (MDX)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios