16.20 - ウィンドウ集約UDF - Teradata Vantage NewSQL Engine

Teradata Vantage™ SQL演算子およびユーザー定義関数

prodname
Teradata Database
Teradata Vantage NewSQL Engine
vrm_release
16.20
category
プログラミング リファレンス
管理
featnum
B035-1210-162K-JPN

目的

ウィンドウの指定を集約UDF関数に適用すると、指定した複数の行から成るウィンドウに対して操作できるようになります。

構文





udf_name
ウィンドウの指定が適用される集約UDFの名前。
argument
有効なSQL式。
OVER

累計、グループ、または移動関数を計算する際に、値をグループ化、順序付け、および処理対象とする方法。

値は、PARTITION BY句およびRESET WHEN句に基づいてグループ化され、ORDER BY句に基づいてソートされ、パーティション内の集約グループに基づいて処理の対象とされます。

PARTITION BY

column_referenceの中に、または列参照のカンマ区切りのリストで、関数の実行対象のグループを指定(複数も可)。

PARTITION BYは任意指定です。PARTITION BY句またはRESET WHEN句を指定しない場合は、FROM句から送られる結果セット全体が、単一のグループまたはパーティションとなります。

PARTITION BY句は、ウィンドウ パーティション句と呼ばれることもあります。

ORDER BY
value_expressionの中の、グループまたはパーティション内の値のソート順序。
ASC
昇順のソート順序。デフォルトはASCです。
DESC
降順のソート順序。
RESET WHEN

順序付き分析関数の実行対象になるグループまたはパーティション。指定された条件の評価に応じて変化します。条件がTRUEと評価されると、指定されたウィンドウ パーティション内に新しい動的パーティションが作成されます。

RESET WHENは任意指定です。RESET WHEN句またはPARTITION BY句を指定しない場合は、FROM句から送られる結果セット全体が単一のパーティションになります。

RESET WHENを指定する場合は、ORDER BY句も指定する必要があります。

condition

条件によるパーティション化を決めるために使用する条件式。RESET WHEN句の条件は、QUALIFY句の条件と適用範囲は同じですが、ネストされた順序付き分析関数はRESET WHEN句を指定できないという追加の制約があります。また、条件内のsubqueryとしてのSELECTは指定できません。

条件は、指定されたすべてのウィンドウ パーティション内の行に適用され、そのウィンドウ パーティション内にサブパーティションを作成します。

詳細については、<Teradata Vantage™ SQL関数、式、および述部、B035-1145>の「RESET WHEN条件のルール」と<Teradata Vantage™ SQLデータ操作言語、B035-1146>の「QUALIFY句」を参照してください。

ROWS

パーティション内の集約グループの開始ポイント。集約グループの終了ポイントは現在行になります。

行Rの集約グループは、区分内の行の順序付けでのRに対して定義される行の集合です。

ROWSまたはROWS BETWEEN句がない場合のデフォルトの集約グループは、ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWINGです。

ROWS BETWEEN

集約グループの開始と終了。これにより、現在行を基準にした行の集合を、パーティション内の行の順序付けで定義します。

グループ開始として指定される行は、グループ終了として指定される行より前になければなりません。

ROWSまたはROWS BETWEEN句がない場合のデフォルトの集約グループは、ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWINGです。

UNBOUNDED PRECEDING
現在行より前にあるパーティション全体。
UNBOUNDED FOLLOWING
現在行より後にあるパーティション全体。
CURRENT ROW
現在行としての集約グループの開始または終了。
value PRECEDING

現在行より前にある行の数。

の値は、常に正の整数リテラルです。

value PRECEDINGがグループの開始またはグループの終了になる場合、集約グループ内の行の最大数は4096です。

value FOLLOWING

現在行より後にある行の数。

valueの値は、常に正の整数リテラルです。

value FOLLOWINGがグループの開始またはグループの終了になる場合、集約グループ内の行の最大数は4096です。