FOR_MIN

7min
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 a Table
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);
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);
﻿
Display the Table
SELECT * FROM payments;
SELECT * FROM payments;
﻿
It will create a table as shown below:
The payments Table
+-----------+---------------+--------+----------+
| 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 |
+-----------+---------------+--------+----------+
+-----------+---------------+--------+----------+
| 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
SELECT FOR_MIN(discount, price) AS for_lowest_discount
FROM payments;
SELECT FOR_MIN(discount, price) AS for_lowest_discount
FROM payments;
﻿
It will return the following output:
Output
+---------------------+
| for_lowest_discount |
+---------------------+
|               120.5 |
+---------------------+
+---------------------+
| 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 for_min
SELECT customer_name, FOR_MIN(price, discount) AS discount
FROM payments
GROUP BY customer_name;
SELECT customer_name, FOR_MIN(price, discount) AS discount
FROM payments
GROUP BY customer_name;
﻿
Which will give the following result:
Output
+---------------+----------+
| customer_name | discount |
+---------------+----------+
|               |          |
| Bob           |     0.07 |
| Alex          |     0.05 |
| John          |          |
+---------------+----------+
+---------------+----------+
| customer_name | discount |
+---------------+----------+
|               |          |
| Bob           |     0.07 |
| Alex          |     0.05 |
| John          |          |
+---------------+----------+
﻿
﻿
Updated 09 Oct 2023
Did this page help you?
MIN
MAX
Docs powered by Archbee
TABLE OF CONTENTS
Overview
Examples
#Case 1: FOR_MIN() on the whole table
#Case 2: FOR_MIN() with GROUP BY clause