# FIRST_VALUE

> Віконна функція FIRST_VALUE у StackQL: значення виразу для першого рядка рамки вікна.

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

Повертає значення виразу, обчисленого для першого рядка в рамці вікна.

Ця вбудована віконна функція обчислює рамку вікна для кожного рядка так само, як агрегатна віконна функція. Для кожного рядка вона повертає значення виразу, обчисленого для першого рядка в рамці вікна.

Див. також:
[[` SELECT `]](/language-spec/select) [[` LAST_VALUE `]](/language-spec/functions/window/last_value) [[` NTH_VALUE `]](/language-spec/functions/window/nth_value)

* * *

## Синтаксис

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

## Аргументи

__*expr*__
Вираз, який обчислюється для першого рядка в рамці вікна.

__*PARTITION BY column*__
Необов'язковий. Поділяє набір результатів на секції. Функція `FIRST_VALUE` застосовується в межах кожної секції окремо.

__*ORDER BY column*__
Визначає порядок, у якому обробляються рядки.

__*ROWS BETWEEN frame_start AND frame_end*__
Необов'язковий. Визначає рамку вікна. Поширені варіанти:
- `ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW`
- `ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING`

Якщо речення рамки немає, то рамкою є `RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW`: вона закінчується на останньому рядку, що має з поточним рядком рівні значення в стовпцях `ORDER BY`, а не на поточному рядку.

## Значення, що повертається

Повертає значення виразу, обчисленого для першого рядка в рамці вікна.

* * *

## Приклади

### Пошук першого випуску для контексту

```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

За замовчуванням рамка вікна простягається від початку секції до останнього рядка, що має з поточним рядком рівні значення в стовпцях `ORDER BY`. Функція `FIRST_VALUE` читає перший рядок рамки, тому повертає те саме значення як із рамкою за замовчуванням, так і з `ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING`; явна рамка має значення для функцій `LAST_VALUE` і `NTH_VALUE`, які читають рядки далі в рамці.

:::

Докладніше див. [https://sqlite.org/windowfunctions.html#built-in_window_functions](https://sqlite.org/windowfunctions.html#built-in_window_functions).
