ToggleDrillState (MDX)

Alterna o estado de drill dos membros entre os modos drilldown e drillllup.

Sintaxe

  
ToggleDrillState(Set_Expression1,Set_Expression2 [, [RECURSIVE] [,INCLUDE_CALC_MEMBERS] ] )

Argumentos

Set_Expression1
Uma expressão válida de Expressões Multidimensionais (MDX) que retorna um conjunto.

Set_Expression2
Uma expressão válida de Expressões Multidimensionais (MDX) que retorna um conjunto.

Recursivo
(Opcional). Uma palavra-chave que indica comparação recursiva de conjuntos. A função ToggleDrillState é uma combinação das funções DrillupMember e DrilldownMember (DrillUpMember Drill). A recursão só se aplica quando o membro está no estado Drilldownmember .

Include_calc_members
(Opcional). Uma bandeira indicando se devem incluir membros calculados, caso existam, no nível de drill down.

Remarks

A função ToggleDrillState alterna o estado de perfuração de cada membro do segundo conjunto presente no primeiro conjunto. O primeiro conjunto pode conter tuplas com qualquer dimensionalidade, mas o segundo conjunto deve conter membros de uma única dimensão. A função ToggleDrillState é uma combinação das funções DrillupMember e DrilldownMember (DrillUpMember Drill). Se o membro, m, do segundo conjunto estiver presente no primeiro conjunto, e esse elemento for aprofundado (ou seja, tiver um descendente imediatamente após ele), então DrillupMember(Set_Expression1, {m}) é aplicado ao membro ou tupla do primeiro conjunto. Se esse elemento m for perfurado (ou seja, não há descendente de m que siga imediatamente m), DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) é aplicado ao primeiro conjunto.

Se a flag RECURSIVE opcional for usada, drill up e drill down são aplicados recursivamente. Para mais informações sobre a flag recursiva, veja as funções DrillupMember e DrilldownMember (DrillupMember e Drilldown).

Consultar a propriedade XMLA MdpropMdxDrillFunctions permite verificar o nível de suporte que o servidor oferece para as funções de perfuração; veja Propriedades XMLA Suportadas (XMLA) para detalhes.

Veja o Database Journal: MDX Set Functions: The ToggleDrillState() Function para cenários e exemplos envolvendo essa função.

Exemplo

O exemplo a seguir aprofunda o membro australiano do primeiro conjunto e perfura o membro dos Estados Unidos do primeiro conjunto.

SELECT ToggleDrillState  
   ({[Geography].[Geography].[Country].Members, [Geography].[Geography].[Country].&[United States].Children},  
      {[Geography].[Geography].[Country].[Australia]  
      , [Geography].[Geography].[Country].&[United States]}  
      --, recursive  
      --, include_calc_members  
   ) ON 0  
   FROM [Adventure Works]

Conteúdo relacionado

  • Last updated on