★PostgreSQLカンファレンス2024 12月6日開催/チケット販売中★
他のバージョンの文書 16 | 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

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

手続き言語は、それらが使用されるデータベースすべてにインストールされている必要があります。 しかし、template1データベースにインストールされた手続き言語は、template1内の項目はCREATE DATABASEによってコピーされますので、その後に作成されたすべてのデータベースで自動的に使用できます。 したがって、データベース管理者はどのデータベースにどの言語を使用するかを決定できますし、デフォルトで使用できる言語も決定できます。

標準配布物で提供される言語では、その言語を現在のデータベースにインストールするにはCREATE EXTENSION language_nameの実行のみが必要です。 下記の手作業は、拡張機能としてパッケージ化されていない言語をインストールする場合にのみ行うことを推奨します。

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

手続き言語を次の5段階でデータベースにインストールすることができます。 この作業はデータベースのスーパーユーザで行う必要があります。 ほとんどの場合、必要なSQLコマンドは拡張機能のインストールスクリプトとしてパッケージ化されていますので、この作業を実行するのにCREATE EXTENSIONが利用できます。

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

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

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

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

  3. 省略可能ですが、言語ハンドラは、この言語で書かれた無名コードブロック(DOコマンド)を実行するインラインハンドラ関数を提供することができます。 インラインハンドラ関数が言語により提供されるのであれば、以下のようなコマンドで宣言されます。

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

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

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

  5. 最終的に、PLは下記のコマンドで宣言されなければいけません。

    CREATE [TRUSTED] LANGUAGE language_name
        HANDLER handler_function_name
        [INLINE inline_function_name]
        [VALIDATOR validator_function_name] ;
    

    TRUSTEDというオプションキーワードは、ユーザがアクセス権を持たないデータに対して、その言語がアクセス権を持たないことを指定します。 TRUSTEDである言語は(スーパーユーザ権限を持たない)一般ユーザ用に設計されており、安全に関数やプロシージャを作成できます。 PL関数はデータベースサーバの内部で実行されますので、TRUSTEDフラグはデータベースサーバ内部やファイルシステムへのアクセスを持たない言語のみが使わなければなりません。 PL/pgSQLPL/TclPL/Perl言語はTRUSTEDと考えられています。 提供される機能が無制限に設計されているPL/TclUPL/PerlUPL/PythonU言語については、TRUSTEDを指定してはなりません

例 42.1に、手作業によるインストール手順がPL/Perl言語でどのように動作するかを示します。

例42.1 PL/Perlの手作業によるインストール

以下のコマンドは、データベースサーバにPL/Perl言語の呼び出しハンドラ関数用の共有ライブラリの存在場所を通知します。

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

PL/Perlはインラインハンドラ関数と有効性検査関数を有していますので、以下のようにも宣言します。

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;

直前に宣言された関数を、言語属性がplperlである関数やプロシージャ用に呼び出さなければならないことを定義します。


デフォルトのPostgreSQLインストレーションでは、PL/pgSQL言語用のハンドラは構築され、ライブラリディレクトリにインストールされます。 さらに、PL/pgSQL言語自体がデータベースすべてにインストールされます。 Tclのサポート付きで構築した場合、PL/TclPL/TclU用のハンドラも構築されライブラリディレクトリにインストールされますが、言語自体はデフォルトではどのデータベースにもインストールされません。 同様に、Perlサポート付きで構築した場合はPL/PerlPL/PerlUハンドラが、Pythonサポート付きで構築した場合はPL/PythonUハンドラが構築され、インストールされますが、言語自体はデフォルトではインストールされません。