StrToSet (MDX)

Devuelve el conjunto especificado por una cadena formateada en Multidimensional Expressions (MDX).

Sintaxis

  
StrToSet(Set_Specification [,CONSTRAINED] )   

Argumentos

Set_Specification
Una expresión de cadena válida que especifica, directa o indirectamente, un conjunto.

Remarks

La función StrToSet devuelve el conjunto especificado en la expresión de cadena. La función StrToSet se utiliza típicamente con funciones definidas por el usuario para devolver una especificación conjunta de una función externa a una sentencia MDX, o cuando una consulta MDX está parametrizada.

  • Cuando se utiliza la bandera CONSTRAINED (CONSTRAINT), la especificación del conjunto debe contener nombres de miembros cualificados o no cualificados o un conjunto de tuplas que contengan nombres de miembros cualificados o no cualificados entre labrazos {}. Esta bandera se utiliza para reducir el riesgo de ataques de inyección mediante la cadena especificada. Si se proporciona una cadena que no es directamente resoluble 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 STTOSET."

  • Cuando no se utiliza la bandera CONSRESTRICTED, la especificación de conjunto especificada puede resolverse en una expresión válida de Expresiones Multidimensionales (MDX) que devuelva un conjunto.

  • Para entender mejor las diferencias entre conjuntos y miembros, véase Uso de expresiones de conjunto y Uso de expresiones de miembros.

Examples

El siguiente ejemplo devuelve el conjunto de miembros de la jerarquía de atributos State-Province usando la función StrToSet . La especificación de conjunto proporciona una expresión de conjunto MDX válida.

SELECT StrToSet ('[Geography].[State-Province].Members')  
ON 0  
FROM [Adventure Works]  
  

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

SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  
  

El siguiente ejemplo devuelve la medida de Importe de Venta de Revendedores para Alemania y Canadá. La especificación del conjunto proporcionada en la cadena especificada contiene nombres de miembros cualificados, según lo requiera la bandera CONSRESTRICTED.

SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)  
ON 0  
FROM [Adventure Works]