ToggleDrillState (многомерные выражения)

Переключает состояние детализации элементов между режимами углубленной детализации и свертки.

Синтаксис

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

Аргументы

• Set_Expression1
  Допустимое многомерное выражение, возвращающее набор.

• Set_Expression2
  Допустимое многомерное выражение, возвращающее набор.

• Recursive
  (Необязательно.) Ключевое слово, которое обозначает рекурсивное сравнение наборов. Функция ToggleDrillState представляет собой сочетаний функций DrillupMember и DrilldownMember. Рекурсия действует только тогда, когда элемент находится в состоянии DrilldownMember.

• Include_calc_members
  (Необязательно.) Флажок, указывающий, следует ли включать вычисленные элементы и должны ли они существовать на уровне детализации углублением.

Замечания

Функция ToggleDrillState переключает состояние детализации элементов второго набора, присутствующих в первом наборе. Первый набор может содержать кортежи любой размерности, однако второй набор должен содержать элементы одного измерения. Функция ToggleDrillState представляет собой сочетаний функций DrillupMember и DrilldownMember. Если элемент m из второго набора присутствует в первом наборе и если этот элемент детализирован углублением (т. е. имеет непосредственного потомка), то к кортежу или элементу первого набора применяется функция DrillupMember(Set_Expression1, {m}). Если данный элемент m свернут (т. е. не существует потомка m, который следует непосредственно за m), то к первому набору применяется функция DrilldownMember(Set_Expression1, {m}[, RECURSIVE]).

Если указан необязательный флаг RECURSIVE, детализация углублением и обобщением выполняются рекурсивно. Дополнительные сведения о флаге рекурсии см. в описании функций DrillupMember и DrilldownMember.

Запрос свойства MdpropMdxDrillFunctions в XMLA позволяет проверить уровень поддержки, обеспечиваемой сервером для функций детализации. Подробные сведения см. в разделе Поддерживаемые свойства XML для аналитики (XMLA).

См. Журнал базы данных: набор функций многомерных выражений: функция ToggleDrillState(), где есть сценарии и примеры, включающие эту функцию.

Пример

В следующем примере выполняется детализация углублением элемента Australia в первом наборе и детализация обобщением элемента United States в первом наборе.

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]

См. также

Справочник

Справочник по функциям многомерных выражений (многомерные выражения)