# FIRST_VALUE

> Fungsi jendela FIRST_VALUE di StackQL: nilai ekspresi untuk baris pertama dari bingkai jendela.

Source: https://stackql.io/id/language-spec/functions/window/first_value

Mengembalikan nilai ekspresi yang dievaluasi terhadap baris pertama dalam bingkai jendela.

Fungsi jendela bawaan ini menghitung bingkai jendela untuk setiap baris dengan cara yang sama seperti fungsi jendela agregat. Fungsi ini mengembalikan nilai ekspresi yang dievaluasi terhadap baris pertama dalam bingkai jendela untuk setiap baris.

Lihat juga:
[[` SELECT `]](/language-spec/select) [[` LAST_VALUE `]](/language-spec/functions/window/last_value) [[` NTH_VALUE `]](/language-spec/functions/window/nth_value)

* * *

## Sintaksis

```sql
SELECT FIRST_VALUE(expr) OVER (
    [PARTITION BY column]
    ORDER BY column
    [ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;
```

## Argumen

__*expr*__
Ekspresi yang dievaluasi terhadap baris pertama dalam bingkai jendela.

__*PARTITION BY column*__
Opsional. Membagi kumpulan hasil menjadi partisi. Fungsi `FIRST_VALUE` diterapkan di dalam setiap partisi secara terpisah.

__*ORDER BY column*__
Menentukan urutan pemrosesan baris.

__*ROWS BETWEEN frame_start AND frame_end*__
Opsional. Menentukan bingkai jendela. Opsi yang umum meliputi:
- `ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW`
- `ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING`

Tanpa klausa bingkai, bingkai yang digunakan adalah `RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW`: bingkai ini berakhir pada baris terakhir yang seri dengan baris saat ini pada kolom `ORDER BY`, bukan pada baris saat ini.

## Nilai yang dikembalikan

Mengembalikan nilai ekspresi yang dievaluasi terhadap baris pertama dalam bingkai jendela.

* * *

## Contoh

### Menemukan rilis pertama sebagai konteks

```sql
-- Find first and latest release for context
SELECT
    tag_name,
    name,
    published_at,
    FIRST_VALUE(tag_name) OVER (
        ORDER BY published_at
        ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
    ) as first_release,
    LAST_VALUE(tag_name) OVER (
        ORDER BY published_at
        ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
    ) as latest_release
FROM github.repos.releases
WHERE owner = 'stackql'
  AND repo = 'stackql';
```

:::tip

Secara default, bingkai jendela membentang dari awal partisi hingga baris terakhir yang seri dengan baris saat ini pada kolom `ORDER BY`. Fungsi `FIRST_VALUE` membaca baris pertama bingkai, sehingga fungsi ini mengembalikan nilai yang sama dengan bingkai default maupun dengan `ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING`; bingkai eksplisit berpengaruh untuk fungsi `LAST_VALUE` dan `NTH_VALUE`, yang membaca lebih jauh ke dalam bingkai.

:::

Untuk informasi selengkapnya, lihat [https://sqlite.org/windowfunctions.html#built-in_window_functions](https://sqlite.org/windowfunctions.html#built-in_window_functions).
