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

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

Возвращает первый родственный элемент среди потомков указанного уровня; по желанию можно указать элемент, потомок которого будет возвращаться.

Синтаксис

OpeningPeriod( [ Level_Expression [ , Member_Expression ] ] )

Аргументы

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

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

Замечания

Эта функция прежде всего предназначена для использования в измерении времени, но может быть использована и для других измерений.

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

Функция OpeningPeriod эквивалентна следующей инструкции многомерных выражений.

TopCount(Descendants(Member_Expression, Level_Expression), 1)

Примечание.
Функция ClosingPeriod аналогична функции OpeningPeriod, за исключением того, что функция ClosingPeriod возвращает не первый, а последний родственный элемент.

Примеры

В следующем примере возвращается значение меры по умолчанию для элемента FY2002 измерения Date (измерение времени). Этот элемент возвращается, поскольку уровень Fiscal Year — первый потомок уровня «Все». Иерархия Fiscal — иерархия по умолчанию, поскольку это первая пользовательская иерархия из коллекции иерархий. Элемент FY2002 — первый элемент этой иерархии данного уровня.

SELECT OpeningPeriod() ON 0
FROM [Adventure Works]

В следующем примере возвращается значение меры по умолчанию для элемента «1 июля 2001» уровня Date.Date.Date в иерархии атрибута Date.Date. Это первый элемент уровня «Все» в иерархии атрибута Date.Date.

SELECT OpeningPeriod([Date].[Date].[Date]) ON 0
FROM [Adventure Works]

В следующем примере возвращается значение меры по умолчанию для элемента January 2003, который является первым элементом из потомков элемента «2003» на уровне года в пользовательской иерархии Calendar.

SELECT OpeningPeriod([Date].[Calendar].[Month],[Date].[Calendar].[Calendar Year].&[2003]) ON 0
FROM [Adventure Works]

В следующем примере возвращается значение меры по умолчанию для элемента July 2003, который является первым элементом из потомков элемента «2003» на уровне года в пользовательской иерархии Fiscal.

SELECT OpeningPeriod([Date].[Fiscal].[Month],[Date].[Fiscal].[Fiscal Year].&[2003]) ON 0
FROM [Adventure Works]

См. также

Справочник

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

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

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

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

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