DBCC CHECKCONSTRAINTS(Transact-SQL)

아티클
04/26/2023

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance

현재 데이터베이스의 지정한 테이블에서 특정 제약 조건이나 모든 제약 조건의 무결성을 확인합니다.

Syntax

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

참고

SQL Server 2014 이전 버전의 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조하세요.

인수

table_name | table_id | constraint_name | constraint_id

검사할 테이블 또는 제약 조건입니다. table_name 또는 table_id를 지정하면 해당 테이블에 설정된 모든 제약 조건을 검사합니다. constraint_name 또는 constraint_id를 지정하면 해당 제약 조건만 검사합니다. 테이블 식별자 또는 제약 조건 식별자를 지정하지 않으면 현재 데이터베이스의 모든 테이블에 대해 설정된 모든 제약 조건을 검사합니다.

제약 조건 이름은 제약 조건이 속해 있는 테이블을 고유하게 식별합니다. 자세한 내용은 Database Identifiers을 참조하세요.

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;

쿼리 데이터는 임시 테이블에 저장됩니다. 요청한 모든 테이블이나 제약 조건의 검사가 끝나면 결과 집합이 반환됩니다.

DBCC CHECKCONSTRAINTS는 FOREIGN KEY와 CHECK 제약 조건의 무결성을 검사하지만 테이블의 디스크에서 데이터 구조의 무결성은 검사하지 않습니다. 이러한 데이터 구조 검사는 DBCC CHECKDB 및 DBCC CHECKTABLE을 사용하여 수행할 수 있습니다.

적용 대상: SQL Server 2016(13.x) 이상 버전

table_name 또는 table_id가 지정되고 시스템 버전 관리가 설정된 경우 DBCC CHECKCONSTRAINTS는 지정된 테이블에서 temporal 데이터 일관성 검사도 수행합니다. NO_INFOMSGS를 지정하지 않으면 이 명령은 별도 줄의 출력에서 각 일관성 위반을 반환합니다. 출력 형식은 ([pkcol1], [pkcol2]..) = (<pkcol1_value>, <pkcol2_value>...) AND <what is wrong with temporal table record>입니다.

확인	검사 실패 시 출력에서 추가 정보
PeriodEndColumn >= PeriodStartColumn(현재)	[sys_end] = '{0}' AND MAX(DATETIME2) = '9999-12-31 23:59:59.99999'
PeriodEndColumn >= PeriodStartColumn(현재, 기록)	[sys_start] = '{0}' AND [sys_end] = '{1}'
PeriodStartColumn < current_utc_time(현재)	[sys_start] = '{0}' AND SYSUTCTIME
PeriodEndColumn < currein_utc_time(기록)	[sys_end] = '{0}' AND SYSUTCTIME
Overlaps	두 개의 겹치는 레코드에 대한 (sys_start1, sys_end1), (sys_start2 sys_end2) 겹치는 레코드가 2개를 초과하는 경우 출력에는 각 겹치는 한 쌍을 나타내는 여러 행이 있습니다.

임시 일관성 확인을 실행하기 위해 constraint_name 또는 constraint_id를 지정할 수 없습니다.

결과 집합

DBCC CHECKCONSTRAINTS는 다음 열이 있는 행 집합을 반환합니다.

열 이름	데이터 형식	Description
테이블 이름	varchar	테이블 이름입니다.
Constraint Name	varchar	위반된 제약 조건의 이름입니다.
Where	varchar	제약 조건을 위반한 행을 식별하는 열 값 할당입니다. 이 열의 값은 제약 조건을 위반한 행을 쿼리하는 SELECT 문의 WHERE 절에 사용될 수 있습니다.

DBCC CHECKCONSTRAINTS가 모든 제약 조건 위반을 찾을 수 있다는 보장은 없습니다. 행 하나가 여러 제약 조건을 위반하는 경우 첫 번째 위반의 WHERE 절만 나열됩니다. 위반을 생성하는 값의 조합이 동일한 다른 행이 있고 해당 위반이 첫 번째 위반으로 발견된 경우 반환된 결과 집합에 값 조합이 없습니다. 데이터베이스에서 모든 제약 조건 위반을 찾기 전에 DBCC CHECKCONSTRAINTS를 실행하고 문제를 여러 번 수정해야 할 수도 있습니다.

사용 권한

sysadmin 고정 서버 역할의 멤버 또는 db_owner 고정 데이터베이스 역할의 멤버여야 합니다.

예제

A. 테이블 확인

다음은 Table1 데이터베이스에 있는 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. 특정 제약 조건 검사

다음은 CK_ProductCostHistory_EndDate 제약 조건의 무결성을 검사하는 예입니다.

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

C. 모든 테이블에서 설정 및 해제된 모든 제약 조건 검사

다음은 현재 데이터베이스의 모든 테이블에 설정 및 해제된 모든 제약 조건의 무결성을 검사하는 예입니다.

DBCC CHECKCONSTRAINTS WITH ALL_CONSTRAINTS;
GO