StrToMember (MDX)
Devuelve el miembro especificado por una cadena con formato de Expresiones multidimensionales (MDX).
Sintaxis
StrToMember(Member_Name [,CONSTRAINED] )
Argumentos
- Member_Name
Expresión de cadena válida que especifica, directa o indirectamente, un miembro.
Notas
La función StrToMember devuelve el miembro especificado. La función StrToMember suele utilizarse con funciones definidas por el usuario para devolver una especificación de miembro de una función externa a una instrucción MDX.
Cuando se utiliza el indicador CONSTRAINED, el nombre del miembro debe resolverse directamente en un nombre de miembro calificado o no calificado. 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 un nombre de miembro calificado o no calificado, aparece el siguiente error: "Se han infringido las restricciones impuestas por el indicador CONSTRAINED en la función STRTOMEMBER."
Cuando no se utiliza el indicador CONSTRAINED, el miembro especificado puede resolverse directamente en un nombre de miembro o en una expresión MDX que se resuelve en un nombre.
Ejemplos
El ejemplo siguiente devuelve la medida Reseller Sales Amount del miembro Bayern de la jerarquía de atributo State-Province mediante la función StrToMember. La cadena especificada proporcionó el nombre de miembro calificado.
SELECT StrToMember ('[Geography].[State-Province].[Bayern]')
ON 0
FROM [Adventure Works]
El ejemplo siguiente devuelve la medida Reseller Sales Amount del miembro Bayern mediante la función StrToMember. Dado que la cadena de nombre de miembro proporcionó únicamente un nombre de miembro no calificado, la consulta devuelve la primera instancia del miembro especificado, que se encuentra en la jerarquía Customer Geography de la dimensión Customer, que no forma intersección con Reseller Sales. Las prácticas recomendadas indican que para garantizar los resultados esperados, se debe especificar el nombre calificado.
SELECT StrToMember ('[Bayern]').Parent
ON 0
FROM [Adventure Works]
El ejemplo siguiente devuelve la medida Reseller Sales Amount del miembro Bayern de la jerarquía de atributo State-Province mediante la función StrToMember. La cadena de nombre de miembro proporcionada se resuelve en un nombre de miembro calificado.
SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild')
ON 0
FROM [Adventure Works]
El ejemplo siguiente devuelve un error debido al indicador CONSTRAINED. Mientras que la cadena de nombre de miembro proporcionada contiene una expresión de miembro MDX válida que se resuelve en un nombre de miembro calificado, el indicador CONSTRAINED requiere nombres de miembro calificados o no calificados en la cadena de nombre de miembro.
SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)
ON 0
FROM [Adventure Works]