설명

CREATE LANGUAGE 명령은 PostgreSQL 내 함수를 만들거나, DO 명령을 사용할 때 지정하는 프로시져 언어를 만든다. - 새로 만드는 개념보다는 조합해서 그 언어를 사용할 수 있도록 등록한다 - 옮긴이.

CREATE LANGUAGE 명령의 내부 작업은 해당 언어로 작성된 함수 본문을 처리하는 핸들러 함수와 해당 언어 이름의 연결 작업이다. 언어 핸들러에 대한 자세한 설명은 55장에서 다룬다.

사용법은 두 가지 방식이 있는데, 첫번째 문법은 pg_pltemplate 시스템 카탈로그에 미리 정의된 언어를 등록할 때 사용한다. 그냥 언어 이름만 지정하면 된다. 두번째 문법은 pg_pltemplate 시스템 카탈로그에 정의되지 않은 언어를 등록할 때 쓰는 방법인데, 예전 방식이다.

이 명령에서 해당 언어 관련 여러 옵션을 함께 사용했다 하더라도, pg_pltemplate 카탈로그에 등록되어 있는 언어라면, 카탈로그 정보를 이용해서 언어를 등록한다. 이렇게 하는 이유는 오래된 버전의 덤프 파일을 새 버전에서 복원할 때 보다 안전하게 복원하기 위함이다.

통상, 새 언어 등록은 PostgreSQL 슈퍼유저 권한이 있어야 가능하다. 한편, pg_pltemplate 카탈로그에서 tmpldbacreate 칼럼값이 true인 언어에 대해서는 데이터베이스 소유주도 자신의 데이터베이스 내에서는 그 언어를 등록할 수 있다. 데이터베이스 소유주가 등록할 수 있는 언어는 신뢰할 수 있는 (tmpltrusted 칼럼값이 true인) 것이여야 한다. 물론 슈퍼유저는 pg_pltemplate 내용을 바꿀 수 있다. 해당 언어를 등록한 사용자가 그 언어의 소유주가 되며, 삭제, 이름 변경, 소유주 변경 작업을 할 수 있는 권한을 가진다.

CREATE OR REPLACE LANGUAGE 구문은 없으면 새 언어로 등록하고, 있으면, 그 정의를 바꾼다. 이때 이미 있어 정의가 변경 될 때는 pg_pltemplate 내에 정의된 정보로 바꾼다. 이때, 소유주, 접근 권한은 바뀌지 않는다. 기존에 있는 그 언어용 함수들은 여전히 유효한 것으로 간주한다. 추가로 REPLACE인 경우에도, 그 접근권한은 새로 등록할 때와 같다. 슈퍼유저이거나, 해당 언어의 소유주여야 한다. REPLACE 구문은 주로 해당 언어가 이미 있어도 이 작업을 오류로 처리하지 않게 하려고 사용한다. pg_pltemplate 안에 등록된 언어라면, 특별한 경우를 제외하고는 REPLACE 작업으로 변경되는 것은 없다. 물론 앞에서 설명한 대로 기존 언어가 pg_pltemplate에서 정의된 정보와 다른 경우는 등록 정보가 변경 된다.

매개 변수

TRUSTED 옵션과 지원 함수들은 그 언어가 pg_pltemplate 내에 미리 정의된 것이라면, 무시된다.

참고

프로시져 언어를 지울 때는 DROP LANGUAGE 명령을 사용한다.

현재 설치된 언어의 등록 정보는 pg_language 시스템 카탈로그에 보관된다(51.29절 참조). 또한 psql에서 \dL 명령어로 설치된 언어를 살펴볼 수도 있다.

해당 언어용 함수를 만들 때는 사용자가 그 언어에 대해 USAGE 권한이 있어야 한다. 신뢰할 수 있는 trusted 언어는 기본적으로 USAGE 권한이 PUBLIC(모든 사용자)에게 부여된다. 이 권한은 필요 하다면 도로 거둘 revoke 수 있다.

프로시져 언어는 각 데이터베이스 별로 설치해서 사용한다. 자주 쓰는 언어라면, template1 데이터베이스에 미리 설치해서, 새로운 데이터베이스를 만들 때 그 언어를 설치해야하는 번거로움을 줄일 수 있다.

pg_pltemplate 카탈로그에 미리 정의된 언어가 아닌 경우, 그 언어를 등록할 때 필요한 호출 핸들러 함수, 인라인 핸들러 함수(필요하다면), 유효성 검사 함수(필요하다면)는 먼저 그 데이터베이스에 있어야 한다. 반면, pg_pltemplate 카탈로그에 정의된 언어를 등록(설치)하는 경우는 그 관련 함수들을 따로 만들어(설치) 둘 필요는 없다. 해당 데이터베이스에 없으면 자동으로 만든다. (그 언어용 공유 라이브러리를 사용할 수 없는 경우, - 설치가 잘못된 경우 CREATE LANGUAGE 명령은 실패한다.)

PostgreSQL 7.3 이전 버전에서는 핸들러 함수의 반환 자료형이 language_handler가 아니라, opaque였다. 오래된 버전의 덤프 파일의 호환성을 위해서, 이 경우도 허용하기는 하지만, language_handler 형으로 바꾸라는 알림 메시지를 보여준다.

예제

표준 프로시져 언어인 경우는 다음과 같이 간단하게 만들 수 있음:

CREATE LANGUAGE plperl;

pg_pltemplate 카탈로그에 없는 언어인 경우는 다음과 같은 방식으로 등록한다:

CREATE FUNCTION plsample_call_handler() RETURNS language_handler
    AS '$libdir/plsample'
    LANGUAGE C;
CREATE LANGUAGE plsample
    HANDLER plsample_call_handler;

호환성

CREATE LANGUAGE 구문은 PostgreSQL 확장 기능이다.

관련 항목