37.1. 手続き言語のインストール

手続き言語の手作業によるインストール方法

手続き言語を次の4段階でデータベースにインストールすることができます。 この作業はデータベースのスーパーユーザで行う必要があります。 （CREATE LANGUAGEが認知できる言語では、2番目と3番目の処理は省略できます。必要ならば自動的に行われるからです。）

1. その言語ハンドラ用の共有オブジェクトがコンパイルされ、適切なライブラリディレクトリにインストールされている必要があります。 これは、通常のユーザ定義のC関数を作成してインストールする時と同じです。 項34.9.6を参照してください。 実際のプログラミング言語エンジンを提供する外部ライブラリに、言語ハンドラが依存していることがよくあります。 この場合はそのライブラリもインストールしなければなりません。

2. ハンドラは下記のコマンドで宣言されなければなりません。

   CREATE FUNCTION handler_function_name()
       RETURNS language_handler
       AS 'path-to-shared-object'
       LANGUAGE C;

   language_handlerという特別な戻り値の型は、この関数が定義済みのSQLデータ型を返さず、SQL文では直接使用できないことをデータベースに伝えます。

3. 省略可能ですが、言語ハンドラは、実際に実行することなく関数定義の正確性を検査する"有効性検査"関数を提供することができます。 もし存在すれば、有効性検査関数はCREATE FUNCTIONで呼び出されます。 有効性検査関数はハンドラによって提供され、以下のようなコマンドで宣言されます。

   CREATE FUNCTION validator_function_name(oid)
       RETURNS void
       AS 'path-to-shared-object'
       LANGUAGE C;

4. 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を指定してはなりません。