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

> La fonction d’agrégation `singleValueOrNull` est utilisée pour implémenter des opérateurs de sous-requête, tels que `x = ALL (SELECT ...)`. Elle vérifie s’il n’existe qu’une seule valeur unique non-NULL dans les données.

# singleValueOrNull

<div id="singleValueOrNull">
  ## singleValueOrNull
</div>

Introduit dans : v21.9.0

La fonction d'agrégation `singleValueOrNull` est utilisée pour implémenter des opérateurs de sous-requête, tels que `x = ALL (SELECT ...)`. Elle vérifie s'il existe une seule valeur unique non NULL dans les données.
S'il n'y a qu'une seule valeur unique, elle la renvoie. S'il y a zéro ou au moins deux valeurs distinctes, elle renvoie NULL.

**Syntaxe**

```sql theme={null}
singleValueOrNull(x)
```

**Arguments**

* `x` — Une colonne de n’importe quel type de données, sauf Map, Array ou Tuple, qui ne peut pas être de type Nullable. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie la valeur s’il n’existe qu’une seule valeur distincte non-NULL dans `x`. Renvoie `NULL` s’il y a zéro ou au moins deux valeurs distinctes. [`Any`](/fr/reference/data-types/index) ou [`NULL`](/fr/reference/syntax#null)

**Exemples**

**Valeur unique**

```sql title=Query theme={null}
CREATE TABLE test (x UInt8 NULL) ENGINE=Log;
INSERT INTO test (x) VALUES (NULL), (NULL), (5), (NULL), (NULL);
SELECT singleValueOrNull(x) FROM test;
```

```response title=Response theme={null}
┌─singleValueOrNull(x)─┐
│                    5 │
└──────────────────────┘
```

**Plusieurs valeurs distinctes**

```sql title=Query theme={null}
INSERT INTO test (x) VALUES (10);
SELECT singleValueOrNull(x) FROM test;
```

```response title=Response theme={null}
┌─singleValueOrNull(x)─┐
│                 ᴺᵁᴸᴸ │
└──────────────────────┘
```