| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 36. 수속 언어 | Fast Forward | Next |
수속 언어는, 그것들이 사용되는 모든 데이터베이스에 "설치"되어 있어야 합니다. 그러나, template1데이터베이스에 설치 된 수속 언어는, CREATE DATABASE에 의해 template1의 항목에 복사되기 때문에, 그 후에 작성된 모든 데이터베이스에서 자동적으로 사용할 수 있습니다. 따라서, 데이터베이스 관리자는 어느 데이터베이스에 어떤 언어를 사용할지를 결정할 수 있고, 기본값으로 사용할 언어도 결정할 수 있습니다.
표준 배포물로 제공되는 언어에서, 그 언어를 현재의 데이터베이스에 설치하려면 CREATE LANGUAGE language_name 의 실행만이 필요합니다. 쉘 커멘드 라인으로부터 createlang 프로그램을 사용해 이것을 실시할 수도 있습니다. 예를 들어, PL/pgSQL를 template1데이터베이스에 설치하려면, 아래와 같이 실행해 주세요.
createlang plpgsql template1
아래와 같은 수동 작업은 CREATE LANGUAGE를 인식할 수 없는 독자적인 언어 설치에 대해서만 사용하는 것을 추천 합니다.
수속 언어의 수동 설치 방법
수속 언어를 다음의 4 단계로 데이터베이스에 설치 할 수 있습니다. 이 작업은 데이터베이스의 슈퍼 유저가 실시해야합니다. (CREATE LANGUAGE를 인식할 수 있는 언어에서는, 2번째와 3번째의 단계는 생략 할 수 있습니다. 필요시 자동적으로 행해지기 때문입니다. )
언어 핸들러의 공유 객체가 컴파일 되어, 적절한 라이브러리 디렉토리에 설치되어야 합니다. 이것은, 통상의 사용자 정의의 C함수를 작성해 설치 할 때 것과 같습니다. Section 33.9.6를 참조해 주세요. 실제 프로그램 언어 엔진을 제공하는 외부 라이브러리에, 언어 핸들러가 의존하는 일이 자주 있습니다. 이 경우는 그 라이브러리도 설치되어야 합니다.
핸들러는 아래와 같은 명령으로 선언어야 합니다.
CREATE FUNCTION
handler_function_name
()
RETURNS language_handler
AS '
path-to-shared-object
'
LANGUAGE C;
language_handler의 특별한 반환값의 형태는, 데이터베이스에 이 함수가 정의된 SQL데이터형을 돌려주지 않고, SQL문에서 직접 사용할 수 없다는 것을 전합니다.
생략 가능하지만, 언어 핸들러는 실제로 실행하는 일 없이, 함수 정의의 정확성을 검사하는 "유효성 검사"함수를 제공할 수 있습니다. 만약 존재하면, 유효성 검사 함수는 CREATE FUNCTION로 불려 갑니다. 유효성 검사 함수는 핸들러에 의해 제공되어 이하와 같은 명령으로 선언됩니다.
CREATE FUNCTION
validator_function_name
(oid)
RETURNS void
AS '
path-to-shared-object
'
LANGUAGE C;
PL는 아래와 같은 명령으로 선언되어야 합니다.
CREATE [TRUSTED] [PROCEDURAL] LANGUAGE language-name HANDLER handler_function_name [VALIDATOR validator_function_name ] ;
TRUSTED라고 하는 옵션 키워드는, 슈퍼 유저 권한을 가지지 않는 일반 사용자가 이 언어를 사용해 함수나 트리거 프로시저를 작성할 수 있을지 어떨지를 지정합니다. PL함수는 데이터 베이스 서버의 내부에서 실행되기 때문에, TRUSTED플래그는 데이터 베이스 서버 내부나 파일 시스템에 접속을 허용하지 않는 언어만이 사용해야 합니다. PL/pgSQL와 PL/Tcl, PL/Perl언어는 TRUSTED의 대상이라고 고려됩니다. 무제한하게 기능이 제공되도록 설계된 PL/TclU, PL/PerlU, PL/PythonU언어에 대해서는, TRUSTED를 지정해 되지 않습니다 .
Example 36-1에, 수동 설치 순서가 PL/pgSQL언어로 어떻게 동작하는지를 나타냅니다.
Example 36-1. PL/pgSQL의 수동 설치
이하의 명령은, 데이터 베이스 서버에 PL/pgSQL언어의 호출 핸들러 함수의 공유 객체의 존재하는 장소를 통지합니다.
CREATE FUNCTION plpgsql_call_handler() RETURNS language_handler AS
'$libdir/plpgsql' LANGUAGE C;
PL/pgSQL는 유효성 검사 함수를 가지고 있기 때문에, 이하와 같이 선언할 수도 있습니다.
CREATE FUNCTION plpgsql_validator(oid) RETURNS void AS
'$libdir/plpgsql' LANGUAGE C;
이하의 커멘드는,
CREATE TRUSTED PROCEDURAL LANGUAGE plpgsql
HANDLER plpgsql_call_handler
VALIDATOR plpgsql_validator;
직전에 선언된 함수를, 언어 속성이 plpgsql인 함수나 트리거 프로시저로 호출해야만 하는 것을 정의합니다.
기본값의 PostgreSQL설치는, PL/pgSQL언어용의 핸들러는 구축되어 "library"디렉토리에 설치됩니다. Tcl지원 첨부로 구축했을 경우, PL/Tcl와 PL/TclU의 핸들러도 구축되고 같은 장소에 설치됩니다. 같이 Perl 지원 첨부로 구축했을 경우는 PL/Perl와 PL/PerlU핸들러가, Python 지원 첨부로 구축했을 경우는 PL/PythonU핸들러가 구축되어 설치됩니다.