> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> C'est un alias de any, mais il a été introduit pour des raisons de compatibilité avec les fonctions de fenêtre, pour lesquelles il est parfois nécessaire de traiter les valeurs `NULL` (par défaut, toutes les fonctions d'agrégation de ClickHouse ignorent les valeurs `NULL`).

# first_value

C'est un alias de [`any`](/fr/reference/functions/aggregate-functions/any), mais il a été introduit pour des raisons de compatibilité avec les [fonctions de fenêtre](/fr/reference/functions/window-functions/index), pour lesquelles il est parfois nécessaire de traiter les valeurs `NULL` (par défaut, toutes les fonctions d'agrégation de ClickHouse ignorent les valeurs `NULL`).

Il est possible de déclarer un modificateur pour respecter les valeurs `NULL` (`RESPECT NULLS`), aussi bien avec les [fonctions de fenêtre](/fr/reference/functions/window-functions/index) que dans les agrégations classiques.

Comme avec `any`, en dehors des fonctions de fenêtre, le résultat sera aléatoire si le flux source n'est pas ordonné, et le type de retour
correspond au type d'entrée (`NULL` n'est renvoyé que si l'entrée est `Nullable` ou si le combinator `-OrNull` est ajouté).

<div id="examples">
  ## exemples
</div>

```sql theme={null}
CREATE TABLE test_data
(
    a Int64,
    b Nullable(Int64)
)
ENGINE = Memory;

INSERT INTO test_data (a, b) VALUES (1,null), (2,3), (4, 5), (6,null);
```

<div id="example1">
  ### Exemple 1
</div>

Par défaut, la valeur NULL est ignorée.

```sql theme={null}
SELECT first_value(b) FROM test_data;
```

```text theme={null}
┌─any(b)─┐
│      3 │
└────────┘
```

<div id="example2">
  ### Exemple 2
</div>

La valeur NULL est ignorée.

```sql theme={null}
SELECT first_value(b) ignore nulls FROM test_data
```

```text theme={null}
┌─any(b) IGNORE NULLS ─┐
│                    3 │
└──────────────────────┘
```

<div id="example3">
  ### Exemple 3
</div>

La valeur NULL est acceptée.

```sql theme={null}
SELECT first_value(b) respect nulls FROM test_data
```

```text theme={null}
┌─any(b) RESPECT NULLS ─┐
│                  ᴺᵁᴸᴸ │
└───────────────────────┘
```

<div id="example4">
  ### Exemple 4
</div>

Résultat stabilisé grâce à la sous-requête avec `ORDER BY`.

```sql theme={null}
SELECT
    first_value_respect_nulls(b),
    first_value(b)
FROM
(
    SELECT *
    FROM test_data
    ORDER BY a ASC
)
```

```text theme={null}
┌─any_respect_nulls(b)─┬─any(b)─┐
│                 ᴺᵁᴸᴸ │      3 │
└──────────────────────┴────────┘
```