lagInFrame

並び替えられたフレーム内で、現在の行から指定された物理オフセット分だけ前にある行で評価された値を返します。

注記

lagInFrame の動作は、標準 SQL の lag ウィンドウ関数とは異なります。 ClickHouse のウィンドウ関数 lagInFrame は、ウィンドウフレームの定義を厳密に考慮して動作します。 lag と同一の動作を得るには、ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING を使用してください。

構文

lagInFrame(x[, offset[, default]])
  OVER ([[PARTITION BY grouping_column] [ORDER BY sorting_column]
        [ROWS or RANGE expression_to_bound_rows_withing_the_group]] | [window_name])
FROM table_name
WINDOW window_name as ([[PARTITION BY grouping_column] [ORDER BY sorting_column])

ウィンドウ関数の構文の詳細については次を参照してください: Window Functions - Syntax。

パラメーター

• x — 列名。
• offset — 適用するオフセット。(U)Int*。（省略可能 — 省略時のデフォルトは 1）
• default — 計算対象の行がウィンドウフレームの境界を超えた場合に返す値。（省略可能 — 省略時は列型のデフォルト値）

戻り値

• 順序付けされたフレーム内で、現在の行から指定された物理オフセットだけ前方にある行において評価される値。

例

この例では、特定の銘柄の過去データを参照し、lagInFrame 関数を使用して株価終値の日次差分と変化率を計算します。

クエリ:

CREATE TABLE stock_prices
(
    `date`   Date,
    `open`   Float32, -- 始値
    `high`   Float32, -- 高値
    `low`    Float32, -- 安値
    `close`  Float32, -- 終値
    `volume` UInt32   -- 出来高
)
Engine = Memory;

INSERT INTO stock_prices FORMAT Values
    ('2024-06-03', 113.62, 115.00, 112.00, 115.00, 438392000),
    ('2024-06-04', 115.72, 116.60, 114.04, 116.44, 403324000),
    ('2024-06-05', 118.37, 122.45, 117.47, 122.44, 528402000),
    ('2024-06-06', 124.05, 125.59, 118.32, 121.00, 664696000),
    ('2024-06-07', 119.77, 121.69, 118.02, 120.89, 412386000);

SELECT
    date,
    close,
    lagInFrame(close, 1, close) OVER (ORDER BY date ASC
       ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
     ) AS previous_day_close,
    COALESCE(ROUND(close - previous_day_close, 2)) AS delta,
    COALESCE(ROUND((delta / previous_day_close) * 100, 2)) AS percent_change
FROM stock_prices
ORDER BY date DESC

結果：

   ┌───────日付─┬──終値─┬─前日終値─┬─変動─┬─変動率─┐
1. │ 2024-06-07 │ 120.89 │                121 │ -0.11 │          -0.09 │
2. │ 2024-06-06 │    121 │             122.44 │ -1.44 │          -1.18 │
3. │ 2024-06-05 │ 122.44 │             116.44 │     6 │           5.15 │
4. │ 2024-06-04 │ 116.44 │                115 │  1.44 │           1.25 │
5. │ 2024-06-03 │    115 │                115 │     0 │              0 │
   └────────────┴────────┴────────────────────┴───────┴────────────────┘