Catégories :

Fonctions d’expressions conditionnelles

LEAST

Renvoie la plus petite valeur d’une liste d’expressions. LEAST prend en charge tous les types de données, y compris VARIANT.

Voir aussi :

LEAST_IGNORE_NULLS

Syntaxe

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

Arguments

exprN

Les arguments doivent inclure au moins une expression. Toutes les expressions doivent être du même type ou de types compatibles.

Renvoie

Le premier argument détermine le type de renvoi :

  • Si le premier type est numérique, le type de renvoi sera « élargi » en fonction des types numériques de la liste de tous les arguments.

  • Si le premier type n’est pas numérique, tous les autres arguments doivent être convertibles en premier type.

Si un argument est NULL, renvoie NULL.

Détails du classement

  • 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.

Exemples

Les exemples suivants utilisent la fonction 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 |
+-------+-------+-------+-------+