window frame 句

適用対象: Databricks SQL Databricks Runtime

集計または分析ウィンドウ関数が動作するパーティション内の行のスライディング サブセットを指定します。

構文

{ frame_mode frame_start |
  frame_mode BETWEEN frame_start AND frame_end } }

frame_mode
{ RANGE | ROWS }

frame_start
{ UNBOUNDED PRECEDING |
  offset_start PRECEDING |
  CURRENT ROW |
  offset_start FOLLOWING }

frame_end
{ offset_stop PRECEDING |
  CURRENT ROW |
  offset_stop FOLLOWING |
  UNBOUNDED FOLLOWING }

パラメーター

• frame_mode

  • ROWS

    指定した場合、スライディング ウィンドウ フレームは、現在の行の前または後の行の観点から表されます。

  • RANGE

    指定する場合、ウィンドウ関数では、1 つの式 obExpr で ORDER BY clause 句を指定する必要があります。

    スライディング ウィンドウの境界は、現在の行の obExpr からのオフセットとして表されます。

• frame_start

  現在の行を基準にしたスライディング ウィンドウ フレームの開始位置。

  • UNBOUNDED PRECEDING

    ウィンドウ フレームがパーティションの先頭から始まることを指定します。

  • offset_start PRECEDING

    モードが ROWS の場合、offset_start はフレームが開始する現在の行の前の行数を定義する正の整数リテラル数です。

    モードが RANGE の場合、offset_start は obExpr から減算できる型の正のリテラル値です。 フレームは、obExpr が現在の行の obExpr - offset_start 以上のパーティションの最初の行から始まります。

  • CURRENT ROW

    フレームが現在の行から始まることを指定します。

  • offset_start FOLLOWING

    モードが ROWS の場合、offset_start はフレームが開始する現在の行の後の行数を定義する正の整数リテラル数です。 モードが RANGE の場合、offset_start は obExpr に追加できる型の正のリテラル値です。 フレームは、obExpr が現在の行の obExpr + offset_start 以上のパーティションの最初の行から始まります。

• frame_stop

  現在の行を基準にしたスライディング ウィンドウ フレームの末尾。

  指定しない場合、フレームは CURRENT ROW で停止します。 スライディング ウィンドウの末尾は、ウィンドウ フレームの始点を超える必要があります。

  • offset_start PRECEDING

    frame_mode が ROWS の場合、offset_stop はフレームが停止する現在の行の前の行数を定義する正の整数リテラル数です。 frame_mode が RANGE の場合、offset_stop は offset_start と同じ型の正のリテラル値です。 フレームは、obExpr が現在の行の obExpr - offset_stop 以下のパーティションの最後の行で終了します。

  • CURRENT ROW

    フレームが現在の行で停止することを指定します。

  • offsetStop FOLLOWING

    frame_mode が ROWS の場合、offset_stop はフレームが終了する現在の行の後の行数を定義する正の整数リテラル数です。 frame_mode が RANGE の場合、offset_stop は offset_start と同じ型の正のリテラル値です。 フレームは、obExpr が現在の行の obExpr + offset_stop 以下のパーティションの最後の行で終了します。

  • UNBOUNDED FOLLOWING

    ウィンドウ フレームがパーティションの末尾で停止することを指定します。

関連記事

• ウィンドウ関数