Compartilhar via


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 linguagem MDX válida que retorna um conjunto.

  • Set_Expression2
    Uma linguagem MDX válida que retorna um conjunto.

  • Recursive
    (Opcional). Uma palavra-chave que indica comparação recursiva de conjuntos. A função ToggleDrillState é uma combinação das funções DrillupMember e DrilldownMember. Recursão só se aplica quando o membro se encontra 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 busca de cada membro do segundo conjunto que está 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 for buscado (ou seja, tiver um descendente imediatamente após ele), então DrillupMember(Set_Expression1, {m}) será aplicado no membro ou na tupla no primeiro conjunto. Se esse membro m não for buscado (ou seja, não tiver nenhum descendente de m imediatamente após m), DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) será aplicado no primeiro conjunto.

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

A consulta à propriedade XMLA MdpropMdxDrillFunctions permite verificar o nível de suporte que o servidor oferece para as funções de detalhamento; consulte Propriedades XMLA suportadas (XMLA) para obter detalhes.

Consulte Diário do banco de dados: Funções do 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

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