MIN (Transact-SQL)

Returns the minimum value in the expression. May be followed by the OVER clause.

Topic link iconTransact-SQL Syntax Conventions

Syntax

MIN ( [ ALL | DISTINCT ] expression ) 

Arguments

  • ALL
    Applies the aggregate function to all values. ALL is the default.
  • DISTINCT
    Specifies that each unique value is considered. DISTINCT is not meaningful with MIN and is available for SQL-92 compatibility only.
  • expression
    Is a constant, column name, or function, and any combination of arithmetic, bitwise, and string operators. MIN can be used with numeric, char, varchar, or datetime columns, but not with bit columns. Aggregate functions and subqueries are not permitted.

    For more information, see Expressions (Transact-SQL).

Return Types

Returns a value same as expression.

Important

Distinct aggregates, for example AVG(DISTINCT column_name), COUNT(DISTINCT column_name), MAX(DISTINCT column_name), MIN(DISTINCT column_name), and SUM(DISTINCT column_name), are not supported when you use CUBE or ROLLUP. If they are used, Microsoft SQL Server 2005 Database Engine returns an error message and ends the query.

Remarks

MIN ignores any null values.

With character data columns, MIN finds the value that is lowest in the sort sequence.

Examples

The following example returns the lowest (minimum) tax rate.

USE AdventureWorks;
GO
SELECT MIN(TaxRate)
FROM Sales.SalesTaxRate;
GO

Here is the result set.

-------------------
5.00

(1 row(s) affected)

See Also

Reference

Aggregate Functions (Transact-SQL)
MAX (Transact-SQL)
OVER Clause (Transact-SQL)

Help and Information

Getting SQL Server 2005 Assistance