SQLite: min Function

This SQLite post explains how to use the SQLite min function with syntax and examples.

Description

The SQLite min function returns the minimum value of an expression.

Syntax

The syntax for the min function in SQLite is:

SELECT min(aggregate_expression)
FROM tables
[WHERE conditions];

OR the syntax for the min function when grouping the results by one or more columns is:

SELECT expression1, expression2, ... expression_n,
       min(aggregate_expression)
FROM tables
[WHERE conditions]
GROUP BY expression1, expression2, ... expression_n;

Parameters or Arguments

expression1, expression2, ... expression_n

Expressions that are not encapsulated within the min function and must be included in the GROUP BY clause at the end of the SQL statement.

aggregate_expression

This is the column or expression from which the minimum value will be returned.

tables

The tables that you wish to retrieve records from. There must be at least one table listed in the FROM clause.

WHERE conditions

Optional. These are conditions that must be met for the records to be selected.

Applies To

The min function can be used in the following versions of SQLite:

• SQLite 3.8.6, SQLite 3.8.x, SQLite 3.7.x, SQLite 3.6.x

Example - With Single Expression

Let's look at some SQLite min function examples and explore how to use the min function in SQLite.

For example, you might wish to know how the minimum salary of all employees.

SELECT min(salary) AS "Lowest Salary"
FROM employees;

In this min function example, we've aliased the min(salary) expression as "Lowest Salary".

Example - Using GROUP BY

In some cases, you will be required to use the GROUP BY clause with the min function.

For example, you could also use the min function to return the city and the minimum salary in that city where the state is 'AZ'.

SELECT city, min(salary) AS "Lowest salary"
FROM employees
WHERE state = 'AZ'
GROUP BY city;

Because you have listed one column in your SELECT statement that is not encapsulated in the min function, you must use a GROUP BY clause. The city field must, therefore, be listed in the GROUP BY section.