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

Изменения: 17 июля 2006 г.

Возвращает кортеж, состоящий из элементов All каждой иерархии атрибута в текущей области куба, измерения или кортежа. Дополнительные сведения о функции Scope см. в разделе Инструкция SCOPE (многомерные выражения).

Примечание.
Если иерархия атрибутов не содержит элемент All, кортеж будет состоять из элемента по умолчанию для данной иерархии.

Синтаксис

Cube syntax
Root ()
Dimension syntax
Root( Dimension_Name )
Tuple syntax
Root( Tuple_Expression ] )

Аргументы

• Dimension_Name
  Допустимое строковое выражение, задающее имя измерения.

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

Замечания

Если ни имя измерения, ни выражение кортежа не заданы, функция Root возвращает кортеж, содержащий элемент All (или элемент по умолчанию, если элемент All не существует) из всех иерархий атрибута в кубе. Порядок элементов в кортеже основан на той последовательности, в которой иерархии атрибутов определены в кубе.

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

Примечание.
Если имя иерархии указано, функция Tuple выберет имя измерения из указанного имени иерархии.

Если выражение кортежа указано, функция Root возвращает кортеж, содержащий пересечение заданного кортежа и элементов All из всех других атрибутов измерения, не включенных явно в заданный кортеж. Заданный кортеж должен ссылаться только на одно измерение, в противном случае возникает ошибка.

Примеры

В следующем примере возвращается кортеж, содержащий элемент All (или элемент по умолчанию, если элемент All не существует) из всех иерархий куба «Adventure Works».

SELECT Root()ON 0
FROM [Adventure Works]

В следующем примере возвращается кортеж, содержащий элемент All (или элемент по умолчанию, если элемент All не существует) из всех иерархий измерения «Date» куба «Adventure Works» и значение указанного элемента измерения «Measures», пересекающееся с этими элементами по умолчанию.

SELECT Root([Date]) ON 0
FROM [Adventure Works]
WHERE [Measures].[Order Count]

В следующем примере возвращается кортеж, содержащий указанный элемент кортежа (1 июля 2001 г) и элемент All (или элемент по умолчанию, если элемент All не существует) из всех неуказанных иерархий измерения «Date» куба «Adventure Works» и значение указанного элемента измерения «Measures», пересекающееся с этими элементами.

SELECT Root([Date].[July 1, 2001]) ON 0
FROM [Adventure Works]
WHERE [Measures].[Order Count]

См. также

Справочник

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

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Измененное содержимое Обновлены синтаксис и аргументы для облегчения понимания. Добавлены обновленные примеры.