Ручная установка процедурного языка

Процедурный язык устанавливается в базу данных в пять шагов, которые должны быть выполнены суперпользователем базы данных. В большинстве случаев необходимые SQL-команды должны быть упакованы в скрипт установки «расширения», чтобы CREATE EXTENSION можно было использовать для их выполнения.

1. Разделяемый объект для обработчика языка должен быть скомпилирован и установлен в соответствующий каталог библиотек. Это работает так же, как сборка и установка модулей с обычными пользовательскими функциями C; см. Раздел 5.1.10.5. Часто обработчик языка зависит от внешней библиотеки, которая предоставляет сам движок языка программирования; если это так, она также должна быть установлена.

2. Обработчик должен быть объявлен командой

   CREATE FUNCTION имя_функции_обработчика()
       RETURNS language_handler
       AS 'путь_к_разделяемому_объекту'
       LANGUAGE C;
   

   Специальный возвращаемый тип language_handler сообщает системе баз данных, что эта функция не возвращает один из определённых типов данных SQL и не может использоваться напрямую в операторах SQL.

3. Опционально, обработчик языка может предоставлять «встроенную» функцию обработчика, которая выполняет анонимные блоки кода (команды DO), написанные на этом языке. Если встроенная функция обработчика предоставляется языком, объявите её командой наподобие:

   CREATE FUNCTION имя_встроенной_функции(internal)
       RETURNS void
       AS 'путь_к_разделяемому_объекту'
       LANGUAGE C;
   

4. Опционально, обработчик языка может предоставлять «валидатор» — функцию, которая проверяет определение функции на корректность без фактического выполнения. Функция-валидатор вызывается командой CREATE FUNCTION, если она существует. Если функция-валидатор предоставляется языком, объявите её командой наподобие:

   CREATE FUNCTION имя_функции_валидатора(oid)
       RETURNS void
       AS 'путь_к_разделяемому_объекту'
       LANGUAGE C STRICT;
   

5. Наконец, процедурный язык должен быть объявлен командой

   CREATE [TRUSTED] LANGUAGE имя_языка
       HANDLER имя_функции_обработчика
       [INLINE имя_встроенной_функции]
       [VALIDATOR имя_функции_валидатора] ;
   

   Опциональное ключевое слово TRUSTED указывает, что язык не предоставляет доступ к данным, к которым пользователь не имеет доступа иным способом. Доверенные языки предназначены для обычных пользователей базы данных (не суперпользователей) и позволяют им безопасно создавать функции и процедуры. Поскольку функции процедурных языков выполняются внутри сервера базы данных, флаг TRUSTED должен быть указан только для языков, которые не позволяют получать доступ к внутренним данным сервера или файловой системе. Языки PL/pgSQL, PL/Tcl и PL/Perl считаются доверенными; языки PL/TclU, PL/PerlU и PL/PythonU предназначены для предоставления неограниченной функциональности и не должны быть помечены как доверенные.

Пример 5.5.1 показывает, как ручная процедура установки будет работать с языком PL/Perl.

CREATE FUNCTION plperl_call_handler() RETURNS language_handler AS
    '$libdir/plperl' LANGUAGE C;

CREATE FUNCTION plperl_inline_handler(internal) RETURNS void AS
    '$libdir/plperl' LANGUAGE C STRICT;

CREATE FUNCTION plperl_validator(oid) RETURNS void AS
    '$libdir/plperl' LANGUAGE C STRICT;

CREATE TRUSTED LANGUAGE plperl
    HANDLER plperl_call_handler
    INLINE plperl_inline_handler
    VALIDATOR plperl_validator;

В установке Digital Q.DataBase по умолчанию обработчик для языка PL/pgSQL собирается и устанавливается в «библиотечный» каталог; более того, сам язык PL/pgSQL установлен во всех базах данных. Если поддержка Tcl настроена, обработчики для PL/Tcl и PL/TclU собираются и устанавливаются в библиотечный каталог, но сам язык по умолчанию не устанавливается ни в одну базу данных. Аналогично, обработчики PL/Perl и PL/PerlU собираются и устанавливаются, если настроена поддержка Perl, и обработчик PL/PythonU устанавливается, если настроена поддержка Python, но эти языки по умолчанию не устанавливаются.