min-transact-sql.md

title	description	author	ms.author	ms.date	ms.service	ms.subservice	ms.topic	f1_keywords	helpviewer_keywords	dev_langs	monikerRange
MIN (Transact-SQL)	MIN (Transact-SQL)	markingmyname	maghan	03/13/2017	sql	t-sql	reference	MIN MIN_TSQL	MIN function [Transact-SQL] minimum values [SQL Server] values [SQL Server], minimum	TSQL	>= aps-pdw-2016 || = azuresqldb-current || = azure-sqldw-latest || >= sql-server-2016 || >= sql-server-linux-2017 || = azuresqldb-mi-current||=fabric

MIN (Transact-SQL)

[!INCLUDE sql-asdb-asdbmi-asa-pdw-fabricse-fabricdw]

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

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

-- Aggregation Function Syntax MIN ( [ ALL | DISTINCT ] expression ) -- Analytic Function Syntax MIN ( [ ALL ] expression ) OVER ( [ <partition_by_clause> ] [ <order_by_clause> ] ) 

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 ISO 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, uniqueidentifier, or datetime columns, but not with bit columns. Aggregate functions and subqueries are not permitted.

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

OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause divides the result set produced by the FROM clause into partitions to which the function is applied. If not specified, the function treats all rows of the query result set as a single group. order_by_clause determines the logical order in which the operation is performed. order_by_clause is required. For more information, see OVER Clause (Transact-SQL).

Return Types

Returns a value same as expression.

Remarks

MIN ignores any null values.

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

MIN is a deterministic function when used without the OVER and ORDER BY clauses. It is nondeterministic when specified with the OVER and ORDER BY clauses. For more information, see Deterministic and Nondeterministic Functions.

Examples

A. Simple example

The following example returns the lowest (minimum) tax rate. The example uses the [!INCLUDEssSampleDBnormal] database

SELECTMIN(TaxRate) FROMSales.SalesTaxRate; GO 

[!INCLUDEssResult]

------------------- 5.00 (1 row(s) affected) 

B. Using the OVER clause

The following example uses the MIN, MAX, AVG and COUNT functions with the OVER clause to provide aggregated values for each department in the HumanResources.Department table in the [!INCLUDEssSampleDBnormal] database.

SELECT DISTINCT Name , MIN(Rate) OVER (PARTITION BY edh.DepartmentID) AS MinSalary , MAX(Rate) OVER (PARTITION BY edh.DepartmentID) AS MaxSalary , AVG(Rate) OVER (PARTITION BY edh.DepartmentID) AS AvgSalary ,COUNT(edh.BusinessEntityID) OVER (PARTITION BY edh.DepartmentID) AS EmployeesPerDept FROMHumanResources.EmployeePayHistoryAS eph JOINHumanResources.EmployeeDepartmentHistoryAS edh ONeph.BusinessEntityID=edh.BusinessEntityIDJOINHumanResources.DepartmentAS d ONd.DepartmentID=edh.DepartmentIDWHEREedh.EndDate IS NULLORDER BY Name; 

[!INCLUDEssResult]

Name MinSalary MaxSalary AvgSalary EmployeesPerDept ----------------------------- --------------------- --------------------- --------------------- ---------------- Document Control 10.25 17.7885 14.3884 5 Engineering 32.6923 63.4615 40.1442 6 Executive 39.06 125.50 68.3034 4 Facilities and Maintenance 9.25 24.0385 13.0316 7 Finance 13.4615 43.2692 23.935 10 Human Resources 13.9423 27.1394 18.0248 6 Information Services 27.4038 50.4808 34.1586 10 Marketing 13.4615 37.50 18.4318 11 Production 6.50 84.1346 13.5537 195 Production Control 8.62 24.5192 16.7746 8 Purchasing 9.86 30.00 18.0202 14 Quality Assurance 10.5769 28.8462 15.4647 6 Research and Development 40.8654 50.4808 43.6731 4 Sales 23.0769 72.1154 29.9719 18 Shipping and Receiving 9.00 19.2308 10.8718 6 Tool Design 8.62 29.8462 23.5054 6 (16 row(s) affected) 

Examples: [!INCLUDEssazuresynapse-md] and [!INCLUDEssPDW]

C. Using MIN

The following example uses the MIN aggregate function to return the price of the least expensive (minimum) product in a specified set of sales orders.

-- Uses AdventureWorks SELECT DISTINCTMIN(UnitPrice) FROMdbo.FactResellerSalesWHERE SalesOrderNumber IN (N'SO43659', N'SO43660', N'SO43664'); 

[!INCLUDEssResult]

------ 5.1865 

D. Using MIN with OVER

The following examples use the MIN OVER() analytic function to return the price of the least expensive product in each sales order. The result set is partitioned by the SalesOrderID column.

-- Uses AdventureWorks SELECT DISTINCTMIN(UnitPrice) OVER(PARTITION BY SalesOrderNumber) AS LeastExpensiveProduct, SalesOrderNumber FROMdbo.FactResellerSalesWHERE SalesOrderNumber IN (N'SO43659', N'SO43660', N'SO43664') ORDER BY SalesOrderNumber; 

[!INCLUDEssResult]

LeastExpensiveProduct SalesOrderID --------------------- ---------- 5.1865 SO43659 419.4589 SO43660 28.8404 SO43664 

See Also

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