Perlインタプリタが最初に初期化され、plperlまたはplperluでの使用のための準備がなされる前に実行されるperlコードを指定します。 このコードが実行される時にはSPI関数を利用できません。 このコードがエラーで失敗した場合、インタプリタの初期化は中断され、呼び出し元の問い合わせに伝わり、現在のトランザクションまたはサブトランザクションがアボートすることになります。

このPerlコードは単一文字列に制限されます。 長いコードをモジュール化し、on_init文字列でロードすることができます。 以下に例を示します。

plperl.on_init = 'require "plperlinit.pl"'
plperl.on_init = 'use lib "/my/app"; use MyApp::PgInit;'

plperl.on_initにより直接または間接的に読み込まれるモジュールはすべて、plperlにより使用可能になります。 これはセキュリティの危険性が発生する可能性があります。 どんなモジュールが読み込まれたかを確認するためには以下を使用します。

DO 'elog(WARNING, join ", ", sort keys %INC)' LANGUAGE plperl;

plperlライブラリがshared_preload_librariesに含まれている場合、初期化はpostmaster内部で起こります。 この場合、postmasterが不安定になる危険が出てくるため、一層の考慮が必要です。 この機能を使用できるようにした大きな理由は、plperl.on_initでロードされるPerlモジュールはpostmaster起動時点のみでロードされなければならないためです。 このため個々のデータベースセッション内にロードというオーバーヘッドをもたらすことなく即座に利用できるようになります。 しかし、データベースセッションで最初に使用されるPerlインタプリタ（PL/PerlUまたはPL/Perl関数を呼び出す最初のSQLロール用のPL/Perl）に対してのみ、このオーバーヘッドを防ぐことができる点に注意してください。 データベースセッション内でその後に作成されるPerlインタプリタはすべて、新たにplperl.on_initを実行する必要があります。 また、postmasterプロセス内で作成されるPerlインタプリタは子プロセスに伝播されませんので、Windowsにおける事前ロードには何かを節約することはまったくありません。

このパラメータはpostgresql.confファイルまたはサーバのコマンドラインでのみ設定可能です。

これらのパラメータはそれぞれ、plperlまたはplperlu用にPerlインタプリタを特化する時に実行されるPerlコードを指定します。 これは、データベースセッション内でPL/PerlまたはPL/PerlU関数が最初に実行される時、または、他の言語が呼び出されたため、あるいは新しいSQLロールでPL/Perl関数が呼び出されたために追加のインタプリタを呼び出す必要があった時に起こります。 この後にplperl.on_initによる初期化が行われます。 このコードを実行する時にはSPI関数は利用できません。 plperl.on_plperl_init内のPerlコードはインタプリタを「権限で制限した」後に実行されます。 このためPerlコードは信頼できる操作のみを行うことができます。

コードがエラーで失敗した場合、初期化は中断され、呼び出し元にエラーが伝わります。 その結果現在のトランザクションまたはサブトランザクションはアボートします。 Perl内ですでに行われた処理は取り消されません。 言語が再度使用される時、初期化は新しいインタプリタの中で再度試行されます。

スーパーユーザのみがこれらの設定を変更することができます。 これらの設定はセッション内で変更することができますが、このような変更は関数を実行するためにすでに使用されたPerlインタプリタには影響を与えません。

真の場合、その後のPL/Perl関数のコンパイルはstrictプラグマが有効になります。 このパラメータは現在のセッションでコンパイル済みの関数には影響しません。