FOR_MIN

9min
This article will show you how to get some value based on the minimum metric from a set of values.
OverviewFOR_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.
ExamplesWe 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 tableFor 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 clauseFor 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 11 May 2023
Did this page help you?
Yes
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