​
Overview

FOR_MIN() function takes two arguments: metric and value. Returns a value corresponding to the minimal metric in the same row from a set of values.

The metric argument can be one of the following types:

  • INT

  • LONG

  • FLOAT

  • DOUBLE

  • DATE

  • TIMESTAMP

The value argument can be of any type except STRING.

💡Special cases:

  • Returns NULL if:

    • there are no input rows

    • the metric column has only NULL values

    • the value corresponding to the minimum metric is NULL.

  • Returns NaN if the input contains a NaN.

​
Examples

We have a payments table that stores the records of payments by customers, along with discounts applied during the payment:

CREATE TABLE payments (
    paymentid int,
    customer_name string,
    price real,
    discount real
);
INSERT INTO payments (paymentid, customer_name, price, discount)
VALUES 
(1, 'Alex', 280.12, 0.1),
(2, NULL, 35.75, NULL),
(3, 'Alex', 45.1, 0.05),
(4, 'Alex', NULL, 0.4),
(5, 'John', NULL, 0.1),
(6, 'Bob', 50.45, 0.07),
(7, 'Bob', 120.5, 0.0);

SELECT * FROM payments;

It will create a table as shown below:

+-----------+---------------+--------+----------+
| paymentid | customer_name | price  | discount |
+-----------+---------------+--------+----------+
|         2 |               |  35.75 |          |
|         4 | Alex          |        |      0.4 |
|         3 | Alex          |   45.1 |     0.05 |
|         1 | Alex          | 280.12 |      0.1 |
|         6 | Bob           |  50.45 |     0.07 |
|         5 | John          |        |      0.1 |
|         7 | Bob           |  120.5 |        0 |
+-----------+---------------+--------+----------+

​
#Case 1: FOR_MIN() on the whole table

For example, let’s check the price for the lowest discount applied to it:

SELECT FOR_MIN(discount, price) AS for_lowest_discount
FROM payments;

It will return the following output:

+---------------------+
| for_lowest_discount |
+---------------------+
|               120.5 |
+---------------------+

​
#Case 2: FOR_MIN() with GROUP BY clause

For this example, we use a GROUP BY clause to group the customers, then use FOR_MIN() to get a discount for the lowest price paid by each customer.

SELECT customer_name, FOR_MIN(price, discount) AS discount
FROM payments
GROUP BY customer_name;

Which will give the following result:

+---------------+----------+
| customer_name | discount |
+---------------+----------+
|               |          |
| Bob           |     0.07 |
| Alex          |     0.05 |
| John          |          |
+---------------+----------+
FOR_MAXMAX