DBCC CHECKCONSTRAINTS (Transact-SQL)

[アーティクル]
04/18/2022

適用対象:SQL Server (サポートされているすべてのバージョン) Azure SQL Database Azure SQL Managed Instance

現在のデータベースで、指定した制約や指定したテーブルのすべての制約に関する整合性をチェックします。

構文

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

Note

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

table_nametable_idconstraint_nameconstraint_id
チェックするテーブルまたは制約を指定します。 table_name または table_id を指定した場合は、そのテーブルで有効な制約がすべてチェックされます。 constraint_name または constraint_id を指定した場合は、その制約のみがチェックされます。テーブル識別子も制約識別子も指定しない場合は、現在のデータベース内にあるすべてのテーブルで有効なすべての制約がチェックされます。
制約名によって、その制約が属するテーブルが一意に識別されます。詳細については、「データベース識別子」を参照してください。

WITH
オプションを指定可能にします。

ALL_CONSTRAINTS
テーブル名を指定した場合、またはすべてのテーブルがチェックされる場合、テーブルのすべての有効な制約および無効な制約がチェックされます。それ以外の場合は、有効な制約のみがチェックされます。制約名を指定した場合、ALL_CONSTRAINTS は無効になります。

ALL_ERRORMSGS
チェック対象となるテーブル内の制約に違反する行をすべて返します。既定では、先頭から 200 行までが返されます。

NO_INFOMSGS
すべての情報メッセージを表示しないようにします。

解説

DBCC CHECKCONSTRAINTS では、テーブルのすべての FOREIGN KEY 制約および CHECK 制約に対してクエリが作成され実行されます。

たとえば、外部キークエリは次のような形式になります。

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

クエリデータは temp テーブルに格納されます。指定したすべてのテーブルまたは制約がチェックされた後、結果セットが返されます。 DBCC CHECKCONSTRAINTS では、FOREIGN KEY 制約と CHECK 制約の整合性はチェックされますが、テーブルのディスク上のデータ構造に関する整合性はチェックされません。このようなデータ構造のチェックは、DBCC CHECKDB および DBCC CHECKTABLE で実行できます。

適用対象: SQL Server 2016 (13. x) 以降

table_name または table_id が指定されており、システムのバージョン管理で有効になっている場合、DBCC CHECKCONSTRAINTS では、指定したテーブルで、テンポラルデータの整合性チェックも行います。このコマンドでは、NO_INFOMSGS が指定されていない場合、それぞれの整合性違反を別の行に出力します。出力の形式は、([pkcol1], [pkcol2]..) になります。 = ( < pkcol1_value > 、 < pkcol2_value > ...)また、 < テンポラルテーブルのレコード > には問題があります。

○	チェックが失敗した場合の出力の追加情報
PeriodEndColumn ≥ PeriodStartColumn (current)	[sys_end] = '{0}' AND MAX(DATETIME2) = '9999-12-31 23:59:59.99999'
PeriodEndColumn ≥ PeriodStartColumn (current, history)	[sys_start] = '{0}' AND [sys_end] = '{1}'
PeriodStartColumn < current_utc_time (現在)	[sys_start] = '{0}' AND SYSUTCTIME
PeriodEndColumn < current_utc_time (履歴)	[sys_end] = '{0}' AND SYSUTCTIME
重複	(sys_start1, sys_end1) , (sys_start2, sys_end2) 2 つの重複するレコード。重複するレコードが 2 つ以上ある場合、出力は複数行になり、各行で重複の各ペアが示されます。

テンポラル整合性チェックのみを実行するために、constraint_name または constraint_id を指定する方法はありません。

結果セット

DBCC CHECKCONSTRAINTS では、次の列を含む行セットが返されます。

列名	データ型	説明
テーブル名	varchar	テーブルの名前。
Constraint Name	varchar	違反している制約の名前。
Where	varchar	制約に違反している 1 つ以上の行を識別する列値の割り当て。この列の値は、制約に違反する行をクエリする SELECT ステートメントの WHERE 句で使用できます。

アクセス許可

sysadmin 固定サーバーロールまたは db_owner 固定データベースロールのメンバーシップが必要です。

例

A. テーブルをチェックする

次の例では、Table1 データベースにある AdventureWorks テーブルの制約の整合性をチェックします。

USE AdventureWorks2012;  
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. 特定の制約をチェックする

次の例では、CK_ProductCostHistory_EndDate 制約の整合性をチェックします。

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

C. すべてのテーブルについて、すべての有効な制約と無効な制約をチェックする

次の例では、現在のデータベース内にあるすべてのテーブルが持つ、すべての有効な制約と無効な制約の整合性をチェックします。

DBCC CHECKCONSTRAINTS WITH ALL_CONSTRAINTS;  
GO

参照

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