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 a tupla especificada por uma string formatada em Expressões Multidimensionais (MDX).
Sintaxe
StrToTuple(Tuple_Specification [,CONSTRAINED] )
Argumentos
Tuple_Specification
Uma expressão válida de string que especifica, direta ou indiretamente, uma tupla.
Remarks
A função StrToTuple retorna o conjunto especificado. A função StrToTuple é tipicamente usada com funções definidas pelo usuário para retornar uma especificação de tupla de uma função externa para uma instrução MDX.
Quando a bandeira CONSTRAINTS é usada, a especificação da tupla deve conter nomes de membros qualificados ou não qualificados. 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 STRTOTUPLE foram violadas."
Quando a flag CONSTRAINED não é usada, a tupla especificada pode resolver para uma expressão MDX válida que retorna uma tupla.
Exemplos
O exemplo a seguir retorna a medida de Valor de Vendas de 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 a seguir retorna a medida de Valor de Vendas de Revendedor para o membro da Bayern para o ano civil de 2004. A especificação de tupla fornecida contém nomes de membros qualificados, conforme exigido pela bandeira CONSTRAINED (CONSTRAIND).
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]
O exemplo a seguir retorna a medida de Valor de Vendas de 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 a seguir retorna um erro devido à flag CONSTRAINED (CONSTRANGED). Embora a especificação da tupla fornecida contenha uma expressão válida da tupla MDX, a flag 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]