NTH_VALUE

ウィンドウフレームの N 番目の行に対して評価した式の値を返します。

この組み込みウィンドウ関数は、集約ウィンドウ関数と同じ方法で各行のウィンドウフレームを計算します。ウィンドウフレームの N 行目に対して評価した式の値を返します。ウィンドウフレーム内の行には、ORDER BY 句がある場合はその句で定義された順序で、ない場合は任意の順序で、1 から番号が付けられます。パーティションに N 番目の行がない場合は、NULL を返します。

関連項目： [SELECT] [FIRST_VALUE] [LAST_VALUE]

---

構文

SELECT NTH_VALUE(expr, N) OVER (
    [PARTITION BY column]
    ORDER BY column
    [ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;

引数

expr ウィンドウフレームの N 番目の行に対して評価する式。

N 取得する行番号を指定する正の整数（1 始まり）。

PARTITION BY column 省略可能。結果セットをパーティションに分割します。NTH_VALUE 関数は各パーティション内で個別に適用されます。

ORDER BY column 行を処理する順序を指定します。

ROWS BETWEEN frame_start AND frame_end 省略可能。ウィンドウフレームを定義します。

戻り値

ウィンドウフレームの N 番目の行に対して評価した式の値を返します。N 番目の行が存在しない場合は NULL を返します。

---

例

コントリビューション数が 2 番目に多いコントリビューターを取得する

-- Get the top 3 contributors by name for comparison
SELECT
    login,
    contributions,
    NTH_VALUE(login, 1) OVER (ORDER BY contributions DESC
        ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as top_contributor,
    NTH_VALUE(login, 2) OVER (ORDER BY contributions DESC
        ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as second_contributor,
    NTH_VALUE(login, 3) OVER (ORDER BY contributions DESC
        ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as third_contributor
FROM github.repos.contributors
WHERE owner = 'stackql'
  AND repo = 'stackql';

詳細については、https://sqlite.org/windowfunctions.html#built-in_window_functions を参照してください。