Outdated Version

You are viewing an older version of this section. View current production version.

LEAST

Returns the lowest value observed in its arguments. “Lowest” is determined by the collation rules of the data passed in.

Info

This function is not to be confused with MIN, which is an aggregate function returning the lowest value in all rows in an aggregation.

Syntax

LEAST ( expression, expression [, expression ...] )

Arguments

  • expression: any number of expressions. This may be a column name, the result of another function, or a math operation.

Return Type

The lowest value, in the type of the input.

For example, if all arguments are integers, they are compared as integers. If one argument is a decimal type, they are compared as decimal types. If arguments are a mix of strings and numbers, they are compared as numbers. If an argument is a nonbinary string, the arguments are compared as nonbinary strings.

Examples

select least(1, 2, 3);
+----------------+
| least(1, 2, 3) |
+----------------+
|              1 |
+----------------+

select least ('a', 'b', '_', '9', 'c');
+---------------------------------+
| least ('a', 'b', '_', '9', 'c') |
+---------------------------------+
| 9                               |
+---------------------------------+