LEAD

LEADは、将来の期間に関する式の値を返します。

戻り値

値式と同じデータ型

構文

LEAD (lead_args) OVER (lead_clause)

lead_args::=

expression, offset [, {default_expression | CLOSEST} ]

lead_clause::=

[ {DIMENSION dimension_id | HIERARCHY hierarchy_id} ]
[ [BY] { LEVEL 
       | PARENT 
       | GREGORIAN {YEAR | QUARTER | MONTH | WEEK | DAY}
       | ANCESTOR AT { DIMENSION LEVEL dim_level_id
                      | HIERARCHY LEVEL hier_level_id
                      }
       }
                [POSITION FROM {BEGINNING | END}] 
]

引数

expression

計算する値を含むディメンション式。

offset

現行期間からいくつ後の期間に進むかを表す数値式です。

default_expression

offsetで有効な期間が指定されない場合に返される値です。この句は、任意のデータ型の式、または近接を表すキーワードCLOSESTです。近接とは、前方に移動した場合の直後のメンバーです。

dimension_id

リードを計算する時間ディメンションです。

hierarchy_id

リードを計算する階層です。指定しない場合は、dimension_idのデフォルト階層が使用されます。

dim_level_id

dimension_idのレベルの名前。

hier_level_id

hierarchy_idのレベルの名前。

BY副句

BY副句はオフセットの計算に使用する期間の範囲を指定します。次は、キーワードの説明です。

オフセット･ユニット	説明
`LEVEL`	現行メンバーよりも`offset`の期間数分後の、同一レベルのメンバーです。(デフォルト)
`PARENT`	現行メンバーよりも`offset`の期間数分後の、同じ親を持つ同一レベルのメンバーです。
`GREGORIAN YEAR`	開始日が、現行期間の開始日よりも`offset`の年数分後の、同一レベルの期間です。
`GREGORIAN QUARTER`	開始日が、現行期間の開始日よりも`offset`の四半期数分後の、同一レベルの期間です。
`GREGORIAN MONTH`	開始日が、現行期間の開始日よりも`offset`の月数分後の、同一レベルの期間です。
`GREGORIAN WEEK`	開始日が、現行期間の開始日よりも`offset`の週数分後の、同一レベルの期間です。
`GREGORIAN DAY`	開始日が、現行期間の開始日よりも`offset`の日数分後の、同一レベルの期間です。
`ANCESTOR`	現行期間と同じレベルにあり、祖先が現行期間の祖先よりも後の`offset`位置にある期間です。

例

この計算は、カレンダ四半期に基づく次の期間の値を返します。この計算の出力例を「次の四半期」列に示します。

LEAD (GLOBAL.UNITS_CUBE.UNITS, 1, CLOSEST) OVER (DIMENSION GLOBAL.TIME BY ANCESTOR AT DIMENSION LEVEL GLOBAL.TIME.CALENDAR_QUARTER)

時間	親	ユニット	次の四半期
`2005`	TOTAL	565718	--
`Q1-05`	CY2005	143607	138096
`Q2-05`	CY2005	138096	138953
`Q3-05`	CY2005	138953	145062
`Q4-05`	CY2005	145062	146819
`Jan-05`	CY2005.Q1	50098	40223
`Feb-05`	CY2005.Q1	43990	45477
`Mar-05`	CY2005.Q1	49519	52396
`Apr-05`	CY2005.Q2	40223	45595
`May-05`	CY2005.Q2	45477	46882
`Jun-05`	CY2005.Q2	52396	46476
`Jul-05`	CY2005.Q3	45595	47476
`Aug-05`	CY2005.Q3	46882	47496
`Sep-05`	CY2005.Q3	46476	50090
`Oct-05`	CY2005.Q4	47476	47776
`Nov-05`	CY2005.Q4	47496	47695
`Dec-05`	CY2005.Q4	50090	51348