GROUP BY clause (Microsoft Access SQL)
Applies to: Access 2013 | Access 2016
Combines records with identical values in the specified field list into a single record. A summary value is created for each record if you include an SQL aggregate function, such as Sum or Count, in the SELECT statement.
SELECT fieldlist FROM table WHERE criteria [GROUP BY groupfieldlist ]
A SELECT statement containing a GROUP BY clause has these parts:
|fieldlist||The name of the field or fields to be retrieved along with any field-name aliases, SQL aggregate functions, selection predicates (ALL, DISTINCT, DISTINCTROW, or TOP), or other SELECT statement options.|
|table||The name of the table from which records are retrieved. For more information, see the FROM clause.|
|criteria||Selection criteria. If the statement includes a WHERE clause, the Microsoft Access database engine groups values after applying the WHERE conditions to the records.|
|groupfieldlist||The names of up to 10 fields used to group records. The order of the field names in groupfieldlist determines the grouping levels from the highest to the lowest level of grouping.|
GROUP BY is optional.
Summary values are omitted if there is no SQL aggregate function in the SELECT statement.
Null values in GROUP BY fields are grouped and are not omitted. However, Null values are not evaluated in any SQL aggregate function.
Use the WHERE clause to exclude rows you do not want grouped, and use the HAVING clause to filter records after they have been grouped.
Unless it contains Memo or OLE Object data, a field in the GROUP BY field list can refer to any field in any table listed in the FROM clause, even if the field is not included in the SELECT statement, provided the SELECT statement includes at least one SQL aggregate function. The Microsoft® Jet database engine cannot group on Memo or OLE Object fields.
All fields in the SELECT field list must either be included in the GROUP BY clause or be included as arguments to an SQL aggregate function.
This example creates a list of unique job titles and the number of employees with each title. It calls the EnumFields procedure, which you can find in the SELECT statement example.
Sub GroupByX1() Dim dbs As Database, rst As Recordset ' Modify this line to include the path to Northwind ' on your computer. Set dbs = OpenDatabase("Northwind.mdb") ' For each title, count the number of employees ' with that title. Set rst = dbs.OpenRecordset("SELECT Title, " _ & "Count([Title]) AS Tally " _ & "FROM Employees GROUP BY Title;") ' Populate the Recordset. rst.MoveLast ' Call EnumFields to print the contents of the ' Recordset. Pass the Recordset object and desired ' field width. EnumFields rst, 25 dbs.Close End Sub
For each unique job title, this example calculates the number of employees in Washington who have that title.
Sub GroupByX2() Dim dbs As Database, rst As Recordset ' Modify this line to include the path to Northwind ' on your computer. Set dbs = OpenDatabase("Northwind.mdb") ' For each title, count the number of employees ' with that title. Only include employees in the ' Washington region. Set rst = dbs.OpenRecordset("SELECT Title, " _ & "Count(Title) AS Tally " _ & "FROM Employees WHERE Region = 'WA' " _ & "GROUP BY Title;") ' Populate the Recordset. rst.MoveLast ' Call EnumFields to print the contents of the ' Recordset. Pass the Recordset object and desired ' field width. EnumFields rst, 25 dbs.Close End Sub
- Access for developers forum
- Access help on support.office.com
- Access forums on UtterAccess
- Access developer and VBA programming help center (FMS)
- Access posts on StackOverflow
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.