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 a tuplo especificada por uma cadeia formatada em Multidimensional Expressions (MDX).
Syntax
StrToTuple(Tuple_Specification [,CONSTRAINED] )
Arguments
Tuple_Specification
Uma expressão de cadeia válida que especifica, direta ou indiretamente, uma tupla.
Observações
A função StrToTuple devolve o conjunto especificado. A função StrToTuple é tipicamente usada com funções definidas pelo utilizador para devolver uma especificação de tupla de uma função externa para uma instrução MDX.
Quando a bandeira CONSTRAINED é usada, a especificação da tupla deve conter nomes de membros qualificados ou não qualificados. 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 bandeira CONSTRAINED na função STRTOTUPLE foram violadas."
Quando a flag CONSTRAINED não é utilizada, a tupla especificada pode resolver para uma expressão MDX válida que devolve uma tupla.
Examples
O exemplo seguinte devolve a medida do Montante de Vendas do Revendedor para o membro da Bayern para o ano civil de 2004. A especificação da tupla fornecida contém uma expressão válida da tupla MDX.
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
O exemplo seguinte devolve a medida do Montante de Vendas do Revendedor para o membro da Bayern para o ano civil de 2004. A especificação da tupla fornecida contém nomes de membros qualificados, conforme exigido pela bandeira CONSTRAINED (CONSTRAINED flag).
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]
O exemplo seguinte devolve a medida do Montante de Vendas do Revendedor para o membro da Bayern para o ano civil de 2004. A especificação da tupla fornecida contém uma expressão válida da tupla MDX.
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
O exemplo seguinte devolve um erro devido à flag CONSSTRINGED. Embora a especificação da tupla fornecida contenha uma expressão válida da tupla MDX, a bandeira CONSTRAINED exige nomes de membros qualificados ou não qualificados na especificação da tupla.
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]