DBCC CHECKCONSTRAINTS (Transact-SQL)

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di Azure

Controlla l'integrità di un vincolo specificato oppure di tutti i vincoli di una tabella specificata nel database corrente.

Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

table_name | table_id | constraint_name | constraint_id

Tabella o vincolo da controllare. Se si specifica table_name o table_id vengono controllati tutti i vincoli abilitati nella tabella. Se si specifica constraint_name o constraint_id viene controllato solo il vincolo specificato. Se non viene specificato un identificatore di tabella o un identificatore di vincolo, vengono controllati tutti i vincoli abilitati per tutte le tabelle del database corrente.

Un nome di vincolo identifica in modo univoco la tabella a cui appartiene. Per altre informazioni, vedere Identificatori del database.

WITH

Consente di specificare opzioni.

• ALL_CONSTRAINTS

  Controlla tutti i vincoli abilitati e disabilitati della tabella se viene specificato il nome della tabella o se vengono controllate tutte le tabelle. In caso contrario, viene controllato solo il vincolo abilitato. ALL_CONSTRAINTS non ha alcun effetto quando viene specificato un nome di vincolo.

• ALL_ERRORMSGS

  Restituisce tutte le righe che violano i vincoli della tabella controllata. Per impostazione predefinita vengono restituite le prime 200 righe.

• NO_INFOMSGS

  Disattiva tutti i messaggi informativi.

Osservazioni

DBCC CHECKCONSTRAINTS costruisce ed esegue una query per tutti i vincoli FOREIGN KEY e CHECK in una tabella.

Una query di chiave esterna, ad esempio, presenta il seguente formato:

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;

I dati della query vengono archiviati in una tabella temporanea. Dopo che tutte le tabelle o tutti i vincoli richiesti sono stati controllati, viene restituito il set di risultati.

DBCC CHECKCONSTRAINTS controlla l'integrità dei vincoli FOREIGN KEY e CHECK, ma non controlla l'integrità delle strutture di dati su disco di una tabella. Il controllo di queste strutture può essere eseguito tramite DBCC CHECKDB e DBCC CHECKTABLE.

Si applica a: SQL Server 2016 (13.x) e versioni successive

Se viene specificato table_name o table_id ed è abilitato per il controllo delle versioni del sistema, DBCC CHECKCONSTRAINTS esegue anche controlli di coerenza dei dati temporali nella tabella specificata. Quando non viene specificato NO_INFOMSGS , questo comando restituirà ogni violazione di coerenza nell'output in una riga separata. Il formato dell'output sarà ([pkcol1], [pkcol2]..) = (<pkcol1_value>, <pkcol2_value>...) AND <what is wrong with temporal table record>.

Non è possibile specificare constraint_name o constraint_id per eseguire solo controlli di coerenza temporale.

Set di risultati

DBCC CHECKCONSTRAINTS restituisce un set di righe con le colonne seguenti.

DBCC CHECKCONSTRAINTS non è garantito trovare tutte le violazioni dei vincoli. Se una singola riga viola più vincoli, viene elencata solo la WHERE clausola per la prima violazione. A meno che non esista un'altra riga con la stessa combinazione di valori che producono la violazione e che abbia tale violazione come prima violazione trovata, la combinazione di valori non sarà presente nel set di risultati restituito. Potrebbe essere necessario eseguire DBCC CHECKCONSTRAINTS e risolvere i problemi più volte prima di trovare tutte le violazioni dei vincoli nel database.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o al ruolo predefinito del database db_owner .

Esempi

R. Controllare una tabella

Nell'esempio seguente viene controllata l'integrità dei vincoli della tabella Table1 del database AdventureWorks2022.

USE AdventureWorks2022;
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. Controllare un vincolo specifico

Nell'esempio seguente viene controllata l'integrità del vincolo CK_ProductCostHistory_EndDate.

USE AdventureWorks2022;
GO
DBCC CHECKCONSTRAINTS ('Production.CK_ProductCostHistory_EndDate');
GO

C. Controllare tutti i vincoli abilitati e disabilitati in tutte le tabelle

Nell'esempio seguente viene controllata l'integrità di tutti i vincoli abilitati e disabilitati di tutte le tabelle nel database corrente.

DBCC CHECKCONSTRAINTS WITH ALL_CONSTRAINTS;
GO

Vedi anche

• DBCC CHECKDB (Transact-SQL)
• DBCC CHECKTABLE (Transact-SQL)
• DBCC (Transact-SQL)