Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna o conjunto especificado por uma string formatada em Expressões Multidimensionais (MDX).
Sintaxe
StrToSet(Set_Specification [,CONSTRAINED] )
Argumentos
Set_Specification
Uma expressão de string válida que especifica, direta ou indiretamente, um conjunto.
Remarks
A função StrToSet retorna o conjunto especificado na expressão da string. A função StrToSet é tipicamente 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 é parametrizada.
Quando a flag CONSTRAINED é usada, a especificação do conjunto deve conter nomes de membros qualificados ou não qualificados ou um conjunto de tuplas contendo nomes de membros qualificados ou não qualificados incluídos por colchetes {}. Essa bandeira é usada para reduzir o risco de ataques de injeção via a cadeia especificada. Se uma string for fornecida que não pode ser resolvida diretamente para nomes de membros qualificados ou não qualificados, o seguinte erro aparece: "As restrições impostas pela flag CONSTRAINED na função STRTOSET foram violadas."
Quando a flag CONSTRAINED não é usada, a especificação de conjunto especificada pode se resolver para uma expressão válida de Expressões Multidimensionais (MDX) que retorna um conjunto.
Para entender melhor as diferenças entre conjuntos e membros, veja Usando Expressões de Conjunto e Usando Expressões de Membro.
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 à flag CONSTRAINED (CONSTRANGED). Enquanto a especificação de conjunto fornece uma expressão de conjunto MDX válida, a flag CONSTRAINED exige nomes de membros qualificados ou não qualificados na especificação do conjunto.
SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)
ON 0
FROM [Adventure Works]
O exemplo a seguir retorna a medida de Valor de Vendas de Revendedor para Alemanha e Canadá. A especificação de conjunto fornecida na string especificada contém nomes de membros qualificados, conforme exigido pela flag CONSTRAINED (CONSTRAINT).
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]