ToggleDrillState (MDX)

Alterna o estado de busca de membros entre os modos de busca detalhada e drillllup.

Sintaxe

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

Argumentos

Set_Expression1
Uma expressão MDX válida que retorna um conjunto.

Set_Expression2
Uma expressão MDX válida que retorna um conjunto.

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

Include_calc_members
(Opcional). Um sinalizador que indica se deve-se incluir membros calculados, caso existam, no nível de drill down.

Comentários

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

Se o sinalizador RECURSIVE opcional for usado, a busca detalhada e a busca detalhada serão aplicadas recursivamente. Para obter mais informações sobre o sinalizador recursivo, consulte as funções DrillupMember e DrilldownMember .

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

Confira Diário do Banco de Dados: Funções de Conjunto MDX: a função ToggleDrillState() para cenários e exemplos que envolvem essa função.

Exemplo

O exemplo a seguir faz uma busca detalhada no membro Austrália do primeiro conjunto e faz drill up no membro 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]  

Consulte Também

Referência de função MDX (MDX)