DBCC CHECKIDENT(Transact-SQL)

적용 대상: SQL Server Azure SQL 데이터베이스Azure SQL Managed InstanceAzure Synapse 분석

SQL Server의 지정된 테이블에 대한 현재 ID 값을 검사하고 필요한 경우 ID 값을 변경합니다. DBCC CHECKIDENT를 사용하여 ID 열의 새 현재 ID 값을 수동으로 설정할 수도 있습니다.

Transact-SQL 구문 표기 규칙

구문

SQL Server 및 Azure SQL Database에 대한 구문:

DBCC CHECKIDENT
 (
    table_name
        [ , { NORESEED | { RESEED [ , new_reseed_value ] } } ]
)
[ WITH NO_INFOMSGS ]

Azure Synapse Analytics 구문:

DBCC CHECKIDENT
 (
    table_name
        [ RESEED , new_reseed_value ]
)
[ WITH NO_INFOMSGS ]

참고

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

인수

table_name

현재 ID 값을 검사할 테이블의 이름입니다. 지정한 테이블에는 ID 열이 있어야 합니다. 테이블 이름은 식별자에 적용되는 규칙을 따라야 합니다. 2 또는 3 파트 이름은 Person.AddressType 또는 [Person].[AddressType] 같이 구분되어야 합니다.

NORESEED

현재 ID 값을 변경하지 않도록 지정합니다.

RESEED

현재 ID 값을 변경하도록 지정합니다.

new_reseed_value

ID 열의 현재 값으로 사용할 새 값입니다.

WITH NO_INFOMSGS

모든 정보 메시지를 표시하지 않습니다.

설명

현재 ID 값의 구체적인 수정 사항은 매개 변수 지정에 따라 달라집니다.

DBCC CHECKIDENT 명령 ID 수정 사항
DBCC CHECKIDENT (<table_name>, NORESEED) 현재 ID 값을 다시 설정하지 않습니다. DBCC CHECKIDENT는 ID 열의 현재 ID 값과 현재 최댓값을 반환합니다. 두 값이 같지 않으면 ID 값을 다시 설정하여 잠재적 오류를 방지하고 값이 간격 없이 순서대로 지정되도록 해야 합니다.
DBCC CHECKIDENT (<table_name>)

또는

DBCC CHECKIDENT (<table_name>, RESEED)
테이블의 현재 ID 값이 ID 열에 저장된 최대 ID 값보다 작을 경우 ID 열의 최대값을 사용하여 다시 설정됩니다. 뒷부분에 나오는 예외 섹션을 참조하세요.
DBCC CHECKIDENT (<table_name>, RESEED, <new_reseed_value>) 현재 ID 값이 new_reseed_value로 설정됩니다. 테이블이 생성된 후 삽입된 행이 없거나 TRUNCATE TABLE 문을 사용하여 모든 행을 제거한 경우에는 DBCC CHECKIDENT를 실행한 후에 처음 삽입되는 행이 new_reseed_value를 ID로 사용하게 됩니다. 테이블에 행이 있거나 DELETE 문을 사용하여 모든 행을 제거한 경우 삽입된 다음 행은 new_reseed_value + 현재 증분 값을 사용합니다. 트랜잭션이 행을 삽입하고 나중에 롤백되는 경우 삽입된 다음 행은 행이 삭제된 것처럼 new_reseed_value + 현재 증분 값을 사용합니다. 테이블이 비어 있지 않은 경우 ID 값을 ID 열의 최댓값보다 작은 숫자로 설정하면 다음 조건 중 하나가 발생할 수 있습니다.

- ID 열에 PRIMARY KEY 또는 UNIQUE 제약 조건이 있으면 생성된 ID 값이 기존 값과 충돌하므로 나중에 테이블에 삽입 작업을 수행할 때 오류 메세지 2627이 생성됩니다.

- PRIMARY KEY 또는 UNIQUE 제약 조건이 없으면 나중에 삽입 작업을 수행할 때 중복 ID 값이 생성됩니다.

예외

다음 표에서는 DBCC CHECKIDENT가 자동으로 현재 ID 값을 다시 설정하지 않는 조건을 보여주고 해당 값을 다시 설정하는 방법을 제공합니다.

조건 다시 설정 방법
현재 ID 값이 테이블의 최대값보다 큰 경우 DBCC CHECKIDENT (<table_name>, NORESEED)를 실행하여 열의 현재 최댓값을 확인합니다. 다음으로 DBCC CHECKIDENT (<table_name>, RESEED, <new_reseed_value>) 명령에서 값을 new_reseed_value로 지정합니다.

또는

DBCC CHECKIDENT (<table_name>, RESEED,<new_reseed_value>)를 낮은 값으로 설정된 new_reseed_value로 실행하고 DBCC CHECKIDENT (<table_name>, RESEED)를 실행하여 값을 수정합니다.
모든 행이 테이블에서 삭제되는 경우 새 문자열 값으로 설정된 new_reseed_valueDBCC CHECKIDENT (<table_name>, RESEED, <new_reseed_value>)를 실행합니다.

시드 값 변경

초기값은 테이블에 로드되는 첫 번째 행에 대한 ID 열에 삽입되는 값입니다. 현재 ID 값이 테이블 또는 뷰에서 생성된 마지막 ID 값인 경우 이후의 모든 행에는 현재 ID 값과 증가값이 포함됩니다.

다음 작업에 DBCC CHECKIDENT를 사용할 수 없습니다.

  • 테이블 또는 보기를 만들 때 ID 열에 대해 지정된 원래 초기값을 변경합니다.

  • 테이블 또는 뷰에서 기존 행의 초기값을 다시 설정합니다.

원래 초기값을 변경하고 기존 행을 다시 시드하려면 ID 열을 삭제하고 새로운 초기값을 지정하여 다시 만듭니다. 테이블에 데이터가 포함된 경우 지정된 초기값 및 증가값을 사용하여 기존 행에 ID 번호가 추가됩니다. 행이 업데이트되는 순서는 보장되지 않습니다.

결과 집합

ID 열이 포함된 테이블에 대한 옵션을 지정했는지 여부에 관계없이 DBCC CHECKIDENT는 하나를 제외한 모든 작업에 대해 다음 메시지를 반환합니다. 해당 작업은 새 초기값을 지정하는 것입니다.

ID 정보 확인: 현재 ID 값 '<current identity value>', 현재 열 값 '<current column value>'. DBCC 실행이 완료되었습니다. DBCC에서 오류 메시지를 출력하면 시스템 관리자에게 문의하십시오.

RESEED <new_reseed_value>를 사용하여 새 초기값을 지정하는 데 DBCC CHECKIDENT가 사용될 경우에는 다음 메시지가 반환됩니다.

ID 정보 확인: 현재 ID 값 '<current identity value>'입니다. DBCC 실행이 완료되었습니다. DBCC에서 오류 메시지를 출력하면 시스템 관리자에게 문의하십시오.

사용 권한

호출자는 테이블을 포함하는 스키마를 소유하거나 sysadmin 고정 서버 역할, db_owner 고정 데이터베이스 역할 또는 db_ddladmin 고정 데이터베이스 역할의 멤버이어야 합니다.

Azure Synapse Analytics에는 db_owner 권한이 필요합니다.

예제

A. 필요에 따라 현재 ID 값 다시 설정

다음 예제에서는 필요에 따라 AdventureWorks2022 데이터베이스에서 지정된 테이블의 현재 ID 값을 다시 설정합니다.

USE AdventureWorks2022;
GO
DBCC CHECKIDENT ('Person.AddressType');
GO

B. 현재 ID 값 보고

다음 예에서는 AdventureWorks2022 데이터베이스에 있는 지정된 테이블의 현재 ID 값을 보고하고, ID 값이 잘못되었더라도 그 값을 수정하지 않습니다.

USE AdventureWorks2022;
GO
DBCC CHECKIDENT ('Person.AddressType', NORESEED);
GO

C. 현재 ID 값을 새로운 값으로 설정

다음 예에서는 AddressTypeID 테이블에 있는 AddressType 열의 현재 ID 값을 10으로 강제 설정합니다. 테이블에는 기존 행이 있기 때문에 다음으로 삽입되는 행은 11을 값으로 사용합니다. 열+1에 대해 정의된 새 현재 ID 값(열의 증분 값).

USE AdventureWorks2022;
GO
DBCC CHECKIDENT ('Person.AddressType', RESEED, 10);
GO

D. 빈 테이블에 ID 값 다시 설정

다음 예에서는 (1, 1)의 테이블 ID를 추정하고 테이블에서 모든 레코드를 삭제한 후 ErrorLog 테이블의 ErrorLogID 열에 있는 현재 ID 값을 1로 강제 설정합니다. 테이블에 기존 행이 없기 때문에 삽입된 다음 행은 열에 대해 TRUNCATE 이후 정의된 증분 값을 추가하지 않고 새로운 현재 ID 값으로 1을 사용하거나 DELETE 이후 증분을 추가합니다.

USE AdventureWorks2022;
GO
TRUNCATE TABLE dbo.ErrorLog
GO
DBCC CHECKIDENT ('dbo.ErrorLog', RESEED, 1);
GO
DELETE FROM dbo.ErrorLog
GO
DBCC CHECKIDENT ('dbo.ErrorLog', RESEED, 0);
GO

추가 정보