Artigo
04/01/2012

DrilldownMember (MDX)

Faz uma busca detalhada dos membros de um determinado conjunto que estejam presentes em um segundo conjunto especificado.

Alternativamente, a função faz uma busca detalhada em um conjunto de tuplas usando a primeira hierarquia de tuplas ou a hierarquia especificada opcionalmente.

Sintaxe

DrillDownMember(<set_expression1>, <set_expression2> [,[<target_hierarchy>]] [,[RECURSIVE][,INCLUDE_CALC_MEMBERS]])

Argumentos

Termo	Definição
Set_Expression1	Uma expressão MDX (Multidimensional Expressions) válida que retorna um conjunto.
Set_Expression2	Uma expressão MDX (Multidimensional Expressions) válida que retorna um conjunto.
Target_Hierarchy	Uma expressão MDX (Multidimensional Expressions) válida que retorna uma hierarquia.
RECURSIVE	Uma palavra-chave que indica comparação recursiva de conjuntos.
INCLUDE_CALC_MEMBERS	Uma palavra-chave para habilitar a inclusão dos membros calculados nos resultados da busca detalhada.

Comentários

Essa função retorna um conjunto de membros filho ordenados por hierarquia e inclui membros especificados no primeiro conjunto que também estão presentes no segundo conjunto.Os membros pai não são submetidos à busca detalhada quando o primeiro conjunto contém o membro pai e um ou mais filhos. O primeiro conjunto pode ter qualquer dimensionalidade, mas o segundo deve conter um conjunto unidimensional. A ordem é preservada entre os membros originais no primeiro conjunto, a não ser que todos os membros filho incluídos no conjunto de resultados da função sejam imediatamente incluídos com seu membro pai. A função constrói o conjunto de resultados recuperando os filhos para cada membro no primeiro conjunto que também está presente no segundo conjunto. Se RECURSIVE for especificada, a função continuará a comparar recursivamente os membros do conjunto de resultados em relação ao segundo conjunto, recuperando os filhos para cada membro no conjunto de resultados que também está presente no segundo conjunto até que nenhum membro do conjunto de resultados possa ser encontrado no segundo conjunto.

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.

O primeiro conjunto pode conter tuplas em vez de membros. A busca detalhada de tupla é uma extensão de OLE DB e retorna um conjunto de tuplas em vez de membros.

Importante
Um membro não será buscado se for seguido imediatamente por um dos seus filhos. A ordem de membros no conjunto é importante tanto para as famílias de funções Drilldown * quanto Drillup *.

Exemplos

O exemplo a seguir faz uma busca detalhada na Austrália, que é o membro do primeiro conjunto que também está presente no segundo conjunto.

SELECT DrilldownMember 
   ( [Geography].[Geography].Children,
      {[Geography].[Geography].[Country].[Australia],
        [Geography].[Geography].[State-Province].[New South Wales]}
   )
   ON 0
   FROM [Adventure Works]

O exemplo a seguir faz uma busca detalhada na Austrália, que é o membro do primeiro conjunto que também está presente no segundo conjunto. Porém, como o argumento RECURSIVE está presente, a função continua a comparar recursivamente os membros do conjunto de resultados (membros do nível de Estado) em relação ao segundo conjunto, recuperando os filhos para cada membro no conjunto de resultados (membros do nível Cidade) que também está presente no segundo conjunto, até que nenhum membro do conjunto de resultados possa ser encontrado no segundo conjunto.

SELECT DrilldownMember 
   ( [Geography].[Geography].Children,
      {[Geography].[Geography].[Country].[Australia],
        [Geography].[Geography].[State-Province].[New South Wales]}
   ,RECURSIVE)
   ON 0
   FROM [Adventure Works]

Consulte também

Referência

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

Compartilhar via