StrToMember (MDX)

Retorna o membro especificado por uma string formatada em Expressões Multidimensionais (MDX).

Sintaxe

  
StrToMember(Member_Name [,CONSTRAINED] )

Argumentos

Member_Name
Uma expressão de string válida que especifica, direta ou indiretamente, um membro.

Remarks

A função StrToMember retorna o membro especificado na expressão da string. A função StrToMember é tipicamente usada com funções definidas pelo usuário para retornar uma especificação de membro de uma função externa para uma instrução MDX, ou quando uma consulta MDX é parametrizada.

  • Quando a bandeira CONSTRAINED é usada, o nome do membro deve ser resolvível diretamente para um nome de membro qualificado ou não qualificado. 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 um nome de membro qualificado ou não qualificado, o seguinte erro aparece: "As restrições impostas pela flag CONSTRAINED na função STRTOMEMBER foram violadas."

  • Quando a flag CONSTRAINED não é usada, o membro especificado pode resolver diretamente para um nome de membro ou para uma expressão MDX que se resolve para um nome.

  • 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 a medida de Valor de Vendas do Revendedor para o membro da Bayern na hierarquia de atributos State-Province usando a função StrToMember . A string especificada fornecia o nome do membro qualificado.

SELECT {StrToMember ('[Geography].[State-Province].[Bayern]')}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]

O exemplo a seguir retorna a medida de Valor de Vendas do Revendedor para o membro da Bayern usando a função StrToMember . Como a string de nome do membro fornecia apenas um nome de membro não qualificado, a consulta retorna a primeira instância do membro especificado, que por acaso está na hierarquia de Geografia do Cliente na dimensão do Cliente, que não se cruza com as Vendas de Revendedor. As melhores práticas exigem especificar o nome qualificado para garantir os resultados esperados.

SELECT {StrToMember ('[Bayern]').Parent}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]

O exemplo a seguir retorna a medida de Valor de Vendas do Revendedor para o membro da Bayern na hierarquia de atributos State-Province usando a função StrToMember . A cadeia de nomes de membro fornecia resoluções para um nome de membro qualificado.

SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]

O exemplo a seguir retorna um erro devido à flag CONSTRAINED (CONSTRANGED). Embora a string de nomes de membro fornecida contenha uma expressão válida de membro MDX que resolve para um nome de membro qualificado, a flag CONSTRAINED exige nomes de membros qualificados ou não qualificados na string de nomes de membros.

SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)  
ON 0  
FROM [Adventure Works]

Conteúdo relacionado

  • Last updated on