CREATE | ALTER TABLE … CONSTRAINT¶

이 항목에서는 CREATE TABLE, CREATE HYBRID TABLE 또는 ALTER TABLE 문에 CONSTRAINT 절을 지정하여 제약 조건을 만드는 방법에 대해 설명합니다.

인라인 제약 조건은 개별 열 정의의 일부로 지정됩니다.
아웃오브 라인 제약 조건은 독립된 절로 지정됩니다.
- 테이블을 만들 때 이 절은 테이블에 대한 열 정의의 일부입니다.
- 테이블을 변경할 때 이 절은 테이블에 대한 명시적인 ADD 작업으로 지정됩니다.

자세한 내용은 제약 조건 섹션을 참조하십시오.

하이브리드 테이블 을 만들거나 변경하는 경우 제약 조건을 정의하는 구문은 동일하지만, 규칙과 요구 사항은 다릅니다.

인라인 제약 조건 구문¶

CREATE TABLE <name> ( <col1_name> <col1_type>    [ NOT NULL ] { inlineUniquePK | inlineFK }
                     [ , <col2_name> <col2_type> [ NOT NULL ] { inlineUniquePK | inlineFK } ]
                     [ , ... ] )

ALTER TABLE <name> ADD COLUMN <col_name> <col_type> [ NOT NULL ] { inlineUniquePK | inlineFK }

Copy

여기서:

inlineUniquePK ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE | PRIMARY KEY }
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]

Copy

inlineFK :=
  [ CONSTRAINT <constraint_name> ]
  [ FOREIGN KEY ]
  REFERENCES <ref_table_name> [ ( <ref_col_name> ) ]
  [ MATCH { FULL | SIMPLE | PARTIAL } ]
  [ ON [ UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]
       [ DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ] ]
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]

Copy

아웃오브 라인 제약 조건 구문¶

CREATE TABLE <name> ... ( <col1_name> <col1_type>
                         [ , <col2_name> <col2_type> , ... ]
                         [ , { outoflineUniquePK | outoflineFK } ]
                         [ , { outoflineUniquePK | outoflineFK } ]
                         [ , ... ] )

ALTER TABLE <name> ... ADD { outoflineUniquePK | outoflineFK }

Copy

여기서:

outoflineUniquePK ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE | PRIMARY KEY } ( <col_name> [ , <col_name> , ... ] )
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]
  [ COMMENT '<string_literal>' ]

Copy

outoflineFK :=
  [ CONSTRAINT <constraint_name> ]
  FOREIGN KEY ( <col_name> [ , <col_name> , ... ] )
  REFERENCES <ref_table_name> [ ( <ref_col_name> [ , <ref_col_name> , ... ] ) ]
  [ MATCH { FULL | SIMPLE | PARTIAL } ]
  [ ON [ UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]
       [ DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ] ]
  [ [ NOT ] ENFORCED ]
  [ [ NOT ] DEFERRABLE ]
  [ INITIALLY { DEFERRED | IMMEDIATE } ]
  [ { ENABLE | DISABLE } ]
  [ { VALIDATE | NOVALIDATE } ]
  [ { RELY | NORELY } ]
  [ COMMENT '<string_literal>' ]

Copy

제약 조건 속성¶

다른 데이터베이스와의 호환성을 보장하고 하이브리드 테이블과 함께 사용하기 위해 Snowflake는 제약 조건 속성을 제공합니다. 제약 조건에 대해 지정할 수 있는 속성은 다음과 같이 유형에 따라 다릅니다.

일부 속성은 모든 키(고유, 기본, 외래)에 적용됩니다.
외래 키에만 적용되는 다른 속성도 있습니다.

중요

표준 Snowflake 테이블의 경우 다른 데이터베이스에서 쉽게 마이그레이션할 수 있도록 이러한 속성이 제공됩니다. Snowflake에서는 이들 속성을 적용하거나 유지 관리하지 않습니다. 이는 이러한 속성의 기본값을 변경할 수 있지만, 기본값을 변경하면 Snowflake에서 제약 조건을 만들지 않게 된다는 뜻입니다.

예외로 RELY 속성이 있습니다. 표준 테이블의 데이터가 UNIQUE, PRIMARY KEY 및 FOREIGN KEY 제약 조건을 준수하는 경우 해당 제약 조건의 RELY 속성을 설정할 수 있습니다. 불필요한 조인을 제거하도록 RELY 제약 조건 속성 설정하기 도 참조하십시오.

하이브리드 테이블 을 만들거나 변경하는 경우 규칙과 요구 사항은 다릅니다. 제약 조건의 개요 섹션을 참조하십시오.

지원되는 제약 조건 속성은 대부분 ANSI SQL 표준 속성이지만, 다음 속성은 Snowflake 확장입니다.

ENABLE | DISABLE
VALIDATE | NOVALIDATE
RELY | NORELY

또한 아웃오브 라인 제약 조건 정의 내에서 설명을 정의할 수도 있습니다. 제약 조건에 대한 설명 섹션을 참조하십시오.

모든 제약 조건의 속성¶

모든 제약 조건에 다음 속성이 적용됩니다(속성의 순서는 상호 교환 가능).

[ NOT ] ENFORCED
[ NOT ] DEFERRABLE
INITIALLY { DEFERRED | IMMEDIATE }
{ ENABLE | DISABLE }
{ VALIDATE | NOVALIDATE }
{ RELY | NORELY }

Copy

{ ENFORCED | NOT ENFORCED }

트랜잭션에서 제약 조건을 강제 적용할지 여부를 지정합니다. 표준 테이블의 경우 NOT NULL은 이 속성과 관계없이 Snowflake에서 적용하는 유일한 제약 조건 유형입니다.

하이브리드 테이블의 경우 PRIMARY KEY, FOREIGN KEY, UNIQUE 제약 조건에 NOT ENFORCED 속성을 설정할 수 없습니다. 이 속성을 설정하면 “invalid constraint property” 오류가 발생합니다.

참조 무결성 제약 조건 도 참조하십시오.

기본값: NOT ENFORCED

{ DEFERRABLE | NOT DEFERRABLE }

후속 트랜잭션에서 트랜잭션이 끝날 때까지 제약 조건 검사를 연기할 수 있을지 여부를 지정합니다.

기본값: DEFERRABLE

INITIALLY { DEFERRED | IMMEDIATE }

DEFERRABLE 제약 조건의 경우 제약 조건 검사가 다음 트랜잭션부터 연기될 수 있는지 여부를 지정합니다.

기본값: INITIALLY DEFERRED

{ ENABLE | DISABLE }

제약 조건을 사용할지, 사용하지 않을지 지정합니다. 이러한 속성은 Oracle과의 호환성을 위해 제공됩니다.

기본값: DISABLE

{ VALIDATE | NOVALIDATE }

제약 조건을 만들 때 테이블에 있는 기존 데이터의 유효성을 검사할지 여부를 지정합니다. { ENFORCED | NOT ENFORCED } 또는 { ENABLE | DISABLE } 이 지정되어 있을 때만 적용됩니다.

기본값: NOVALIDATE

{ RELY | NORELY }

쿼리 재작성 중에 NOVALIDATE 모드의 제약 조건을 고려할지 여부를 지정합니다.

테이블의 데이터가 제약 조건을 준수하는지 확인한 경우 이 속성을 RELY로 변경하여 쿼리 최적화 프로그램에서 이러한 데이터 무결성을 예상해야 함을 나타낼 수 있습니다. 표준 테이블의 경우 RELY 제약 조건을 적용하는 것은 사용자의 책임이며, 이를 올바로 적용하지 않을 경우 의도치 않은 동작 및/또는 예기치 않은 결과가 발생할 위험이 있습니다.

RELY 속성을 설정하면 쿼리 성능이 향상될 수 있습니다(예: 불필요한 조인을 제거 함으로써).

기본 및 외래 키 제약 조건의 경우, 기본 키 제약 조건과 외래 키 제약 조건 둘 다에 대해 이 속성을 설정합니다. 예:

ALTER TABLE table_with_primary_key ALTER CONSTRAINT a_primary_key_constraint RELY;
ALTER TABLE table_with_foreign_key ALTER CONSTRAINT a_foreign_key_constraint RELY;

Copy

기본값: NORELY

외래 키 제약 조건 전용 속성¶

다음 제약 조건 속성은 외래 키에만 적용됩니다(속성의 순서는 상호 교환 가능).

MATCH { FULL | SIMPLE | PARTIAL }
ON [ UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]
   [ DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION } ]

Copy

MATCH { FULL | PARTIAL | SIMPLE }

하나 이상의 열에 있는 NULL 값에 관해 외래 키 상수가 충족되는지 여부를 지정합니다.

기본값: MATCH FULL

UPDATE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION }

외래 키의 기본/고유 키가 업데이트될 때 수행되는 작업을 지정합니다.

기본값: UPDATE NO ACTION

DELETE { CASCADE | SET NULL | SET DEFAULT | RESTRICT | NO ACTION }

외래 키의 기본/고유 키가 삭제될 때 수행되는 작업을 지정합니다.

기본값: DELETE NO ACTION

ENABLE 및 VALIDATE 속성의 기본값이 아닌 값¶

다른 데이터베이스와의 구문 호환성을 위해 Snowflake는 제약 조건 속성에 기본값 이외의 값을 지정하는 것을 지원합니다.

그러나 새 제약 조건을 만들 때 ENABLE 또는 VALIDATE(이러한 속성에 대한 기본값 이외 값)를 지정하면 제약 조건이 만들어지지 않습니다. 이것은 RELY 에 적용되지 않습니다. RELY 를 지정하면 새 제약 조건이 만들어집니다.

Snowflake는 제약 조건 생성 중에 기본값이 아닌 값을 지정하면 오류를 생성할지 여부를 결정하는 세션 매개 변수 UNSUPPORTED_DDL_ACTION 을 제공합니다.

제약 조건에 대한 설명¶

다른 데이터베이스 오브젝트 및 구문과 마찬가지로, Snowflake는 제약 조건에 대한 설명을 지원합니다.

아웃오브 라인 제약 조건은 제약 조건 정의 내에서 COMMENT 절을 지원합니다.

CREATE OR REPLACE TABLE uni (c1 INT, c2 int, CONSTRAINT uni1 UNIQUE(C1) COMMENT 'Unique column');

Copy

열 정의 내의 COMMENT 절은 열 자체나 해당 제약 조건에 대한 설명을 다는 데 사용할 수 있습니다.
```
CREATE OR REPLACE TABLE uni (c1 INT UNIQUE COMMENT 'Unique column', c2 int);
```
Copy

다음과 같은 제한 사항이 있습니다.

COMMENT 명령을 사용하여 제약 조건에 대한 설명을 설정할 수 없습니다.
DESCRIBE TABLE 명령은 열에 정의된 설명을 표시하지만 제약 조건에 정의된 설명은 표시하지 않습니다. 제약 조건에 대한 설명을 보려면 TABLE_CONSTRAINTS 뷰 또는 REFERENTIAL_CONSTRAINTS 뷰 중에서 선택합니다.
열 및 제약 조건 정의 내의 COMMENT 절은 등호(=)를 지원하지 않습니다. 다음을 지정하지 마십시오.
```
COMMENT = 'My comment'
```
Copy
이전 예에 표시된 구문을 사용합니다.
```
COMMENT 'My comment'
```
Copy

사용법 노트¶

NOT NULL 은 열에 NULL 값이 허용되지 않음을 지정합니다.
- 표준 Snowflake 테이블의 경우 이것이 적용되는 유일한 제약 조건입니다. 참조 무결성 제약 조건 섹션을 참조하십시오.
- 열 정의 내에서 인라인 제약 조건으로만 지정할 수 있습니다.
- 기본값은 열에 NULL 값을 허용하는 것입니다.
다중 열 제약 조건(복합 고유 키 또는 복합 기본 키)은 아웃오브 라인에서만 정의할 수 있습니다.
인라인이나 아웃오브 라인으로 외래 키를 정의할 때, 외래 키 열과 참조된 테이블의 기본 키 열의 서명(이름과 데이터 타입)이 정확히 일치하는 경우 참조된 테이블의 열 이름을 지정할 필요가 없습니다.

외래 키를 생성하는 경우 REFERENCES 절의 열은 기본 키에 대해 나열된 열과 동일한 순서로 나열되어야 합니다. 예:
```
CREATE TABLE parent ... CONSTRAINT primary_key_1 PRIMARY KEY (c_1, c_2) ...
CREATE TABLE child  ... CONSTRAINT foreign_key_1 FOREIGN KEY (...) REFERENCES parent (c_1, c_2) ...
```
Copy
두 경우 모두 열의 순서는 c_1, c_2 입니다. 외래 키의 열 순서가 달랐다면(예: c_2, c_1) 외래 키 생성 시도가 실패했을 것입니다.

액세스 제어 요구 사항¶

기본 키 또는 고유한 제약 조건 만들기:

기존 테이블을 변경하여 제약 조건을 추가하는 경우 테이블에 대한 OWNERSHIP 권한이 있는 역할을 사용해야 합니다.
새 테이블을 만들 때 테이블이 생성될 스키마에 대해 CREATE TABLE 권한이 있는 역할을 사용해야 합니다.

외래 키 제약 조건 만들기:

외래 키 테이블에 대한 OWNERSHIP 권한이 있는 역할을 사용해야 합니다.
고유/기본 키 테이블에 대한 REFERENCES 권한이 있는 역할을 사용해야 합니다.

GRANT <권한> 및 REVOKE <권한> 명령을 사용해 REFERENCES 권한을 역할에 부여하고 부여한 권한을 취소할 수 있습니다.

GRANT REFERENCES ON TABLE <pk_table_name> TO ROLE <role_name>

REVOKE REFERENCES ON TABLE <pk_table_name> FROM ROLE <role_name>

Copy

표준 테이블이 있는 예¶

하이브리드 테이블의 제약 조건에 대한 예는 CREATE HYBRID TABLE 섹션을 참조하십시오.

아래 예에서는 테이블을 만드는 동안 간단한 NOT NULL 제약 조건을 만들고 테이블을 변경하는 동안 또 다른 NOT NULL 제약 조건을 만드는 방법을 보여줍니다.

테이블을 만드는 동시에 제약 조건 만들기:

CREATE TABLE table1 (col1 INTEGER NOT NULL);

Copy

제약 조건이 있는 열을 추가하도록 테이블 변경하기:

ALTER TABLE table1 ADD COLUMN col2 VARCHAR NOT NULL;

Copy

다음 예에서는 열의 의도가 고유한 값을 유지하는 것임을 지정하지만, 제약 조건이 실제로 적용되지 않음을 분명히 합니다. 이 예에서는 제약 조건의 이름(이 경우 “uniq_col3”)을 지정하는 방법도 설명합니다.

ALTER TABLE table1 
  ADD COLUMN col3 VARCHAR NOT NULL CONSTRAINT uniq_col3 UNIQUE NOT ENFORCED;

Copy

다음은 기본 키 제약 조건이 있는 부모 테이블과 첫 번째 테이블의 기본 키 제약 조건과 같은 열을 가리키는 외래 키 제약 조건이 있는 다른 테이블을 만드는 예입니다.

CREATE TABLE table2 (
  col1 INTEGER NOT NULL,
  col2 INTEGER NOT NULL,
  CONSTRAINT pkey_1 PRIMARY KEY (col1, col2) NOT ENFORCED
);
CREATE TABLE table3 (
  col_a INTEGER NOT NULL,
  col_b INTEGER NOT NULL,
  CONSTRAINT fkey_1 FOREIGN KEY (col_a, col_b) REFERENCES table2 (col1, col2) NOT ENFORCED
);

Copy