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

> A função de agregação `singleValueOrNull` é usada para implementar operadores de subconsulta, como `x = ALL (SELECT ...)`. Ela verifica se há apenas um único valor único não `NULL` nos dados.

# singleValueOrNull

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

Introduzido em: v21.9.0

A função de agregação `singleValueOrNull` é usada para implementar operadores de subconsulta, como `x = ALL (SELECT ...)`. Ela verifica se há apenas um único valor não `NULL` nos dados.
Se houver apenas um único valor, ela o retorna. Se houver zero ou pelo menos dois valores distintos, ela retorna `NULL`.

**Sintaxe**

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

**Argumentos**

* `x` — Uma coluna de qualquer tipo de dado, exceto Map, Array ou Tuple, que não pode ser do tipo Nullable. [`Any`](/pt-BR/reference/data-types)

**Valor retornado**

Retorna o valor único se houver apenas um único valor diferente de `NULL` em `x`. Retorna `NULL` se houver zero ou pelo menos dois valores distintos. [`Any`](/pt-BR/reference/data-types) ou [`NULL`](/pt-BR/reference/syntax#null)

**Exemplos**

**Um único valor**

```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 │
└──────────────────────┘
```

**Múltiplos valores distintos**

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

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