Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Devolve o conjunto especificado por uma cadeia formatada em Expressões Multidimensionais (MDX).
Syntax
StrToSet(Set_Specification [,CONSTRAINED] )
Arguments
Set_Specification
Uma expressão de cadeia válida que especifica, direta ou indiretamente, um conjunto.
Observações
A função StrToSet devolve o conjunto especificado na expressão da cadeia. A função StrToSet é normalmente usada com funções definidas pelo utilizador para devolver uma especificação de conjunto de uma função externa para uma instrução MDX, ou quando uma consulta MDX é parametrizada.
Quando a bandeira 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 {}. Esta bandeira é usada para reduzir o risco de ataques de injeção através da cadeia especificada. Se for fornecida uma cadeia que não é diretamente resolvível para nomes de membros qualificados ou não qualificados, aparece o seguinte erro: "As restrições impostas pela flag CONSTRAINED na função STRTOSET foram violadas."
Quando a bandeira CONSTRAINED não é utilizada, a especificação de conjunto especificada pode resolver para uma expressão válida de Expressões Multidimensionais (MDX) que devolve um conjunto.
Para compreender melhor as diferenças entre conjuntos e membros, veja Usar Expressões de Conjunto e Usar Expressões de Membros.
Examples
O exemplo seguinte devolve o conjunto de membros da hierarquia de atributos State-Province usando a função StrToSet . A especificação do conjunto fornece uma expressão de conjunto MDX válida.
SELECT StrToSet ('[Geography].[State-Province].Members')
ON 0
FROM [Adventure Works]
O exemplo seguinte devolve um erro devido à flag CONSSTRINGED. Embora a especificação de conjunto forneça uma expressão de conjunto MDX válida, a flag CONSTRAINED exige 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 seguinte devolve a medida de Valor de Vendas por Revendedor para a Alemanha e Canadá. A especificação de conjunto fornecida na cadeia especificada contém nomes de membros qualificados, conforme exigido pela bandeira CONSTRAINED (CONSTRAINED flag).
SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)
ON 0
FROM [Adventure Works]