UniqueRecords Property

Applies To

Action query, Select query.

Description

You can use the UniqueRecords property to specify whether to return only unique records based on all fields in the underlying data source, not just those fields present in the query itself.

Note The UniqueRecords property applies only to append and make-table action queries and select queries.

Setting

The UniqueRecords property uses the following settings.

Setting

Description

Yes

Doesn't return duplicate records.

No

(Default) Returns duplicate records.


You can set the UniqueRecords property in the query's property sheet or in SQL view of the Query window.

Note You set this property when you create a new query by using an SQL statement. The DISTINCTROW predicate corresponds to the UniqueRecords property setting. The DISTINCT predicate corresponds to the UniqueValues property setting.

Remarks

You can use the UniqueRecords property when you want to omit data based on entire duplicate records, not just duplicate fields. Microsoft Access considers a record to be unique as long as the value in one field in the record differs from the value in the same field in another record.

The UniqueRecords property has an effect only when you use more than one table in the query and select fields from the tables used in the query. The UniqueRecords property is ignored if the query includes only one table.

The UniqueRecords and UniqueValues properties are related in that only one of them can be set to Yes at a time. When you set UniqueRecords to Yes, for example, Microsoft Access automatically sets UniqueValues to No. You can, however, set both of them to No. When both properties are set to No, all records are returned.

See Also

ALL, DISTINCT ROW, TOP predicates ("SQL Language Reference"), UniqueValues property.

Example

The query in this example returns a list of customers from the Customers table who have at least one order in the Orders table.

Customers Table

Company name

Customer ID

Ernst Handel

ERNSH

Familia Arquibaldo

FAMIA

FISSA Fabrica Inter. Salchichas S.A.

FISSA

Folies gourmandes

FOLIG


Orders Table

Customer ID

Order ID

ERNSH

10698

FAMIA

10512

FAMIA

10725

FOLIG

10763

FOLIG

10408


The following SQL statement returns the customer names in the following table:

SELECT DISTINCTROW Customers.CompanyName, Customers.CustomerID
FROM Customers INNER JOIN Orders
ON Customers.CustomerID = Orders.CustomerID;

Customers returned

Customer ID

Ernst Handel

ERNSH

Familia Arquibaldo

FAMIA

Folies gourmandes

FOLIG