Функция COUNT (Transact-SQL)
Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечной точке аналитики платформы Аналитики Azure Synapse Analytics (PDW) в Microsoft Fabric Хранилище в Microsoft Fabric
Эта функция возвращает количество элементов, найденных в группе. Функция COUNT
работает подобно функции COUNT_BIG. Эти функции различаются только типами данных в возвращаемых значениях. Функция COUNT
всегда возвращает значение типа данных int. Функция COUNT_BIG
всегда возвращает значение типа данных bigint.
Соглашения о синтаксисе Transact-SQL
Синтаксис
Синтаксис функции агрегирования
COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )
Синтаксис функции аналитики
COUNT ( [ ALL ] { expression | * } ) OVER ( [ <partition_by_clause> ] )
Аргументы
ВСЕ
Применяет агрегатную функцию ко всем значениям. Аргумент ALL используется по умолчанию.
DISTINCT
Указывает, что функция COUNT
возвращает количество уникальных значений, не равных NULL.
выражение
Выражение любого типа, кромеimage, ntext и text. COUNT
не поддерживает агрегатные функции или вложенные запросы в выражении.
*
Указывает, что функция COUNT
должна учитывать все строки, чтобы определить общее количество строк таблицы для возврата. COUNT(*)
не принимает параметров и не поддерживает использование DISTINCT. COUNT(*)
не требует параметра выражения, так как по определению он не использует сведения о определенном столбце. Функция COUNT(*)
возвращает количество строк в указанной таблице с учетом повторяющихся строк. Она подсчитывает каждую строку отдельно. При этом учитываются и строки, содержащие значения NULL.
OVER ( [ partition_by_clause ] [ order_by_clause ] [ ROW_or_RANGE_clause ] )
partition_by_clause делит результирующий набор, полученный с помощью предложения FROM
, на секции, к которым применяется функция COUNT
. Если этот параметр не указан, функция обрабатывает все строки результирующего набора запроса как отдельные группы. order_by_clause определяет логический порядок выполнения операции. Дополнительные сведения см . в предложении OVER (Transact-SQL ).
Типы возвращаемых данных
int NOT NULL ,
ANSI_WARNINGS
если имеет значениеON
, однако SQL Server всегда будет обрабатыватьCOUNT
выражения какint NULL
в метаданных, если только не упакованы вISNULL
.int NULL , если
ANSI_WARNINGS
имеет значениеOFF
.
Замечания
COUNT(*)
безGROUP BY
возврата кратности (число строк) в наборе результатов. К ним относятся строки, состоящие из всехNULL
значений и дубликатов.COUNT(*)
приGROUP BY
возврате числа строк в каждой группе. Сюда входятNULL
значения и дубликаты.COUNT(ALL <expression>)
вычисляет выражение для каждой строки в группе и возвращает количество ненулевого значения.COUNT(DISTINCT *expression*)
вычисляет выражение для каждой строки в группе и возвращает количество уникальных, ненулевого значения.
COUNT
— это детерминированная функция, если она используется без предложений OVER и ORDER BY. Она не детерминирована при использовании с предложениями OVER и ORDER BY. Дополнительные сведения см. в разделе детерминированные и недетерминированные функции.
ARITHABORT
и ANSI_WARNINGS
.
Если COUNT
имеет возвращаемое значение, превышающее максимальное значение int (то есть 231-1 или 2 147 483 647), COUNT
функция завершится ошибкой из-за целочисленного переполнения. При COUNT
переполнении и параметрах ARITHABORT
OFF
COUNT
ANSI_WARNINGS
возвращается.NULL
В противном случае, если или есть, ANSI_WARNINGS
ARITHABORT
ON
запрос будет прерваться, и будет вызвана ошибка арифметического переполнения.Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int.
Чтобы правильно обрабатывать эти большие результаты, используйте COUNT_BIG
вместо этого, что возвращает bigint.
Если оба ARITHABORT
и ANSI_WARNINGS
есть ON
, вы можете безопасно упаковать COUNT
сайты вызовов, ISNULL( <count-expr>, 0 )
чтобы принудить тип выражения вместо int NOT NULL
int NULL
. Упаковка COUNT
в ISNULL
означает, что любая ошибка переполнения будет автоматически подавляться, что должно быть рассмотрено для правильности.
Примеры
А. Использование COUNT и DISTINCT
В этом примере возвращается количество различных названий, которые может хранить сотрудник Adventure Works Cycles.
SELECT COUNT(DISTINCT Title)
FROM HumanResources.Employee;
GO
Вот результирующий набор.
-----------
67
(1 row(s) affected)
B. Использование COUNT(*)
В этом примере возвращается общее количество сотрудников Adventure Works Cycles.
SELECT COUNT(*)
FROM HumanResources.Employee;
GO
Вот результирующий набор.
-----------
290
(1 row(s) affected)
В. Использование COUNT(*) с другими агрегатами
В этом примере показано, что функция COUNT(*)
работает с другими статистическими функциями в списке SELECT
. В примере используется база данных AdventureWorks2022.
SELECT COUNT(*), AVG(Bonus)
FROM Sales.SalesPerson
WHERE SalesQuota > 25000;
GO
Вот результирующий набор.
----------- ---------------------
14 3472.1428
(1 row(s) affected)
D. Использование предложения OVER
В этом примере используются MAX
AVG
MIN
функции и COUNT
функции с OVER
предложением для возврата агрегированных значений для каждого отдела в таблице базы данных HumanResources.Department
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;
Вот результирующий набор.
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)
Примеры: Azure Synapse Analytics и система платформы аналитики (PDW)
Е. Использование COUNT и DISTINCT
В этом примере функция возвращает количество различных должностей, которые может иметь конкретный сотрудник компании.
USE ssawPDW;
SELECT COUNT(DISTINCT Title)
FROM dbo.DimEmployee;
Вот результирующий набор.
-----------
67
F. Использование COUNT(*)
В этом примере функция возвращает общее количество строк в таблице dbo.DimEmployee
.
USE ssawPDW;
SELECT COUNT(*)
FROM dbo.DimEmployee;
Вот результирующий набор.
-------------
296
G. Использование COUNT(*) с другими агрегатами
В этом примере функция COUNT(*)
работает с другими статистическими функциями в списке SELECT
. Запрос возвращает количество торговых представителей с годовой квотой продаж более 500 000 долл. США и их среднюю квоту продаж.
USE ssawPDW;
SELECT COUNT(EmployeeKey) AS TotalCount, AVG(SalesAmountQuota) AS [Average Sales Quota]
FROM dbo.FactSalesQuota
WHERE SalesAmountQuota > 500000 AND CalendarYear = 2001;
Вот результирующий набор.
TotalCount Average Sales Quota
---------- -------------------
10 683800.0000
H. Использование COUNT с ПОМОЩЬЮ HAVING
В этом примере функция COUNT
используется с предложением HAVING
, чтобы получить список подразделений компании, в каждом из которых работает более 15 сотрудников.
USE ssawPDW;
SELECT DepartmentName,
COUNT(EmployeeKey)AS EmployeesInDept
FROM dbo.DimEmployee
GROUP BY DepartmentName
HAVING COUNT(EmployeeKey) > 15;
Вот результирующий набор.
DepartmentName EmployeesInDept
-------------- ---------------
Sales 18
Production 179
I. Использование COUNT с OVER
В этом примере функция COUNT
используется с предложением OVER
, чтобы получить количество продуктов, содержащихся в каждом из указанных заказов на продажу.
USE ssawPDW;
SELECT DISTINCT COUNT(ProductKey) OVER(PARTITION BY SalesOrderNumber) AS ProductCount
, SalesOrderNumber
FROM dbo.FactInternetSales
WHERE SalesOrderNumber IN (N'SO53115',N'SO55981');
Вот результирующий набор.
ProductCount SalesOrderID
------------ -----------------
3 SO53115
1 SO55981