../E23381-01.epub /> ../E23381-01.mobi />

HIER_LEVEL

HIER_LEVEL returns the level of either all members of a hierarchy or a particular member. The hierarchy must be level-based.

Return Value

VARCHAR2

Syntax

HIER_LEVEL ( 
   [member_expression] [WITHIN]
   {DIMENSION dimension_id | HIERARCHY hierarchy_id} ) 

Arguments

member_expression

Identifies a single dimension member within the hierarchy used for the calculation. If this optional argument is specified, then the result does not vary across dimension members.

dimension_id

The dimension over which the values are calculated using the default hierarchy.

hierarchy_id

The hierarchy over which the values are calculated. If dimension_id is used instead, the default hierarchy is used.

Example

This example returns the level of each member of the default hierarchy of the Time dimension.

HIER_LEVEL(DIMENSION "TIME")

Time Level
2006 CALENDAR_YEAR
Q1.06 CALENDAR_QUARTER
Q2.06 CALENDAR_QUARTER
Q3.06 CALENDAR_QUARTER
Q4.06 CALENDAR_QUARTER
JAN-06 MONTH
FEB-06 MONTH
MAR-06 MONTH
APR-06 MONTH
MAY-06 MONTH
JUN-06 MONTH
JUL-06 MONTH
AUG-06 MONTH
SEP-06 MONTH
OCT-06 MONTH
NOV-06 MONTH
DEC-06 MONTH

The next example returns ACCOUNT as the level of Business World in the Market hierarchy of the Customer dimension.

HIER_LEVEL('BUSN WRLD' WITHIN HIERARCHY CUSTOMER.MARKET)