설명

CREATE FOREIGN TABLE 명령은 현재 데이터베이스에 새 외부 테이블을 만든다. 이 명령을 실행하는 사용자가 해당 테이블의 소유주가 된다.

스키마 이름을 포함하면 (예, CREATE FOREIGN TABLE myschema.mytable ...) 해당 스키마 안에 만든다. 지정하지 않으면 현재 스키마 안에 만든다. 이 외부 테이블 이름은 해당 스키마 안에서 외부 테이블, 테이블, 시퀀스, 인덱스, 뷰, 구체화한 뷰 이름들 가운데 유일해야 한다.

CREATE FOREIGN TABLE 명령은 일반 테이블을 만드는 명령과 마찬가지로, 해당 테이블 이름과 동일한 복합 자료형을 내부적으로 함께 만든다. 이 때문에, 만들고자 하는 테이블의 이름과 동일한 자료형이 해당 스키마안에 이미 있어도 안된다.

PARTITION OF 옵션을 사용하면, 지정한 상위테이블에 속한, 지정한 파티션 범위의 하위 파티션 테이블을 만든다. (현재, 외부 테이블을 상위 파티션 테이블로는 만들 수 없다. - 옮긴이)

외부 테이블을 만들 때는, 해당 외부 서버에 대해 USAGE 권한이 있어야 하며, 칼럼 자료형으로 지정한 자료형에 대해서도 USAGE 권한이 있어야 한다.

매개 변수

참고

외부 테이블에 지정한 제약 조건(CHECK, NOT NULL 같은 것)은 그 테이블에 이미 있는 자료에 대해서는 관여하지 않는다. 또한 이 외부 테이블을 이용해서 자료를 조작하지 않고, 해당 서버에 있는 실 테이블을 직접 조작해도(insert, update)도 이것 제약 조건 검사를 할 방법이 없다. 그래서 대부분의 외부 자료 싸개는 이 부분에 대해서 무시한다. 즉, 해당 자료의 엄격한 유효성을 보장하려면, 해당 자료가 실제로 저장되는 그 테이블을 대상으로 제약 조건을 지정해야 한다.

어떤 외부 자료 싸개가 있는데, 그 핸들러 함수로만 해당 자료를 조작 가능하다면, 외부 테이블에서 지정하는 제약 조건들은 제 역할을 할 수 있다. 하지만, 해당 외부 자료 싸개 설명서에 이렇게 설명되어 있지 않다면, 지정한 제약 조건들이 잘 작동할 것이라고 가정해서는 안된다.

PostgreSQL에서는 외부 테이블에 있는 제약 조건이 엄격하게 작동하지 않음에도 불구하고, 이 정책은 쿼리 최적화 시각에서는 바르게 작동하는 것으로 간주한다. 제약 조건에 만족하지 않는 자료가 외부 테이블을 통해 볼 수 있다면, 그 테이블을 사용하는 쿼리 결과가 엉뚱해 질 수 있다. 이렇게 제약 조건 정의가 잘못 되어 결과가 바뀌는 문제는 사용자 책임이다.

예제

film_server 서버를 통해 접근하는 films 테이블을 만들 때:

CREATE FOREIGN TABLE films (
    code        char(5) NOT NULL,
    title       varchar(40) NOT NULL,
    did         integer NOT NULL,
    date_prod   date,
    kind        varchar(10),
    len         interval hour to minute
)
SERVER film_server;

범위 파티션인 measurement 테이블의 하위 테이블로 외부 테이블을 지정하는 경우:

CREATE FOREIGN TABLE measurement_y2016m07
    PARTITION OF measurement FOR VALUES FROM ('2016-07-01') TO ('2016-08-01')
    SERVER server_07;

호환성

CREATE FOREIGN TABLE 구문은 SQL 표준을 준수한다; 한편, CREATE TABLE 명령과 같이 NULL 제약조건 허용, 아무 칼럼도 없는 빈 외부 테이블 정의가 가능하다. 칼럼의 기본값을 정의하는 방법도 PostgreSQL 확장 기능이다. 테이블 상속 기능도 PostgreSQL 확장 기능이다.

관련 항목