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