| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
ALTER TABLE [ ONLY ]
name
[ * ]
action
[, ... ]
ALTER TABLE [ ONLY ]
name
[ * ]
RENAME [ COLUMN ]
column
TO
new_column
ALTER TABLE
name
RENAME TO
new_name
ALTER TABLE
name
SET SCHEMA
new_schema
where
action
is one of:
ADD [ COLUMN ]
column
type
[
column_constraint
[ ... ] ]
DROP [ COLUMN ]
column
[ RESTRICT | CASCADE ]
ALTER [ COLUMN ]
column
TYPE
type
[ USING
expression
]
ALTER [ COLUMN ]
column
SET DEFAULT
expression
ALTER [ COLUMN ]
column
DROP DEFAULT
ALTER [ COLUMN ]
column
{ SET | DROP } NOT NULL
ALTER [ COLUMN ]
column
SET STATISTICS
integer
ALTER [ COLUMN ]
column
SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
ADD
table_constraint
DROP CONSTRAINT
constraint_name
[ RESTRICT | CASCADE ]
DISABLE TRIGGER [
trigger_name
| ALL | USER ]
ENABLE TRIGGER [
trigger_name
| ALL | USER ]
CLUSTER ON
index_name
SET WITHOUT CLUSTER
SET WITHOUT OIDS
SET (
storage_parameter
=
value
[, ... ] )
RESET (
storage_parameter
[, ... ] )
INHERIT
parent_table
NO INHERIT
parent_table
OWNER TO
new_owner
SET TABLESPACE
new_tablespace
ALTER TABLE는 기존의 테이블의 정의를 변경합니다. 이 커멘드에는, 다음과 같은 부구문이 있습니다.
이 구문을 사용하면, CREATE TABLE 라고 같은 구문을 사용해 새로운 열을 테이블에 추가할 수 있습니다.
이 구문을 사용하면, 테이블에서 열을 삭제할 수 있습니다. 삭제하는 열을 포함하고 있는 인덱스 및 테이블 제약도 자동적으로 삭제됩니다. 또, 테이블 이외(예를 들면, 외부 키 제약 또는 뷰등)사항이 삭제하는 열에 의존하고 있는 경우,CASCADE를 붙일 필요가 있습니다.
이 구문을 사용하면, 테이블의 열의 형태를 변경할 수 있습니다. 그 열을 포함한 인덱스와 간단한 테이블 제약은, 원래 주어진 식을 재파싱하여, 새로운 형태를 사용하도록 자동적으로 변환됩니다. USING구는, 예전의 열값에서 새로운 값으로 계산하는 방법을 지정합니다. 이 구는 생략 가능합니다. 생략 되었을 경우, 디폴트의 변환은, 예전의 데이터형으로부터 새로운 데이터형에의 대입 캐스트와 같게 됩니다. 예전의 데이터형으로부터 새로운 데이터형에의 암묵 캐스트 혹은 대입 캐스트가 없는 경우,USING구를 지정하지 않으면 안됩니다.
이러한 구문을 사용하면, 열의 디폴트값을 설정 또는 삭제할 수 있습니다. 지정한 디폴트값은, 변경 후에 행해지는INSERT커멘드에만 적용됩니다. 테이블내의 기존의 행은 변경되지 않습니다. 디폴트값은 뷰에 대해서 설정하는 일도 가능합니다. 이 경우, 뷰의ON INSERT룰이 적용되기 전에, 뷰의INSERT문에 디폴트가 삽입됩니다.
이러한 구문은, 열의 값으로 해서 NULL값을 사용할 수 있을지 어떨지 설정합니다. SET NOT NULL는, 그 열에 NULL값이 1개도 없는 경우에게만 설정 가능합니다.
이 구문은, 커멘드 실행 후에 행해지는 ANALYZE 조작에 대해, 열단위에서의 통계 정보수집 대상을 설정합니다. 대상은 0에서 1000까지의 범위의 값에서 설정 가능합니다. 대상을―1으로 설정하면, 시스템의 디폴트 통계 정보 대상(default_statistics_target)이 사용됩니다. PostgreSQL의 쿼리 플래너에 의한 통계 정보의 사용에 관한 자세한 것은,Section 13.2을 참조해 주세요.
이 구문은, 열의 저장 모드를 설정합니다. 열을 인라인으로 보관 유지 또는 보충 테이블 로 유지하는지, 또, 데이터를 압축할 것인지, 아닌지를 제어할 수 있습니다. PLAIN는,integer와 같은 고정장의 값에 대해서 사용합니다. 인라인으로 보관 유지되어 압축되지 않습니다. MAIN는, 인 라인으로 보관 유지되고 있어, 압축 가능한 데이터에 사용합니다. EXTERNAL는 압축되어 있지 않은 외부 데이터에 사용합니다. EXTENDED는 압축된 외부 데이터에 사용합니다. EXTENDED는,PLAIN이외의 저장을 지원하는 대부분의 데이터형의 디폴트입니다. EXTERNAL를 사용하면,text및bytea열에 대한 서브스트링 조작의 처리 속도가 향상합니다만, 필요한 저장공간이 증가한다고 하는 단점이 있습니다. SET STORAGE자체는 테이블을 전혀 변경하지 않는 것에 주의해 주세요. 이후의 테이블의 갱신시에 수행하는 전략을 설정할 뿐입니다. 자세한 것은Section 52.2을 참조해 주세요.
이 구문을 사용하면, CREATE TABLE 와 같은 구문을 사용하여, 새로운 제약을 테이블에 추가할 수 있습니다.
이 구문을 사용하면, 테이블상의 지정한 제약을 삭제할 수 있습니다.
이 구문을 사용하면, 테이블에 속하는 트리거의 발행 여부에 대해 설정할 수가 있습니다. 사용 불가능한 트리거는 시스템상에 계속 존재합니다만 , 트리거 이벤트가 발생했다고 해도 실행되지 않습니다. 지연된 트리거의 경우, 사용가능 상태의 확인은, 트리거 함수를 실제로 실행하려고 할 때는 아니고, 이벤트의 발생시에 행해집니다. 이름, 또는 테이블상의 모든 트리거, 또는 사용자 트리거만을 지정하여(이 옵션은 외래키 제약을 실행하기 위해서 사용되는 트리거를 제외합니다.), 단일 트리거를 사용가능 또는 사용 불가능으로 만들 수 있습니다. 제약용의 트리거를 사용가능 또는 불가능으로 지정하려면 슈퍼 유저 권한이 필요합니다. 트리거가 실행되지 않은 경우, 당연히 제약의 무결성이 보증되지 않으므로, 주의해 실행하지 않으면 안됩니다.
이 구문은, 이후의 CLUSTER 조작용의 디폴트 인덱스를 선택합니다. 실제로 테이블의 재클러스터화는 실시하지 않습니다.
이 구문은, 테이블에서, 제일 마지막에 적용된 CLUSTER 인덱스 지정을 삭제합니다. 이후의 인덱스를 지정하지 않는 클러스터 조작에 영향을 미칩니다.
이 구문은, 테이블에서oid시스템열을 삭제합니다. 이미oid열이 존재하지 않아도 경고가 표시되지 않는 점을 제외하면,DROP COLUMN oid RESTRICT와 동등합니다.
OID를 삭제 후, 테이블에 OID를 복구하도록 지정하는ALTER TABLE의 부구문은 존재하지 않는 것에 주의해 주세요.
이 구문은, 테이블의 1개이상의 저장장치 매개변수를 변경합니다. 설정 가능한 매개변수에 관해서는 CREATE TABLE 을 참조해 주세요. 이 커멘드에 의해 테이블의 내용이 즉시 변경되지 않는 점에 주의해 주세요. 매개변수에 의존하여 필요한 효과를 얻기 위해서는, 테이블을 재작성할 필요가 있는 경우가 있습니다. 이 때문에, 테이블을 강제적으로 재작성하는 CLUSTER 또는ALTER TABLE의 구문의 어느쪽이든지 사용하세요.
Note: CREATE TABLE에서는OIDS를WITH ( storage_parameter )구문으로 지정할 수가 있습니다만,ALTER TABLE에서는OIDS를 저장장치 매개변수로서 취급하고 있지 않습니다.
이 구문은, 1개이상의 저장장치 매개변수를 디폴트치에 재설정합니다. SET로, 테이블 전체를 갱신하기 위해서 테이블을 재작성할 수도 있습니다.
이 구문은, 대상 테이블을 지정한 부모 테이블의 아이 테이블로서 추가합니다. 그 후에 행해지는 부모 테이블에의 쿼리에는 대상 테이블의 항목도 포함됩니다. 아이 테이블로서 추가하기 위해서는, 대상 테이블에는 부모 테이블과 같은 열이 모두 포함되지 않으면 안됩니다. (이 다른 열을 가질 수도 있습니다. ) 이러한 열의 데이터형은 일치하고 있을 필요가 있어, 부모 테이블로NOT NULL제약이 있는 경우는, 아이 테이블에서도와 같이NOT NULL제약을 가지지 않으면 안됩니다.
또, 부모 테이블의CHECK제약 모두에 대해서도, 일치하는 제약이 아이 테이블에 존재해야 합니다. 현시점에서는UNIQUE,PRIMARY KEY,FOREIGN KEY제약은 무시됩니다만, 장래 변경될지도 모릅니다.
이 구문은, 지정한 부모 테이블에서 아이 테이블군을 삭제합니다. 부모 테이블에의 쿼리에서는, 대상으로 한 테이블에서의 데이터가 포함되지 않게 됩니다.
이 형식을 사용하면, 테이블, 시퀀스, 또는 뷰의 소유자를, 지정한 사용자로 변경할 수 있습니다
이 구문을 사용하면, 테이블의 테이블스페이스를 지정한 테이블스페이스로 변경해, 테이블에 관련하는 데이터 파일을 새로운 테이블스페이스로 이동시킬 수 있습니다. 테이블에 인덱스가 있어도 이동되지 않습니다. 추가적인SET TABLESPACE커멘드를 실행해야 이동시킬 수 있습니다. CREATE TABLESPACE 도 참조해 주세요.
RENAME구문을 사용하면, 테이블(혹은, 인덱스, 시퀀스, 또는 뷰)의 이름이나, 테이블의 개개의 열명을 변경할 수 있습니다. 저장된 데이터에는 영향을 끼치지 않습니다.
이 구문을 사용해, 테이블을 다른 스키마로 이동할 수 있습니다. 관련된 인덱스나 제약, 테이블열에 의해 소유되는 시퀀스도 이와 같이 이동됩니다.
RENAME및SET SCHEMA이외의 모든 조작은, 결합해 복수의 변경 리스트에 정리하여, 동시에 처리할 수가 있습니다. 예를 들면, 복수의 열의 추가, 복수열의 형태의 변경을 단일의 커멘드로 실행할 수가 있습니다. 이것은 특히 거대한 테이블에서는 유용합니다. 변경을 필요로 하는 테이블 전체의 변경을 실행하는 동작이 단 1회로 끝나기 때문입니다.
ALTER TABLE커멘드를 사용하려면 , 변경하는 테이블을 소유해야 합니다. 테이블의 스키마를 변경하려면 , 새로운 스키마에 있어서의CREATE권한도 가지지 않으면 안됩니다. 부모 테이블에 새로운 아이 테이블을 추가하려면 , 부모 테이블도 이와 같이 소유하고 있을 필요가 있습니다. 또, 소유자를 변경하려면 , 새로운 소유 롤의 직접 혹은 간접적인 멤버가 아니면 안되어, 한편, 그 롤이 테이블의 스키마에 있어서의CREATE권한을 가지지 않으면 안됩니다 (이 제한에 의해 강제적으로 소유자의 변경이, 테이블의 삭제와 재작성을 실시해도 할 수 없는 것을 실시하지 않게 합니다. 다만, 슈퍼 유저는 모든 테이블의 소유자를 변경할 수가 있습니다).
변경 대상이 되는 기존의 테이블의 이름(검증을 거친 스키마)입니다. ONLY가 지정되었을 경우, 그 테이블만이 변경됩니다. ONLY가 지정되어 있지 않은 경우, 그 테이블 및(존재하는 경우는) 그 테이블을 상속하는 모든 테이블이 갱신됩니다. 테이블명에 *를 붙이면, 상속하는 테이블이 변경되는 것을 명시할 수 있습니다만, 현재의 버젼에서는, 이것은 디폴트로 행해집니다 (7.1보다 전의 릴리스에서는,ONLY가 디폴트였습니다. 디폴트의 설정은,sql_inheritance환경설정 변수으로 변경할 수 있습니다).
신규 또는 기존의 열의 이름입니다.
기존의 열의 새로운 이름입니다.
테이블의 새로운 이름입니다.
새로운 열의 데이터형, 혹은 기존의 열에 대한 새로운 데이터형입니다.
테이블의 새로운 테이블 제약입니다.
삭제하는 기존의 제약의 이름입니다.
삭제된 열이나 제약에 의존하고 있는 객체(예를 들면, 삭제된 열을 참조하고 있는 뷰)를, 자동적으로 삭제합니다.
의존하고 있는 객체가 있는 경우, 열 또는 제약의 삭제 요구를 거부합니다. 이것이 디폴트 동작입니다.
사용가능 또는 사용불가능한 단일 트리거의 이름입니다.
테이블에 속하는 모든 트리거를 사용가능 또는 사용불가능으로 지정 합니다. (외래키 제약용의 트리거가 포함되는 경우, 슈퍼 유저 권한이 필요합니다. )
외래키 제약용의 트리거 이외의 테이블에 속하는 트리거 모든 것을 사용가능 또는 사용불가능으로 지정 합니다.
지정한 인덱스명으로 테이블을 클러스터화하도록 표시를 합니다.
테이블의 저장 매개변수의 이름입니다.
테이블의 저장 매개변수의 새로운 값입니다. 매개변수에 의해 이것은 숫자 또는 문자가 될 수도 있습니다.
이 테이블에 연관짓는 또는 연관을 없애는 부모 테이블입니다.
테이블의 새로운 소유자의 사용자명입니다.
테이블이 이동될 테이블스페이스의 이름입니다.
테이블이 이동될 스키마의 이름입니다.
COLUMN키워드는 노이즈이며, 생략 가능합니다.
ADD COLUMN에 의해 열을 추가했을 때, 테이블내의 기존행에 추가된 열은, 모두 디폴트값(DEFAULT가 지정되어 있지 않은 경우는 NULL)으로 초기화됩니다.
NULL이 아닌 디폴트값을 가지는 열을 추가하거나 또는 기존의 열의 형태를 변경하려면 , 테이블 전체를 재작성 할 필요가 있습니다. 테이블이 거대한 경우, 이러한 처리에 상당한 시간이 걸릴 가능성이 있습니다. 또, 일시적으로 2배의 디스크 용량이 필요하게 됩니다.
CHECK혹은NOT NULL제약을 추가할 때는, 기존의 행이 제약에 따르는지 검증하기 위해서 테이블을 스캐닝하는 것이 필요합니다.
단일의ALTER TABLE내에서 복수의 변경을 지정할 수 있는 옵션을 제공하는 주된 이유는, 복수의 테이블 스캔이나, 재작성을 테이블에 1회의 처리만으로 정리할 수 있도록 하는 것입니다.
DROP COLUMN구문은, 열을 물리적으로는 삭제하지 않고, SQL를 조작에 있어서 불가시화 합니다. 이 커멘드를 실행한 후, 테이블에 삽입 또는 갱신을 하면, 삭제한 열에는 NULL이 저장됩니다. 따라서, 열의 삭제는 단시간에 실시할 수 있습니다. 그러나, 삭제된 열이 차지하고 있던 스페이스가 아직 회수되어 있지 않기 때문에, 테이블의 디스크상의 사이즈는 곧바로는 작아지지 않습니다. 이 스페이스는, 그 후 기존의 행이 갱신되는 타이밍에 회수됩니다.
ALTER TYPE가 테이블 전체의 재작성을 필요로 하는 것이 이점이 되는 경우도 있습니다. 재작성 처리에 의해, 테이블 내에 불필요해진 영역이 제거되기 때문입니다. 예를 들면, 삭제한 열이 사용하고 있던 스페이스를 즉석에서 회수하고 싶은 경우, 가장 고속의 커멘드는 다음과 같이 됩니다.
ALTER TABLE table ALTER COLUMN anycol TYPE anytype;
여기서anycol에는 기존의 테이블열을,anytype에는 기존의 열과 동일한 형태를 지정합니다. 이 커멘드를 실행하면, 외형에는 테이블에 의미가 있는 변경은 없습니다만, 불필요해진 데이터를 제거하도록, 재작성을 강요합니다.
ALTER TYPE의USING옵션에서는, 그 행의 변환 이전의 값을 포함해 모든 식을 지정할 수 있습니다. 즉, 변환 대상의 열과 같게, 그 외의 열도 참조할 수가 있습니다. 그 때문에, 일반적인 변환을ALTER TYPE구문으로 실시할 수가 있습니다. 이 유연성 때문에,USING식은 열의 디폴트 값에는(만일 존재하고 있어도) 적용되지 않습니다. 결과가 정수식이 되지 않을 가능성이 있기 때문입니다(디폴트값은 정수식이 아니면 안됩니다). 따라서, 변환 이전의 형태에서 새로운 형태에의 암묵 캐스트나 대입 캐스트가 존재하지 않는 경우,USING가 지정되고 있어도,ALTER TYPE가 디폴트값의 변환에 실패할 가능성이 있습니다. 이 경우는,DROP DEFAULT로 디폴트 값을 삭제해,ALTER TYPE를 실행한 다음에,SET DEFAULT를 사용해 재차 적절한 디폴트값을 지정해 주세요. 변경 대상의 열을 가지는 인덱스와 제약도 같은 배려가 필요합니다.
그 테이블을 상속하는 테이블이 있는 경우, 자손 테이블에 같은 처리를 실행하지 않으면, 부모 테이블에 대한 열의 추가, 열의 이름, 형태의 변경을 실행할 수 없습니다. 즉,ALTER TABLE ONLY커멘드는 받아들일 수 없습니다. 이 제한에 의해, 자손 테이블의 열이 항상 부모 테이블과 일치하고 있는 것이 보증됩니다.
재귀적인DROP COLUMN조작에서는, 자손 테이블이 다른 부모테이블에서 그 열을 상속하고 있지 않고, 한편, 독립적인 열정의를 가지고 있지 않은 경우만, 그 자손 테이블의 열을 삭제합니다. 재귀적이지 않은DROP COLUMN(예를 들면,ALTER TABLE ONLY ... DROP COLUMN등) 조작에서는, 상속된 열은 삭제되지 않습니다. 삭제하는 대신에, 그 열은 상속되지 않고 독립해 정의되고 있다고 하는 표시를 합니다.
TRIGGER,CLUSTER,OWNER및TABLESPACE는 자손 테이블에 재귀적으로 전해지지 않습니다. 즉, 항상ONLY가 지정되어 있는 것과 같게 동작합니다. 제약의 추가는,CHECK제약에 관하여 재귀적으로 전해집니다.
시스템 카탈로그 테이블에 대해서는, 어떠한 부분의 변경도 허가되고 있지 않습니다.
유효한 매개변수의 자세한 설명은 CREATE TABLE 을 참조해 주세요. Chapter 5에, 상속에 관한 한층 더 자세한 정보가 있습니다.
varchar형의 열을 테이블에 추가합니다.
ALTER TABLE distributors ADD COLUMN address varchar(30);
테이블에서 열을 삭제합니다.
ALTER TABLE distributors DROP COLUMN address RESTRICT;
1개의 조작으로 기존의 2개의 열의 형태를 변경합니다.
ALTER TABLE distributors
ALTER COLUMN address TYPE varchar(80),
ALTER COLUMN name TYPE varchar(100);
USING구를 사용해, Unix 타임스탬프를 가지는 integer형의 열을timestamp with time zone로 변경합니다.
ALTER TABLE foo
ALTER COLUMN foo_timestamp TYPE timestamp with time zone
USING
timestamp with time zone 'epoch' + foo_timestamp * interval '1 second';
위와 같습니다. 다만, 그 열은, 자동적으로 새로운 데이터형에 캐스트 되지 않는 디폴트식을 가집니다.
ALTER TABLE foo
ALTER COLUMN foo_timestamp DROP DEFAULT,
ALTER COLUMN foo_timestamp TYPE timestamp with time zone
USING
timestamp with time zone 'epoch' + foo_timestamp * interval '1 second',
ALTER COLUMN foo_timestamp SET DEFAULT now();
기존의 열의 이름을 변경합니다.
ALTER TABLE distributors RENAME COLUMN address TO city;
기존의 테이블의 이름을 변경합니다.
ALTER TABLE distributors RENAME TO suppliers;
열에 비NULL 제약을 부여합니다.
ALTER TABLE distributors ALTER COLUMN street SET NOT NULL;
열에서 비NULL 제약을 삭제합니다.
ALTER TABLE distributors ALTER COLUMN street DROP NOT NULL;
테이블에 CHECK 제약을 부여합니다.
ALTER TABLE distributors ADD CONSTRAINT zipchk CHECK (char_length(zipcode) = 5);
테이블과 그 아이 테이블에서 CHECK 제약을 삭제합니다.
ALTER TABLE distributors DROP CONSTRAINT zipchk;
테이블에 외래키 제약을 부여합니다.
ALTER TABLE distributors ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES addresses (address) MATCH FULL;
테이블에(복수열의) 일의성 제약을 부여합니다.
ALTER TABLE distributors ADD CONSTRAINT dist_id_zipcode_key UNIQUE (dist_id, zipcode);
자동적으로 명명되는 주키 제약을 테이블에 부여합니다. 1개의 테이블은 1개의 주키만 가질 수 있다는 것에 주의해 주세요.
ALTER TABLE distributors ADD PRIMARY KEY (dist_id);
테이블을 다른 테이블스페이스로 이동합니다.
ALTER TABLE distributors SET TABLESPACE fasttablespace;
테이블을 다른 스키마로 이동합니다.
ALTER TABLE myschema.distributors SET SCHEMA yourschema;