MIN (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Retourne la valeur minimale de l'expression. Cette fonction peut être suivie par la clause OVER.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

ALL
Applique la fonction d'agrégation à toutes les valeurs. ALL est l'argument par défaut.

DISTINCT
Spécifie que chaque valeur unique est prise en considération. DISTINCT n'a pas d'effet avec MIN et n'est disponible que pour la compatibilité ISO.

expression
Constante, nom de colonne ou fonction, et toute combinaison d'opérateurs arithmétiques, de type chaîne ou binaire. La fonction MIN peut être utilisée avec des colonnes numeric, char, varchar, uniqueidentifier ou datetime, mais pas avec des colonnes bit. Les fonctions d'agrégation et les sous-requêtes ne sont pas autorisées.

Pour plus d’informations, consultez Expressions (Transact-SQL)

OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause divise le jeu de résultats généré par la clause FROM en partitions auxquelles la fonction est appliquée. S'il n'est pas spécifié, la fonction gère toutes les lignes du jeu de résultats de la requête en un seul groupe. order_by_clause détermine l’ordre logique dans lequel l’opération est effectuée. order_by_clause est requis. Pour plus d’informations, consultez Clause OVER (Transact-SQL).

Types de retour

Retourne une valeur comme expression.

Remarques

MIN ignore toutes les valeurs NULL.

Avec des colonnes de données caractères, MIN recherche la valeur la plus faible dans l'ordre de tri.

MIN est une fonction déterministe lorsqu'elle est utilisée sans les clauses OVER et ORDER BY. Elle n'est pas déterministe avec les clauses OVER et ORDER BY. Pour plus d’informations, consultez Fonctions déterministes et non déterministes.

Exemples

R. Exemple simple

L'exemple suivant renvoie le taux d'imposition le plus bas (minimum). L’exemple utilise la base de données AdventureWorks2022

SELECT MIN(TaxRate)  
FROM Sales.SalesTaxRate;  
GO  

Voici le jeu de résultats obtenu.

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

B. Utilisation de la clause OVER

L’exemple suivant utilise les fonctions MIN, MAX, AVG et COUNT avec la clause OVER pour fournir des valeurs agrégées pour chaque service dans la table HumanResources.Department de la base de données AdventureWorks2022.

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  
FROM HumanResources.EmployeePayHistory AS eph  
JOIN HumanResources.EmployeeDepartmentHistory AS edh  
     ON eph.BusinessEntityID = edh.BusinessEntityID  
JOIN HumanResources.Department AS d  
 ON d.DepartmentID = edh.DepartmentID  
WHERE edh.EndDate IS NULL  
ORDER BY Name;  

Voici le jeu de résultats obtenu.

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)  

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

C. Utilisation de MIN

L’exemple suivant utilise la fonction d’agrégation MIN pour retourner le prix du produit (minimum) le moins coûteux dans un ensemble spécifié de commandes.

-- Uses AdventureWorks  
  
SELECT DISTINCT MIN(UnitPrice)  
FROM dbo.FactResellerSales   
WHERE SalesOrderNumber IN (N'SO43659', N'SO43660', N'SO43664');  

Voici le jeu de résultats obtenu.

------  
5.1865

D. Utilisation de MIN avec OVER

Les exemples suivants utilisent la fonction analytique MIN OVER() pour retourner le prix du produit le moins coûteux dans chaque commande. Le jeu de résultats est partitionné par la colonne SalesOrderID.

-- Uses AdventureWorks  
  
SELECT DISTINCT MIN(UnitPrice) OVER(PARTITION BY SalesOrderNumber) AS LeastExpensiveProduct,  
       SalesOrderNumber  
FROM dbo.FactResellerSales    
WHERE SalesOrderNumber IN (N'SO43659', N'SO43660', N'SO43664')  
ORDER BY SalesOrderNumber;  

Voici le jeu de résultats obtenu.

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

Voir aussi

Fonctions d'agrégation (Transact-SQL)
MAX (Transact-SQL)
OVER Clause (Transact-SQL)