| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
CREATE [ PROCEDURAL ] LANGUAGE
name
CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE
name
HANDLER
call_handler
[ VALIDATOR
valfunction
]
CREATE LANGUAGE를 사용하여, PostgreSQL사용자는, PostgreSQL데이터베이스로 새로운 절차 언어를 등록할 수 있습니다. 이어서, 함수와 트리거 프로시저는 이 새로운 언어로 정의됩니다. 사용자는 새로운 언어를 등록하는 PostgreSQL슈퍼유저 권한을 갖아야 합니다.
CREATE LANGUAGE는, 언어명과 언어로 작성된 함수의 실행에 책임을 가지는 호출 핸들러를, 효율적으로 관련짓습니다. 언어 호출 핸들러에 대한 자세한 정보는,Chapter 36을 참조해 주세요.
CREATE LANGUAGE커멘드에는 2 종류의 형식이 있습니다. 1번째 형식은, 사용자는 필요한 언어의 이름만을 단지 지정하는 것입니다. 이 경우,PostgreSQL서버는 pg_pltemplate 시스템 카탈로그를 참조해, 올바른 파라미터를 결정합니다. 2번째의 형식에서는, 유저는 언어명과 언어의 함께 파라미터를 입력합니다. 2번째 형식에서,pg_pltemplate에 정의되어 있지 않은 언어를 생성할 수가 있습니다만, 이 접근법은 잘 쓰여지지 않고 있습니다.
지정된 언어명에 대응하는pg_pltemplate카탈로그의 항목을 서버가 찾아내면, 커멘드에 언어의 파라미터가 포함되어 있었다고 해도 카탈로그의 데이터를 사용합니다. 이 동작은 언어 지원 함수에 관한 오래된 정보를 포함한, 오래된 덤프 파일의 로딩을 단순화시킵니다.
TRUSTED는 언어의 호출 핸들러가 안전할 것을 지정합니다. 즉, 권한이 없는 사용자에게는 액세스 제한을 무시하는 기능을 일절 주지 않는 것입니다. 언어의 등록시에 언어의 키워드를 생략한 경우, PostgreSQL의 슈퍼유저 권한을 가진 사용자만이, 새로운 함수를 생성하는 이 언어를 사용할 수 있습니다.
이것은 노이즈 워드입니다.
새로운 절차 언어의 이름입니다. 언어명은 대문자/소문자의 구별이 없습니다. 이름은 데이터베이스 내의 언어 중에서 유일무이 한 것이어야 합니다.
후방 호환을 보관 유지하기 위해, 이 이름을 단일 인용부호로 둘러쌀 수도 있습니다.
call_handler 는, 절차 언어 함수를 실행하기 위해 호출되는, 사전에 등록해둔 함수의 이름 입니다. 절차 언어의 호출 핸들러는, 버전 1 호출 규약에 준거하여, C와 같은 컴파일된 언어로 작성되어야 합니다. 인수를 갖지 않고, language_handler형을 반환하는 함수로서PostgreSQL에 등록되어야 합니다. language_handler형은, 단지 함수를 호출하는 핸들러로서, 식별하는데 사용하는 플레이스홀더형입니다.
valfunction 는, 사전에 등록된 검증용 함수의 이름입니다. 새로운 함수가 해당 언어로 작성되었을 경우, 그 함수를 검증하기 위해서 호출 됩니다. 검증용 함수가 지정되어 있지 않은 경우, 새로운 함수는 작성시에 체크되지 않습니다. 검증용 함수는,oid형의 인수 1개취를 취해야 합니다. 이 인수는 작성되는 함수의 OID가 됩니다. 또, 통상void형을 반환합니다.
검증용 함수는, 통상, 함수가 문법적으로 옳은지를 검사하기 위해서 사용합니다만, 예를들어, 언어가 특정한 인수형을 처리할 수 없는 것과 같은 함수의 프로퍼티 검사도 가능합니다.
에러를 통지하려면 , 검증용 함수로ereport()함수를 사용해야 합니다.
함수의 반환값은 무시됩니다.
서버가 pg_pltemplate에 있는 지정된 언어 이름에 대한 항목을 갖는 경우, TRUSTED옵션과 지원 함수의 이름은 무시됩니다.
createlang 프로그램은, CREATE LANGUAGE 커멘드의 간단한 래퍼입니다. 이것을 사용해 쉘 커멘드 라인에서 절차언어를 쉽게 설치 할 수 있습니다.
절차 언어를 삭제하려면 , DROP LANGUAGE , 또는 droplang 을 사용해 주세요(후자를 권합니다).
시스템 카탈로그pg_language( Section 43.20를 참조하세요)에는, 현재 설치된 언어에 관한 정보가 기록되고 있습니다.
또한,createlang에는 설치된 언어를 열거하는 옵션이 있습니다.
절차언어로 함수를 생성하려면, 사용자는 언어에 대한 USAGE권한을 갖아야 합니다. 디폴트에서는, 신뢰된 언어의USAGE는PUBLIC에(즉 전원에게) 부여되고 있습니다. 이것은 필요에 따라서 없앨 수가 있습니다.
절차 언어는 각 데이터베이스에 국소적입니다. 그러나, 언어는 template1데이터베이스에 설치될 수 있습니다. 이 경우, 그 후에 작성된 모든 데이타베이스내에서 자동적으로 그 언어를 사용할 수 있게 됩니다.
서버가 pg_pltemplate내에 그 언어에 관한 항목을 가지고 있지 않은 경우에는, 호출 핸들러 함수와 검증 함수(만약 있으면)가 존재해야 합니다. 그러나, 그 항목이 있었다고 해도, 함수가 존재하고 있다고는 할 수 없습니다. 데이타베이스내에 존재하고 있지 않으면 자동적으로 정의됩니다. (언어를 실행하는 공유 라이브러리가 설치를 이용할 수 없는 경우, 이것에 의해CREATE LANGUAGE가 실패할 수 있습니다. )
PostgreSQL 7.3 보다 전의 버전에서는, 핸들러 함수가 반환하는 플레이스홀더 형을 language_handler보다는 opaque로 선언할 필요가 있습니다. 오래된 함수 파일의 로딩을 지원하려면, CREATE LANGUAGE가 opaque를 반환하는 것으로 선언된 함수를 받아들입니다. 그러나, 주의 메세지를 발행하여, 선언된 함수의 반환형을 language_handler로 변환합니다.