Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Applies to: Access 2013 | Access 2016
Use the UniqueValues property when you want to omit records that contain duplicate data in the fields displayed in Datasheet view. For example, if a query's output includes more than one field, the combination of values from all fields must be unique for a given record to be included in the results.
Note
The UniqueValues property applies only to append and make-table action queries and select queries.
Setting
The UniqueValues property uses the following settings.
| Setting | Description |
|---|---|
| Yes | Displays only the records in which the values of all fields displayed in Datasheet view are unique. |
| No | (Default) Displays all records. |
You can set the UniqueValues property in the query's property sheet or in SQL view of the Query window.
Note
You can set this property when you create a new query by using an SQL statement. The DISTINCT predicate corresponds to the UniqueValues property setting. The DISTINCTROW predicate corresponds to the UniqueValues property setting.
Remarks
When you set the UniqueValues property to Yes, the results of the query aren't updatable and won't reflect subsequent changes made by other users.
The UniqueValues and UniqueRecords properties are related in that only one of them can be set to Yes at a time. When you set the UniqueValues property to Yes, for example, Microsoft Access automatically sets the UniqueRecords property to No. You can, however, set both of them to No. When both properties are set to No, all records are returned.
If you want to count the number of instances of a value in a field, create a totals query.
Example
The SELECT statement in this example returns a list of the countries/regions in which there are customers. Because there may be many customers in each country/region, many records could have the same country/region in the Customers table. However, each country/region is represented only once in the query results.
This example uses the Customers table, which contains the following data.
| Country/Region | Company name |
|---|---|
| Brazil | Familia Arquibaldo |
| Brazil | Gourmet Lanchonetes |
| Brazil | Hanari Carnes |
| France | Du monde entier |
| France | Folies gourmandes |
| Germany | Frankenversand |
| Ireland | Hungry Owl All-Night Grocers |
This SQL statement returns the countries/regions in the following table:
SELECT DISTINCT Customers.Country
FROM Customers;
| Countries/Regions returned |
|---|
| Brazil |
| France |
| Germany |
| Ireland |
See also
- Access for developers forum
- Access help on support.office.com
- Access help on answers.microsoft.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.