ALTER TABLE column_constraint(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

ALTER TABLE을 사용하여 테이블에 추가된 새 열 정의의 일부인 PRIMARY KEY, FOREIGN KEY, UNIQUE 또는 CHECK 제약 조건의 속성을 지정합니다.

참고 항목

Microsoft Fabric의 경우 ALTER TABLE column_constraint 방문하여 원하는 제품 버전을 선택합니다.

Transact-SQL 구문 표기 규칙

Syntax

[ CONSTRAINT constraint_name ]   
{   
    [ NULL | NOT NULL ]   
    { PRIMARY KEY | UNIQUE }   
        [ CLUSTERED | NONCLUSTERED ]   
        [ WITH FILLFACTOR = fillfactor ]   
        [ WITH ( index_option [, ...n ] ) ]  
        [ ON { partition_scheme_name (partition_column_name)   
            | filegroup | "default" } ]   
    | [ FOREIGN KEY ]   
        REFERENCES [ schema_name . ] referenced_table_name   
            [ ( ref_column ) ]   
        [ ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]   
        [ ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]   
        [ NOT FOR REPLICATION ]   
    | CHECK [ NOT FOR REPLICATION ] ( logical_expression )  
}

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

CONSTRAINT
PRIMARY KEY, UNIQUE, FOREIGN KEY 또는 CHECK 제약 조건에 대한 정의의 시작을 지정합니다.

constraint_name
제약 조건의 이름입니다. 제약 조건 이름은 identifiers에 적용되는 규칙을 따라야 하지만 숫자 기호(#)로 시작될 수 없습니다. constraint_name을 지정하지 않으면 시스템에서 생성한 이름이 제약 조건에 할당됩니다.

NULL | NOT NULL
열에 Null 값 허용 여부를 지정합니다. Null 값이 허용되지 않는 열은 기본값이 지정된 경우에만 추가할 수 있습니다. 새 열에 Null 값이 허용되고 기본값이 지정되지 않은 경우 새 열은 테이블의 각 행에 대해 NULL 값을 가집니다. 새 열에 Null 값이 허용되고 DEFAULT 정의가 추가된 경우 WITH VALUES 옵션을 사용하여 새 열에 테이블의 각 기존 행에 대한 기본값을 저장할 수 있습니다.

새 열에 Null 값이 허용되지 않는 경우 DEFAULT 정의를 추가해야 합니다. 각 기존 행의 새 열에 자동으로 기본값이 로드됩니다.

열을 추가하기 위해 각 행에 DEFAULT 값을 추가하는 등 테이블의 데이터 행을 실제로 변경해야 하는 경우 ALTER TABLE이 실행되는 동안 테이블에 잠금이 설정됩니다. 잠금이 설정되어 있는 동안 테이블 내용 변경 기능이 영향을 받습니다. 이와 달리 Null 값이 허용되고 기본값이 지정되지 않은 열을 추가하는 것은 메타데이터 작업 전용이며 잠금이 설정되지 않습니다.

CREATE TABLE 또는 ALTER TABLE을 사용하는 경우 데이터베이스 및 세션 설정은 열 정의에 사용되는 데이터 형식의 Null 허용 여부에 영향을 주거나 이를 무시할 수 있습니다. 비계산 열은 항상 NULL 또는 NOT NULL로 명시적으로 정의하는 것이 좋으며 사용자 정의 데이터 형식을 사용할 때는 열에 해당 데이터 형식의 기본 Null 허용 여부를 적용하는 것이 좋습니다. 자세한 내용은 CREATE TABLE(Transact-SQL)을 참조하세요.

PRIMARY KEY
지정한 열에 대해 고유 인덱스를 사용하여 엔터티 무결성을 적용하는 제약 조건입니다. PRIMARY KEY 제약 조건은 테이블마다 한 개씩만 만들 수 있습니다.

UNIQUE
지정한 열에 대해 고유 인덱스를 사용하여 엔터티 무결성을 제공하는 제약 조건입니다.

CLUSTERED | NONCLUSTERED
PRIMARY KEY 또는 UNIQUE 제약 조건에 대해 클러스터형 인덱스나 비클러스터형 인덱스를 만들도록 지정합니다. PRIMARY KEY 제약 조건의 기본값은 CLUSTERED입니다. UNIQUE 제약 조건의 기본값은 NONCLUSTERED입니다.

테이블에 클러스터형 제약 조건이나 인덱스가 이미 있으면 CLUSTERED를 지정할 수 없습니다. 이 경우 PRIMARY KEY 제약 조건은 기본적으로 NONCLUSTERED로 설정됩니다.

데이터 형식이 ntext, text, varchar(max) , nvarchar(max) , varbinary(max) , xml 또는 image인 열은 인덱스의 열로 지정할 수 없습니다.

WITH FILLFACTOR =fillfactor
데이터베이스 엔진이 인덱스 데이터를 저장하는 데 사용되는 각 인덱스 페이지를 채우는 정도를 지정합니다. 사용자 지정 채우기 비율 값은 1에서 100 사이입니다. 값을 지정하지 않으면 기본값 0이 사용됩니다.

중요

현재 WITH FILLFACTOR = fillfactor가 PRIMARY KEY 또는 UNIQUE 제약 조건에 적용되는 유일한 인덱스 옵션으로 기술되어 있는 것은 이전 버전과의 호환성을 위한 것이며 이후 릴리스에서는 이런 식으로 기술되지 않을 것입니다. ALTER TABLE의 index_option 절에 다른 인덱스 옵션을 지정할 수 있습니다.

ON { partition_scheme_name(partition_column_name) | filegroup | "default" } Applies to: SQL Server 2008(10.0.x) 이상

제약 조건에 대해 만들어진 인덱스의 스토리지 위치를 지정합니다. partition_scheme_name을 지정하면 인덱스가 분할되고 파티션이 partition_scheme_name으로 지정된 파일 그룹에 매핑됩니다. filegroup을 지정하면 명명된 파일 그룹에 인덱스가 생성됩니다. "default"를 지정하거나, ON을 지정하지 않으면 테이블이 있는 동일한 파일 그룹에 인덱스가 생성됩니다. PRIMARY KEY 또는 UNIQUE 제약 조건에 대해 클러스터형 인덱스를 추가할 때 ON을 지정하면 클러스터형 인덱스가 생성될 때 전체 테이블이 지정한 파일 그룹으로 이동됩니다.

여기서 말하는 default는 키워드가 아니라 이것은 기본 파일 그룹에 대한 식별자이며 ON "default" 또는 ON [default]와 같이 구분되어야 합니다. "default"를 지정하면 현재 세션의 QUOTED_IDENTIFIER 옵션이 ON이어야 합니다. 이 값은 기본 설정입니다. 자세한 내용은 SET QUOTED_IDENTIFIER(Transact-SQL)를 참조하세요.

FOREIGN KEY REFERENCES
특정 열의 데이터에 대한 참조 무결성을 제공하는 제약 조건입니다. FOREIGN KEY 제약 조건을 지정하려면 해당 열의 각 값이 참조되는 테이블의 지정한 열에 있어야 합니다.

schema_name
FOREIGN KEY 제약 조건에 의해 참조된 테이블이 속한 스키마의 이름입니다.

referenced_table_name
FOREIGN KEY 제약 조건에 의해 참조되는 테이블입니다.

ref_column
새 FOREIGN KEY 제약 조건에 의해 참조되는 열로 괄호 안에 표시됩니다.

ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }
행에 참조 관계가 있고 참조되는 행이 부모 테이블에서 삭제될 경우 변경된 테이블의 행에 수행될 동작을 지정합니다. 기본값은 NO ACTION입니다.

NO ACTION
SQL Server 데이터베이스 엔진에서는 오류가 발생하며 부모 테이블의 행에 대한 삭제 동작이 롤백됩니다.

CASCADE
부모 테이블에서 행을 삭제한 경우 참조 테이블에서 해당 행이 삭제됩니다.

SET NULL
부모 테이블에서 행을 삭제하면 해당 외래 키를 구성하는 모든 값이 NULL로 설정됩니다. 이 제약 조건을 실행하려면 외래 키 열이 Null을 허용해야 합니다.

SET DEFAULT
부모 테이블에서 행을 삭제하면 해당 외래 키를 구성하는 모든 값이 기본값으로 설정됩니다. 이 제약 조건을 실행하려면 모든 외래 키 열에 기본 정의가 있어야 합니다. 열이 Null을 허용하고 명시적으로 설정된 기본값이 없을 경우 열의 암시적 기본값은 NULL이 됩니다.

논리적 레코드를 사용하는 병합 게시에 테이블이 포함되는 경우 CASCADE를 지정하지 마세요. 논리적 레코드에 대한 자세한 내용은 논리적 레코드를 사용하여 관련된 행의 변경 내용 그룹화를 참조하세요.

변경할 테이블에 INSTEAD OF 트리거 ON DELETE가 이미 있으면 ON DELETE CASCADE를 정의할 수 없습니다.

예를 들어 AdventureWorks2022 데이터베이스에서 ProductVendor 테이블은 Vendor 테이블과 참조 관계를 갖습니다. ProductVendor.VendorID 외래 키는 Vendor.VendorID 기본 키를 참조합니다.

Vendor 테이블의 행에 대해 DELETE 문을 실행하고 ProductVendor.VendorID에 대해 ON DELETE CASCADE 동작을 지정하면 데이터베이스 엔진은 ProductVendor 테이블에 하나 이상의 종속 행이 있는지 확인합니다. ProductVendor 테이블에 종속 행이 있는 경우 삭제되며 Vendor 테이블에서 참조된 행도 삭제됩니다.

반대로 NO ACTION을 지정한 경우 ProductVendor 테이블에 Vendor 행을 참조하는 행이 하나 이상 있으면 데이터베이스 엔진에서 오류가 발생하고 참조된 행의 삭제 동작이 롤백됩니다.

ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }
변경된 테이블의 행에 참조 관계가 있고 참조된 행이 부모 테이블에서 업데이트될 경우 해당 행에 대해 발생할 동작을 지정합니다. 기본값은 NO ACTION입니다.

NO ACTION
데이터베이스 엔진에서는 오류가 발생하며 부모 테이블의 행에 대한 업데이트 동작이 롤백됩니다.

CASCADE
부모 테이블에서 행이 업데이트될 때 참조 테이블에서도 해당 행이 업데이트됩니다.

SET NULL
부모 테이블에서 행을 업데이트하면 해당 외래 키를 구성하는 모든 값이 NULL로 설정됩니다. 이 제약 조건을 실행하려면 외래 키 열이 Null을 허용해야 합니다.

SET DEFAULT
부모 테이블에서 행을 업데이트하면 해당 외래 키를 구성하는 모든 값이 기본값으로 설정됩니다. 이 제약 조건을 실행하려면 모든 외래 키 열에 기본 정의가 있어야 합니다. 열이 Null을 허용하고 명시적으로 설정된 기본값이 없을 경우 열의 암시적 기본값은 NULL이 됩니다.

논리적 레코드를 사용하는 병합 게시에 테이블이 포함되는 경우 CASCADE를 지정하지 마세요. 논리적 레코드에 대한 자세한 내용은 논리적 레코드를 사용하여 관련된 행의 변경 내용 그룹화를 참조하세요.

변경할 테이블에 INSTEAD OF 트리거 ON UPDATE가 이미 존재하면 ON UPDATE CASCADE, SET NULL 또는 SET DEFAULT를 정의할 수 없습니다.

예를 들어 AdventureWorks2022 데이터베이스에서 ProductVendor 테이블은 Vendor 테이블과 참조 관계를 갖습니다. ProductVendor.VendorID 외래 키는 Vendor.VendorID 기본 키를 참조합니다.

Vendor 테이블의 행에 대해 UPDATE 문을 실행하고 ProductVendor.VendorID에 대해 ON UPDATE CASCADE 동작을 지정하면 데이터베이스 엔진는 ProductVendor 테이블에 하나 이상의 종속 행이 있는지 확인합니다. ProductVendor 테이블에 종속 행이 있는 경우 업데이트되며 Vendor 테이블에서 참조된 행도 업데이트됩니다.

반대로 NO ACTION을 지정한 경우 ProductVendor 테이블에 Vendor 행을 참조하는 행이 하나 이상 있으면 데이터베이스 엔진에서 오류가 발생하고 참조된 행의 업데이트 동작이 롤백됩니다.

NOT FOR REPLICATION
적용 대상: SQL Server 2008(10.0.x) 이상

FOREIGN KEY 제약 조건 및 CHECK 제약 조건에 대해 지정할 수 있습니다. 제약 조건에 대해 이 절을 지정하면 복제 에이전트가 삽입, 업데이트 또는 삭제 작업을 수행할 때 해당 제약 조건이 강제로 적용되지 않습니다.

CHECK
열에 입력 가능한 값을 제한하여 도메인 무결성을 적용하는 제약 조건입니다.

logical_expression
CHECK 제약 조건에 사용되는 논리 식이며 TRUE 또는 FALSE를 반환합니다. logical_expression을 CHECK 제약 조건에 사용하면 다른 테이블을 참조할 수 없지만 같은 행에 대해 동일한 테이블의 다른 열은 참조할 수 있습니다. 식은 별칭 데이터 형식을 참조할 수 없습니다.

설명

WITH NOCHECK 옵션을 지정하지 않으면 FOREIGN KEY 또는 CHECK 제약 조건이 추가될 경우 기존의 모든 데이터에 대해 제약 조건 위반 검사가 수행됩니다. 제약 조건 위반이 발생할 경우 ALTER TABLE이 실패하고 오류가 반환됩니다. 기존 열에 PRIMARY KEY 또는 UNIQUE 제약 조건을 새로 추가하려면 열의 데이터가 고유해야 합니다. 중복된 값이 있으면 ALTER TABLE이 실패합니다. PRIMARY KEY 또는 UNIQUE 제약 조건을 추가하면 WITH NOCHECK 옵션이 적용되지 않습니다.

각 PRIMARY KEY 및 UNIQUE 제약 조건은 인덱스를 생성합니다. UNIQUE 및 PRIMARY KEY 제약 조건의 수가 많아도 테이블의 비클러스터형 인덱스는 999개, 클러스터형 인덱스는 1개를 초과할 수 없습니다. FOREIGN KEY 제약 조건은 인덱스를 자동으로 생성하지 않습니다. 그러나 외래 키 열은 쿼리에서 한 테이블의 FOREIGN KEY 제약 조건 열을 다른 테이블의 기본 또는 고유 키 열과 연결하는 조인에서 자주 사용됩니다. 데이터베이스 엔진에서는 외래 키 열의 인덱스를 만들어 외래 키 테이블에 있는 관련 데이터를 빠르게 찾을 수 있습니다.

예제

예제는 ALTER TABLE(Transact-SQL)을 참조하세요.

참고 항목

ALTER TABLE(Transact-SQL)
column_definition(Transact-SQL)

적용 대상:Microsoft Fabric의 Warehouse

Microsoft Fabric의 Warehouse에서 ALTER TABLE을 사용하여 테이블에 추가된 PRIMARY KEY, UNIQUE, FOREIGN KEY, CHECK 제약 조건 또는 DEFAULT 정의의 속성을 지정합니다.

참고 항목

SQL Server 및 Azure SQL 플랫폼의 경우 ALTER TABLE column_constraint 방문하여 원하는 제품 버전을 선택합니다.

Transact-SQL 구문 표기 규칙

구문

[ CONSTRAINT constraint_name ]  
{  
    { PRIMARY KEY | UNIQUE }  
       NONCLUSTERED    
        (column [ ASC | DESC ] [ ,...n ] )  
NOT ENFORCED
    | FOREIGN KEY  
        ( column [ ,...n ] )  
        REFERENCES referenced_table_name [ ( ref_column [ ,...n ] ) ]  
NOT ENFORCED
}

인수

CONSTRAINT

PRIMARY KEY, UNIQUE 또는 FOREIGN KEY에 대한 정의의 시작을 지정합니다.

constraint_name
제약 조건의 이름입니다. 제약 조건 이름은 identifiers에 적용되는 규칙을 따라야 하지만 숫자 기호(#)로 시작될 수 없습니다. constraint_name을 지정하지 않으면 시스템에서 생성한 이름이 제약 조건에 할당됩니다.

PRIMARY KEY

사용자는 잘못된 쿼리 결과를 방지하기 위해 지정된 열 또는 열에 대한 엔터티 무결성이 고유한지 수동으로 확인해야 합니다. PRIMARY KEY 제약 조건은 테이블마다 한 개씩만 만들 수 있습니다.

UNIQUE

사용자는 잘못된 쿼리 결과를 방지하기 위해 지정된 열 또는 열에 대한 엔터티 무결성이 고유한지 수동으로 확인해야 합니다.

NONCLUSTERED

마이그레이션 구문 호환성에 필요하지만 웨어하우스에는 영향을 주지 않습니다.

column
새 제약 조건에 사용되는 열 또는 열 목록을 괄호 안에 지정합니다.

[ ASC | DESC ]
테이블 제약 조건에 사용되는 열의 정렬 순서를 지정합니다. 기본값은 ASC입니다.

NOT ENFORCED

Microsoft Fabric에서 기본 키, 고유 키 및 외래 키 제약 조건에는 NOT ENFORCED가 필요합니다. 애플리케이션에서 제약 조건의 무결성을 기본 합니다.

FOREIGN KEY REFERENCES

사용자는 잘못된 쿼리 결과를 방지하기 위해 FOREIGN KEY 제약 조건에 열의 각 값이 있고 참조된 테이블의 지정된 열에도 있는지 수동으로 확인해야 합니다.

referenced_table_name
FOREIGN KEY 제약 조건에 의해 참조되는 테이블입니다.

ref_column
새 FOREIGN KEY 제약 조건에 의해 참조되는 열 또는 열 목록을 괄호 안에 표시합니다.

예를 들어 AdventureWorks2022 데이터베이스에서 ProductVendor 테이블은 Vendor 테이블과 참조 관계를 갖습니다. ProductVendor.VendorID 외래 키는 Vendor.VendorID 기본 키를 참조합니다.

다음 단계