StrToSet (MDX)
Retorna o conjunto especificado por uma cadeia de caracteres formatada por 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. Normalmente, a função StrToSet é usada com funções definidas pelo usuário para retornar uma especificação de conjunto de uma função externa para uma instrução MDX, ou quando uma consulta MDX é realizada com parâmetros.
Quando o sinalizador CONSTRAINED for usado, a especificação de conjunto deve conter nomes de membros qualificados ou não qualificados ou um conjunto de tuplas que contenha nomes de membros qualificados ou não qualificados entre colchetes {}. 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 atributo Estado que usa 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 das Vendas do Revendedor para os países 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]