MIN (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Retorna o valor mínimo na expressão. Pode ser seguido pela cláusula OVER.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

ALL
Aplica a função de agregação a todos os valores. ALL é o padrão.

DISTINTO
Especifica que cada valor exclusivo é considerado. DISTINCT não é significativo com MIN e está disponível somente para compatibilidade com ISO.

expressão
É uma constante, nome de coluna ou função e qualquer combinação de operadores aritméticos, bit a bit e de cadeia de caracteres. MIN pode ser usado com colunas numeric, char, varchar, uniqueidentifier ou datetime, mas não com colunas bit. Funções de agregação e subconsultas não são permitidas.

Para obter mais informações, confira Expressões (Transact-SQL).

OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições às quais a função é aplicada. Se não for especificado, a função tratará todas as linhas do conjunto de resultados da consulta como um único grupo. order_by_clause determina a ordem lógica na qual a operação é executada. order_by_clause é obrigatório. Para obter mais informações, confira Cláusula OVER (Transact-SQL).

Tipos de retorno

Retorna um valor igual a expression.

Comentários

MIN ignora quaisquer valores nulos.

Com colunas de dados de caractere, MIN localiza o valor mais baixo na sequência de classificação.

MIN é uma função determinística quando usada sem as cláusulas OVER e ORDER BY. É não determinística quando especificada com as cláusulas OVER e ORDER BY. Para obter mais informações, veja Funções determinísticas e não determinísticas.

Exemplos

a. Exemplo simples

O exemplo a seguir retorna a taxa de imposto mais baixa (mínima). O exemplo usa o banco de dados AdventureWorks2022

SELECT MIN(TaxRate)  
FROM Sales.SalesTaxRate;  
GO  

Veja a seguir o conjunto de resultados.

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

B. Usando a cláusula OVER

O exemplo a seguir usa as funções MIN, MAX, AVG e COUNT com a cláusula OVER para fornecer valores agregados a cada departamento na tabela HumanResources.Department do banco de dados 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;  

Veja a seguir o conjunto de resultados.

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)  

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

C. Usando MIN

O exemplo a seguir usa a função de agregação MIN para retornar o preço do produto menos caro (mínimo) em um conjunto especificado de ordens de venda.

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

Veja a seguir o conjunto de resultados.

------  
5.1865

D. Usando MIN com OVER

Os exemplos a seguir usam a função analítica MIN OVER() para retornar o preço do produto menos caro em cada ordem de vendas. O conjunto de resultados é particionado pela coluna 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;  

Veja a seguir o conjunto de resultados.

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

Confira também

Funções de agregação (Transact-SQL)
MAX (Transact-SQL)
Cláusula OVER (Transact-SQL)