DBCC CHECKCONSTRAINTS (Transact-SQL)

Syntaxe

DBCC CHECKCONSTRAINTS
[ 
        ( 
        table_name | table_id | constraint_name | constraint_id 
        )
]
    [ WITH 
        [ { ALL_CONSTRAINTS | ALL_ERRORMSGS } ]
    [ , ] [ NO_INFOMSGS ] 
    ]

Arguments

• table_name | table_id | constraint_name | constraint_id
  Table ou contrainte à vérifier. Lorsque table_name ou table_id est spécifié, toutes les contraintes activées sur la table sont vérifiées. Lorsque vous spécifiez constraint_name ou constraint_id, seule cette contrainte est vérifiée. Si aucun identificateur de table ni aucun identificateur de contrainte n'est spécifié, toutes les contraintes activées sur toutes les tables de la base de données actuelle sont vérifiées.

  Un nom de contrainte identifie de manière unique la table à laquelle la contrainte appartient. Pour plus d'informations, consultez Identificateurs.

• WITH
  Active les options à spécifier.

• ALL_CONSTRAINTS
  Vérifie toutes les contraintes activées et désactivées de la table si le nom de la table est spécifié ou si toutes les tables sont vérifiées. Autrement, vérifie seulement la contrainte activée. ALL_CONSTRAINTS n'a pas d'effet lorsqu'un nom de contrainte est spécifié.

• ALL_ERRORMSGS
  Renvoie toutes les lignes qui ne respectent pas les contraintes de la table vérifiée. Cette instruction concerne par défaut les 200 premières lignes.

• NO_INFOMSGS
  Supprime tous les messages d'information.

Notes

DBCC CHECKCONSTRAINTS crée et exécute une requête pour toutes les contraintes FOREIGN KEY et les contraintes CHECK sur une table.

Par exemple, une requête de clé étrangère se présente comme suit :

SELECT <columns>
FROM <table_being_checked> LEFT JOIN <referenced_table>
    ON <table_being_checked.fkey1> = <referenced_table.pkey1> 
    AND <table_being_checked.fkey2> = <referenced_table.pkey2>
WHERE <table_being_checked.fkey1> IS NOT NULL 
    AND <referenced_table.pkey1> IS NULL
    AND <table_being_checked.fkey2> IS NOT NULL
    AND <referenced_table.pkey2> IS NULL

Les données de la requête sont stockées dans une table temporaire. Une fois que toutes les tables ou les contraintes demandées ont été vérifiées, le jeu de résultats est renvoyé.

DBCC CHECKCONSTRAINTS vérifie l'intégrité des contraintes FOREIGN KEY et CHECK, mais ne vérifie pas celle des structures de données sur disque d'une table. Ces vérifications de structures de données peuvent être effectuées à l'aide de DBCC CHECKDB et de DBCC CHECKTABLE.

Jeux de résultats

DBCC CHECKCONSTRAINTS renvoie un ensemble de lignes comportant les colonnes suivantes.

Autorisations

Requiert l'appartenance au rôle de serveur fixe sysadmin ou au rôle de base de données fixe db_owner.

Exemples

A. Vérification d'une table

USE AdventureWorks;
GO
CREATE TABLE Table1 (Col1 int, Col2 char (30));
GO
INSERT INTO Table1 VALUES (100, 'Hello');
GO
ALTER TABLE Table1 WITH NOCHECK ADD CONSTRAINT chkTab1 CHECK (Col1 > 100);
GO
DBCC CHECKCONSTRAINTS(Table1);
GO

B. Vérification d'une contrainte spécifique

USE AdventureWorks;
GO
DBCC CHECKCONSTRAINTS ("Production.CK_ProductCostHistory_EndDate");
GO

C. Vérification de toutes les contraintes activées et désactivées de toutes les tables

DBCC CHECKCONSTRAINTS WITH ALL_CONSTRAINTS;
GO

Voir aussi

Référence