PRB: Uniqueness of Index Violated When Creating Primary Index

Last reviewed: January 15, 1996
Article ID: Q142283
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, versions 3.0 and 3.0b

SYMPTOMS

After you create a Primary Index for a table that is populated with records and choose to make the structure changes permanent, the following error message appears:

   Uniqueness of index <name> is violated.

CAUSE

More than one record, including any deleted records, contain the same value within the field being used for the Primary Index. This also applies to the existence of more than one blank record, whether marked for deletion or not.

RESOLUTION

Eliminate any use of the same value within multiple records. There are many methods you could use, but perhaps the easiest is to use a query. The following example query will generate a cursor that contains a list of the values that occur in more than one record of a table:

   SELECT <field name> FROM <table name>;
      GROUP BY <field name>;
      HAVING COUNT(<field name>) > 1

For information about obtaining the number of duplicate records, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q115617
   TITLE     : How to List Duplicate Records in a Field

For information about deleting duplicate records, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q104332
   TITLE     : Methods of Deleting Duplicate Records from a Database

If duplicate records have been marked for deletion and you prefer that the table not be packed to eliminate them, the Primary Index must contain the following filter to ignore the deleted records:

   !DELETED()

For more information about reusing deleted primary key values, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q139756
   TITLE     : Cannot Reuse Deleted Primary Key Values in Visual FoxPro

STATUS

This behavior is by design.

MORE INFORMATION

The intent of a primary index is to never permit duplicate values on the specified fields. For more information about primary indexes, search for "primary index" in the Visual FoxPro Help file.

Steps to Reproduce Behavior

  1. Create a new table that has two fields. In this case, the table is called States and the fields are Fullname (Character, 15) and Abbrev (Character, 2).

  2. Add the following records to the table:

       Fullname     Abbrev
       -------------------
       Alabama      AL
       Alaska       AK
       Arizona      AZ
       Arkansas     AR
    
    

  3. Add two blank records to the table, and mark them for deletion, but do not pack the table.

  4. On the Window menu, click View Window, and if the States table isn't open, click Open. Then select it.

  5. Click the Properties button, and from the Work Area Properties window, click the Modify button.

  6. Click the Index tab in the Table Designer, and enter state for the Name, set Primary as the Type, and Fullname for the Expression.

  7. Click OK. Within the message box asking to make structure changes permanent, click Yes. At this point, the following error appears:

    Uniqueness of index state is violated.


Additional reference words: 3.00 3.00b VFoxWin
KBCategory: kbprg kbprb
KBSubcategory: FxprgTable


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: January 15, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.