`ALTER TABLE`

ALTER TABLE은 테이블의 정의를 변경합니다.

지원되는 구문


ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ]
    action [, ... ]
ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ]
    RENAME [ COLUMN ] column_name TO new_column_name
ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ]
    RENAME CONSTRAINT constraint_name TO new_constraint_name
ALTER TABLE [ IF EXISTS ] name
    RENAME TO new_name
ALTER TABLE [ IF EXISTS ] name
    SET SCHEMA new_schema

where action is one of:

    ADD [ COLUMN ] [ IF NOT EXISTS ] column_name data_type [ STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN | DEFAULT } ]
    ALTER [ COLUMN ] column_name SET DEFAULT expression
    ALTER [ COLUMN ] column_name DROP DEFAULT
    ALTER [ COLUMN ] column_name DROP NOT NULL
    ALTER [ COLUMN ] column_name DROP EXPRESSION [ IF EXISTS ]
    ALTER [ COLUMN ] column_name ADD GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY [ ( sequence_options ) ]
    ALTER [ COLUMN ] column_name { SET GENERATED { ALWAYS | BY DEFAULT } | SET sequence_option | RESTART [ [ WITH ] restart ] } [...]
    ALTER [ COLUMN ] column_name DROP IDENTITY [ IF EXISTS ]
    ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN | DEFAULT }
    ADD table_constraint_using_index
    DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ]
    OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

and table_constraint_using_index is:

    [ CONSTRAINT constraint_name ]
    UNIQUE USING INDEX index_name

설명

ADD [ COLUMN ] [ IF NOT EXISTS ]

이 양식은 CREATE TABLE와 동일한 구문을 사용하여 테이블에 새 열을 추가합니다. IF NOT EXISTS가 지정되어 있고 이 이름의 열이 이미 있는 경우 오류가 발생하지 않습니다.

SET/DROP DEFAULT

이러한 양식은 열의 기본값을 설정 또는 제거합니다(제거는 기본값을 NULL로 설정하는 것과 동일함). 새 기본값은 후속 INSERT 또는 UPDATE 명령에만 적용되며 테이블에 이미 있는 행은 변경되지 않습니다.

DROP NOT NULL

이 양식은 null 값을 허용하도록 열을 변경합니다.

DROP EXPRESSION [ IF EXISTS ]

이 양식은 저장된 생성 열을 일반 기본 열로 바꿉니다. 열의 기존 데이터는 유지되지만 향후 변경 사항은 더 이상 생성 표현식을 적용하지 않습니다. DROP EXPRESSION IF EXISTS가 지정되어 있고 열이 생성 열이 아닌 경우 오류가 발생하지 않습니다. 이 경우 대신 알림이 발행됩니다.

ADD GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY

SET GENERATED { ALWAYS | BY DEFAULT }

DROP IDENTITY [ IF EXISTS ]

이러한 양식은 열이 ID 열인지 아니면 기존 ID 열의 생성 속성을 변경하는지 여부를 변경합니다. 세부 정보는 CREATE TABLE 섹션을 참조하세요. SET DEFAULT와 마찬가지로 이러한 형식은 후속 INSERT 및 UPDATE 명령의 동작에만 영향을 미치며 테이블에 이미 있는 행은 변경되지 않습니다.

sequence_option은 INCREMENT BY와 같이 ALTER SEQUENCE에서 지원하는 옵션입니다. 이러한 형식은 기존 ID 열의 기반이 되는 시퀀스를 변경합니다.

참고

Amazon Aurora DSQL은 ADD GENERATED AS IDENTITY를 사용할 때 명시적 CACHE 값을 요구합니다. 또한 자격 증명 열은 bigint 열에서만 지원됩니다.

ID 열을 사용할 때는 캐시 값을 신중하게 고려해야 합니다. 자세한 내용은 CREATE SEQUENCE 페이지의 중요 안내를 참조하세요.

워크로드 패턴을 기반으로 ID 열을 가장 잘 사용하는 방법에 대한 지침은 시퀀스 및 자격 증명 열 작업 섹션을 참조하세요.

SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN | DEFAULT }

이 양식은 열의 스토리지 모드를 설정합니다. 사용 가능한 스토리지 모드에 대한 자세한 내용은 CREATE TABLE 페이지의 스토리지 모드 섹션을 참조하세요.

ADD table_constraint_using_index

이 양식은 기존 고유 인덱스를 기반으로 테이블에 새 UNIQUE 제약 조건을 추가합니다. 인덱스의 모든 열이 제약 조건에 포함됩니다.

인덱스는 VALID 상태여야 합니다. 인덱스가 현재 빌드 중인 동안 해당 인덱스를 사용하여 고유한 제약 조건을 추가하는 것은 지원되지 않습니다.

제약 조건의 이름을 지정하면 제약 조건 이름과 일치하도록 인덱스의 이름이 변경됩니다. 그렇지 않으면 제약 조건의 이름이 인덱스와 동일하게 지정됩니다.

이 명령이 실행된 후 인덱스는 일반 CREATE UNIQUE INDEX ASYNC 명령으로 인덱스를 빌드한 것과 동일한 방식으로 제약 조건에 의해 "소유"됩니다. 특히, 제약 조건을 삭제하면 인덱스도 사라집니다.

DROP CONSTRAINT [ IF EXISTS ]

이 양식은 테이블에 지정된 제약 조건을 그 기본 인덱스와 함께 삭제합니다. IF EXISTS가 지정되고 제약 조건이 존재하지 않으면 오류가 발생하지 않습니다. 이 경우 대신 알림이 발행됩니다.

중요

현재 CREATE TABLE 표현식에서는 새 제약 조건 추가가 지원됩니다. ALTER TABLE ADD CONSTRAINT(DROP CONSTRAINT에 대한 미러링 지원)는 아직 사용할 수 없습니다. 이 출시 예정 기능에 대한 질문이 있는 경우 AWS Support에 문의하거나 DSQL Public Discord를 통해 직접 문의하세요.

OWNER TO

이 양식은 테이블 소유자를 지정된 사용자로 변경합니다.

RENAME

RENAME 양식은 테이블 이름, 테이블의 개별 열 이름 또는 테이블의 제약 조건 이름을 변경합니다. 기본 인덱스가 있는 제약 조건의 이름을 변경하면 인덱스의 이름도 변경됩니다. 저장된 데이터에 미치는 영향은 없습니다.

SET SCHEMA

이 양식은 테이블을 다른 스키마로 이동합니다. 연결된 인덱스, 제약 조건, 테이블 열이 소유한 시퀀스도 이동됩니다.

파라미터

IF EXISTS: 테이블이 없는 경우 오류가 발생하지 않습니다. 이 경우 알림이 발행됩니다.
이름: 변경할 기존 테이블 이름(선택적으로 스키마 한정)입니다. 테이블 이름 앞에 ONLY를 지정하면 해당 테이블만 변경됩니다. ONLY를 지정하지 않으면 테이블 및 모든 하위 테이블(있는 경우)이 변경됩니다. 선택적으로 테이블 이름 뒤에 *를 지정하여 하위 테이블이 포함되어 있음을 명시적으로 나타낼 수 있습니다.
column_name: 새 열 또는 기존 열의 이름입니다.
new_column_name: 기존 열의 새 이름입니다.
new_name: 테이블의 새 이름입니다.
data_type: 새 열의 데이터 형식입니다.
constraint_name: 새 제약 조건 또는 기존 제약 조건의 이름입니다.
CASCADE: 삭제된 제약 조건에 의존하는 객체(예: 열을 참조하는 뷰)를 자동으로 삭제한 다음 해당 객체에 의존하는 모든 객체를 삭제합니다.
RESTRICT: 종속 객체가 있는 경우 제약 조건 삭제를 거부합니다. 이는 기본 설정 동작입니다.
new_owner: 테이블의 새 소유자의 사용자 이름입니다.
new_schema: 테이블을 이동할 스키마의 이름입니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

CREATE TABLE

CREATE SEQUENCE