CREATE LANGUAGE — 새 프로시져 언어 정의
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE이름
HANDLER호출핸들러
[ INLINE인라인핸들러
] [ VALIDATOR유효성검사함수
] CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE이름
CREATE LANGUAGE
명령은
PostgreSQL 내 함수를 만들거나,
DO
명령을 사용할 때 지정하는 프로시져
언어를 만든다. - 새로 만드는 개념보다는 조합해서 그 언어를 사용할 수
있도록 등록한다 - 옮긴이.
CREATE LANGUAGE
명령의 내부 작업은
해당 언어로 작성된 함수 본문을 처리하는 핸들러 함수와
해당 언어 이름의 연결 작업이다. 언어 핸들러에 대한
자세한 설명은 55장에서 다룬다.
CREATE OR REPLACE LANGUAGE
명령은
새로운 언어를 만들거나, 그 언어 설정을 바꾼다.
해당 언어가 이미 있다면, 명령어에 지정한 옵션으로 매개 변수를
바꾼다. 하지만, 언어의 소유주나 접근 권한은 바뀌지 않는다.
또, 해당 언어와 관련된 이미 있는 함수들도 여전히 유요한 상태를
유지한다.
새 언어 등록 또는 매개 변수 변경은 PostgreSQL 슈퍼유저 권한이 있어야 가능하다. 한편, 해당 언어의 소유주를 일반 사용자로 지정하면, 그 사용자는 그 언어를 삭제, 권한 변경, 이름 변경, 새 소유주 지정을 할 수 있다. (단, C 함수들은 일반 사용자에게 소유권을 부여하는 것은 위험하다. 이렇게 되면 그 일반 사용자 슈퍼유저 권한을 획득하는 길이 열리게 된다.)
핸들러 함수를 지정하지 않는 CREATE LANGUAGE
구문은
더 이상 사용할 수 없다. 오래된 버전의 덤프 파일 호환성 유지 때문에,
있을 뿐, 이것은 CREATE EXTENSION
으로
재해석한다. 이런 구문은 그 언어와 이름이 같은 확장 모듈을 설치로
간주한다. 그 확장 모듈이 설치되면, 필요한 함수들과 언어가 함께
설치된다.
TRUSTED
TRUSTED
옵션을 사용하면,
그 사용자가 사용하면 안될 자료에 접근을 금지한다.
이 키워드가 빠지면,
PostgreSQL 슈퍼유저만
이 언어를 이용해서 새 함수를 만들 수 있다.
PROCEDURAL
호환성을 위해 있는 키워드. 무시함.
이름
새 프로시져 언어 이름. 이 이름은 해당 데이터베이스 내에 유일해야 한다.
하위 호환성을 위해, 이 이름은 작은 따옴표로 둘러 쌀 수도 있다.
HANDLER
호출핸들러
호출핸들러
는
이 언어를 사용하는 함수에서 그 함수 본문을 처리할 함수 이름이다.
이 호출 핸들러 함수는
C 언어로 작성되며, PostgreSQL
C 언어 함수 버전 1 규칙으로 만들어야 하며,
입력 인자는 없고, 반환 자료형은 language_handler
형이다. 이 자료형은
이 함수가 호출 핸들러로 사용됨을 식별하기 위한 자료형이다.
INLINE
인라인핸들러
인라인핸들러
는
DO 명령에서 사용하는 코드 블럭을 처리할 때
사용하는 함수 이름이다.
인라인핸들러
함수를
지정하지 않으면, DO 명령에서 해당 언어를
사용할 수 없게 된다.
이 함수의 입력 인자는 internal
형 하나를 사용하며,
반환 값은 void
다. 핸들러의 반환값은 무시된다.
VALIDATOR
유효성검사함수
유효성검사함수
는
한 함수가 만들어질 때, 함수 본문의 구문 검사를 하는 함수 이름이다.
이 함수를 지정하지 않으면, 새 함수를 만들 때, 유효성 검사를
하지 않는다.
이 유효성 검사 함수의 입력 인자는 만들어지는 함수의
OID를 넘겨 받는 oid
형 인자 하나이고,
반환은 void
다.
이 유효성 검사 함수는 함수 본문 내 문법 검사를 주로 담당하지만,
그 외 함수 여러 속성들도 함께 검사하기도 한다.
예를 들어, 해당 언어가 처리할 수 없는 자료형이 함수의 입력 인자로
사용되는 것을 막는데도 사용된다. 유효성 검사의
오류 처리는 이 함수 내 ereport()
함수
호출로 한다. 이 함수 반환 값은 무시된다.
프로시져 언어를 지울 때는 DROP LANGUAGE 명령을 사용한다.
현재 설치된 언어의 등록 정보는
pg_language
시스템 카탈로그에 보관된다(51.29절 참조).
또한 psql에서
\dL
명령어로 설치된 언어를 살펴볼 수도 있다.
해당 언어용 함수를 만들 때는 사용자가 그 언어에 대해
USAGE
권한이 있어야 한다.
신뢰할 수 있는 trusted 언어는 기본적으로
USAGE
권한이 PUBLIC
(모든 사용자)에게
부여된다.
이 권한은 필요 하다면 도로 거둘 revoke 수 있다.
프로시져 언어는 각 데이터베이스 별로 설치해서 사용한다.
자주 쓰는 언어라면, template1
데이터베이스에
미리 설치해서, 새로운 데이터베이스를 만들 때 그 언어를
설치해야하는 번거로움을 줄일 수 있다.
새 프로시져 언어를 만드는 단순한 절차는 다음과 같다:
CREATE FUNCTION plsample_call_handler() RETURNS language_handler AS '$libdir/plsample' LANGUAGE C; CREATE LANGUAGE plsample HANDLER plsample_call_handler;
일반적으로 위 작업 절차를 확장 모듈 생성 스크립트로 만들고, 다음과 같이 확장 모듈 설치 작업으로 진행한다:
CREATE EXTENSION plsample;
CREATE LANGUAGE
구문은
PostgreSQL 확장 기능이다.