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.

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

См. журнал базы данных: Функции SET многомерных выражений: Функция 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]

См. также

Справочник

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