Функция COUNT (Transact-SQL)COUNT (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ ЭТОЙ СТАТЬИ: даSQL Server (начиная с 2008)даБаза данных SQL AzureдаХранилище данных SQL AzureдаParallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Эта функция возвращает количество элементов, найденных в группе.This function returns the number of items found in a group. Функция COUNT работает подобно функции COUNT_BIG.COUNT operates like the COUNT_BIG function. Эти функции различаются только типами данных в возвращаемых значениях.These functions differ only in the data types of their return values. Функция COUNT всегда возвращает значение типа данных int.COUNT always returns an int data type value. Функция COUNT_BIG всегда возвращает значение типа данных bigint.COUNT_BIG always returns a bigint data type value.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

-- Syntax for SQL Server and Azure SQL Database  

COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )   
    [ OVER (   
        [ partition_by_clause ]   
        [ order_by_clause ]   
        [ ROW_or_RANGE_clause ]  
    ) ]  
-- Syntax for Azure SQL Data Warehouse and Parallel Data Warehouse  

-- Aggregation Function Syntax  
COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )  

-- Analytic Function Syntax  
COUNT ( { expression | * } ) OVER ( [ <partition_by_clause> ] )  

АргументыArguments

ALLALL
Применяет агрегатную функцию ко всем значениям.Applies the aggregate function to all values. Аргумент ALL используется по умолчанию.ALL serves as the default.

DISTINCTDISTINCT
Указывает, что функция COUNT возвращает количество уникальных значений, не равных NULL.Specifies that COUNT returns the number of unique nonnull values.

expressionexpression
Выражение любого типа, кромеimage, ntext и text.An expression of any type, except image, ntext, or text. Обратите внимание, что функция COUNT не поддерживает агрегатные функции и вложенные запросы в выражении.Note that COUNT does not support aggregate functions or subqueries in an expression.

*
Указывает, что функция COUNT должна учитывать все строки, чтобы определить общее количество строк таблицы для возврата.Specifies that COUNT should count all rows to determine the total table row count to return. Функция COUNT(*) не принимает параметры и не поддерживает использование аргумента DISTINCT.COUNT(*) takes no parameters and does not support the use of DISTINCT. Для функции COUNT(*) не требуется параметр expression, так как по определению она не использует сведения о конкретном столбце.COUNT(*) does not require an expression parameter because by definition, it does not use information about any particular column. Функция COUNT(*) возвращает количество строк в указанной таблице с учетом повторяющихся строк.COUNT(*) returns the number of rows in a specified table, and it preserves duplicate rows. Она подсчитывает каждую строку отдельно.It counts each row separately. При этом учитываются и строки, содержащие значения NULL.This includes rows that contain null values.

OVER ( [ partition_by_clause ] [ order_by_clause ] [ ROW_or_RANGE_clause ] )OVER ( [ partition_by_clause ] [ order_by_clause ] [ ROW_or_RANGE_clause ] )
partition_by_clause делит результирующий набор, полученный с помощью предложения FROM, на секции, к которым применяется функция COUNT.The partition_by_clause divides the result set produced by the FROM clause into partitions to which the COUNT function is applied. Если этот параметр не указан, функция обрабатывает все строки результирующего набора запроса как отдельные группы.If not specified, the function treats all rows of the query result set as a single group. order_by_clause определяет логический порядок выполнения операции.The order_by_clause determines the logical order of the operation. Дополнительные сведения см. в статье SELECT — предложение OVER (Transact-SQL).See OVER Clause (Transact-SQL) for more information.

Типы возвращаемых данныхReturn types

intint

RemarksRemarks

Функция COUNT(*) возвращает количество элементов в группе.COUNT(*) returns the number of items in a group. Сюда входят значения NULL и повторяющиеся значения.This includes NULL values and duplicates.

Функция COUNT(ALL expression) вычисляет expression для каждой строки в группе и возвращает количество значений, не равных NULL.COUNT(ALL expression) evaluates expression for each row in a group, and returns the number of nonnull values.

Функция COUNT(DISTINCT expression) вычисляет expression для каждой строки в группе и возвращает количество уникальных значений, не равных NULL.COUNT(DISTINCT expression) evaluates expression for each row in a group, and returns the number of unique, nonnull values.

Для возвращаемых значений, которые превышают значение 2^31-1, функция COUNT возвращает ошибку.For return values exceeding 2^31-1, COUNT returns an error. В таких случаях используйте вместо нее функцию COUNT_BIG.For these cases, use COUNT_BIG instead.

COUNT — это детерминированная функция, если она используется без предложений OVER и ORDER BY.COUNT is a deterministic function when used without the OVER and ORDER BY clauses. Она не детерминирована при использовании с предложениями OVER и ORDER BY.It is nondeterministic when used with the OVER and ORDER BY clauses. Дополнительные сведения см. в статье Детерминированные и недетерминированные функции.See Deterministic and Nondeterministic Functions for more information.

ПримерыExamples

A.A. Использование функции COUNT и параметра DISTINCTUsing COUNT and DISTINCT

В этом примере функция возвращает количество различных должностей, которые может иметь сотрудник Компания Adventure Works CyclesAdventure Works Cycles.This example returns the number of different titles that an Компания Adventure Works CyclesAdventure Works Cycles employee can hold.

SELECT COUNT(DISTINCT Title)  
FROM HumanResources.Employee;  
GO  

Ниже приводится результирующий набор.Here is the result set.

-----------
67  

(1 row(s) affected)

Б.B. Использование функции COUNT(*)Using COUNT(*)

В этом примере функция возвращает общее количество сотрудников Компания Adventure Works CyclesAdventure Works Cycles.This example returns the total number of Компания Adventure Works CyclesAdventure Works Cycles employees.

SELECT COUNT(*)  
FROM HumanResources.Employee;  
GO  

Ниже приводится результирующий набор.Here is the result set.

-----------
290  

(1 row(s) affected)

В.C. Использование функции COUNT(*) совместно с другими статистическими функциямиUsing COUNT(*) with other aggregates

В этом примере показано, что функция COUNT(*) работает с другими статистическими функциями в списке SELECT.This example shows that COUNT(*) works with other aggregate functions in the SELECT list. В этом примере используется база данных AdventureWorks2012AdventureWorks2012.The example uses the AdventureWorks2012AdventureWorks2012 database.

SELECT COUNT(*), AVG(Bonus)  
FROM Sales.SalesPerson  
WHERE SalesQuota > 25000;  
GO  

Ниже приводится результирующий набор.Here is the result set.

----------- ---------------------
14            3472.1428

(1 row(s) affected)

Г.D. Использование предложения OVERUsing the OVER clause

В этом примере функции MIN, MAX, AVG и COUNT используются с предложением OVER, чтобы получить статистические значения для каждого из отделов в таблице HumanResources.Department базы данных AdventureWorks2012AdventureWorks2012.This example uses the MIN, MAX, AVG and COUNT functions with the OVER clause, to return aggregated values for each department in the AdventureWorks2012AdventureWorks2012 database HumanResources.Department table.

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;  

Ниже приводится результирующий набор.Here is the result set.

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)

Примеры: Хранилище данных SQL AzureAzure SQL Data Warehouse и Параллельное хранилище данныхParallel Data WarehouseExamples: Хранилище данных SQL AzureAzure SQL Data Warehouse and Параллельное хранилище данныхParallel Data Warehouse

Д.E. Использование функции COUNT и параметра DISTINCTUsing COUNT and DISTINCT

В этом примере функция возвращает количество различных должностей, которые может иметь конкретный сотрудник компании.This example returns the number of different titles that an employee of a specific company can hold.

USE ssawPDW;  

SELECT COUNT(DISTINCT Title)  
FROM dbo.DimEmployee;  

Ниже приводится результирующий набор.Here is the result set.

-----------
67

Е.F. Использование функции COUNT(*)Using COUNT(*)

В этом примере функция возвращает общее количество строк в таблице dbo.DimEmployee.This example returns the total number of rows in the dbo.DimEmployee table.

USE ssawPDW;  

SELECT COUNT(*)  
FROM dbo.DimEmployee;  

Ниже приводится результирующий набор.Here is the result set.

-------------
296

Ж.G. Использование функции COUNT(*) совместно с другими статистическими функциямиUsing COUNT(*) with other aggregates

В этом примере функция COUNT(*) работает с другими статистическими функциями в списке SELECT.This example combines COUNT(*) with other aggregate functions in the SELECT list. Запрос возвращает количество торговых представителей с годовой квотой продаж более 500 000 долл. США и их среднюю квоту продаж.It returns the number of sales representatives with an annual sales quota greater than $500,000, and the average sales quota of those sales representatives.

USE ssawPDW;  

SELECT COUNT(EmployeeKey) AS TotalCount, AVG(SalesAmountQuota) AS [Average Sales Quota]  
FROM dbo.FactSalesQuota  
WHERE SalesAmountQuota > 500000 AND CalendarYear = 2001;  

Ниже приводится результирующий набор.Here is the result set.

TotalCount  Average Sales Quota
----------  -------------------
10          683800.0000

З.H. Использование функции COUNT с предложением HAVINGUsing COUNT with HAVING

В этом примере функция COUNT используется с предложением HAVING, чтобы получить список подразделений компании, в каждом из которых работает более 15 сотрудников.This example uses COUNT with the HAVING clause to return the departments of a company, each of which has more than 15 employees.

USE ssawPDW;  

SELECT DepartmentName,   
       COUNT(EmployeeKey)AS EmployeesInDept  
FROM dbo.DimEmployee  
GROUP BY DepartmentName  
HAVING COUNT(EmployeeKey) > 15;  

Ниже приводится результирующий набор.Here is the result set.

DepartmentName  EmployeesInDept
--------------  ---------------
Sales           18
Production      179

И.I. Использование функции COUNT с предложением OVERUsing COUNT with OVER

В этом примере функция COUNT используется с предложением OVER, чтобы получить количество продуктов, содержащихся в каждом из указанных заказов на продажу.This example uses COUNT with the OVER clause, to return the number of products contained in each of the specified sales orders.

USE ssawPDW;  

SELECT DISTINCT COUNT(ProductKey) OVER(PARTITION BY SalesOrderNumber) AS ProductCount  
    ,SalesOrderNumber  
FROM dbo.FactInternetSales  
WHERE SalesOrderNumber IN (N'SO53115',N'SO55981');  

Ниже приводится результирующий набор.Here is the result set.

ProductCount   SalesOrderID`
------------   -----------------
3              SO53115
1              SO55981

См. также разделSee also

Агрегатные функции (Transact-SQL)Aggregate Functions (Transact-SQL)
COUNT_BIG (Transact-SQL)COUNT_BIG (Transact-SQL)
Предложение OVER (Transact-SQL)OVER Clause (Transact-SQL)