StrToSet (MDX)
Retorna o conjunto especificado por uma cadeia de caracteres formatada em MDX (Multidimensional Expressions).
Sintaxe
StrToSet(Set_Specification [,CONSTRAINED] )
Argumentos
Set_Specification
Uma expressão de cadeia de caracteres válida especificando, direta ou indiretamente, um conjunto.
Comentários
A função StrToSet retorna o conjunto especificado na expressão de cadeia de caracteres. A função StrToSet normalmente é usada com funções definidas pelo usuário para retornar uma especificação definida de uma função externa de volta para uma instrução MDX ou quando uma consulta MDX é parametrizada.
Quando o sinalizador CONSTRAINED é usado, a especificação do conjunto deve conter nomes de membro qualificados ou não qualificados ou um conjunto de tuplas contendo nomes de membro qualificados ou não qualificados {}entre chaves . Esse sinalizador CONSTRAINED é usado para reduzir o risco de ataques de injeção pela cadeia de caracteres especificada. Se uma cadeia de caracteres fornecida não pode ser totalmente resolvida para nomes de membros qualificados ou não qualificados, surge o seguinte erro: "As restrições impostas pelo sinalizador CONSTRAINED na função STRTOVALUE foram violadas."
Quando o sinalizador CONSTRAINED não é usado, a especificação de conjunto especificada é resolvida como uma linguagem MDX válida que retorna um conjunto.
Para entender melhor as diferenças entre conjuntos e membros, consulte Usando expressões de conjuntos e Usando expressões de membros.
Exemplos
O exemplo a seguir retorna o conjunto de membros da hierarquia de atributos State-Province usando a função StrToSet . A especificação de conjunto fornece uma expressão de conjunto MDX válida.
SELECT StrToSet ('[Geography].[State-Province].Members')
ON 0
FROM [Adventure Works]
O exemplo a seguir retorna um erro devido ao sinalizador CONSTRAINED. Enquanto a especificação de conjunto fornece uma expressão de conjunto MDX válida, o sinalizador CONSTRAINED requer nomes de membros qualificados ou não qualificados na especificação de conjunto.
SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)
ON 0
FROM [Adventure Works]
O exemplo a seguir retorna a medida Valor de Vendas do Revendedor para Alemanha e Canadá. A especificação de conjunto fornecida na cadeia de caracteres especificada contém nomes de membros qualificados, conforme exigido pelo sinalizador CONSTRAINED.
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]