Categorias:: Funções de expressão condicional

LEAST¶

Retorna o menor valor de uma lista de expressões. LEAST oferece suporte a todos os tipos de dados, inclusive VARIANT.

Consulte também:: LEAST_IGNORE_NULLS

Sintaxe¶

LEAST(( <expr1> [ , <expr2> ... ] )

Copy

Argumentos¶

exprN: Os argumentos devem incluir pelo menos uma expressão. Todas as expressões devem ser do mesmo tipo ou de tipos compatíveis.

Retornos¶

O primeiro argumento determina o tipo de retorno:

Se o primeiro tipo for numérico, então o tipo de retorno é ‘ampliado’ de acordo com os tipos numéricos na lista de todos os argumentos.
Se o primeiro tipo não for numérico, então todos os outros argumentos devem ser conversíveis para o primeiro tipo.

Se algum argumento for NULL, retorna NULL.

Detalhes do agrupamento¶

The collation specifications of all input arguments must be compatible.
The comparisons follow the collation based on the input arguments” collations and precedences.
The collation of the result of the function is the highest-precedence collation of the inputs.

Exemplos¶

Os exemplos a seguir usam a função LEAST:

SELECT LEAST(1, 3, 0, 4);

Copy

+-------------------+
| LEAST(1, 3, 0, 4) |
|-------------------|
|                 0 |
+-------------------+

SELECT col_1,
       col_2,
       col_3,
       LEAST(col_1, col_2, col_3) AS least
  FROM (SELECT 1 AS col_1, 2 AS col_2, 3 AS col_3
    UNION ALL
    SELECT 2, 4, -1
    UNION ALL
    SELECT 3, 6, NULL);

Copy

+-------+-------+-------+-------+
| COL_1 | COL_2 | COL_3 | LEAST |
|-------+-------+-------+-------|
|     1 |     2 |     3 |     1 |
|     2 |     4 |    -1 |    -1 |
|     3 |     6 |  NULL |  NULL |
+-------+-------+-------+-------+