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

A procedural language is installed in a database in five steps, which must be carried out by a database superuser. In most cases the required SQL commands should be packaged as the installation script of an <quote>extension</quote>, so that <command>CREATE EXTENSION</command> can be used to execute them. 手続き言語を次の5段階でデータベースにインストールすることができます。 この作業はデータベースのスーパーユーザで行う必要があります。 ほとんどの場合、必要なSQLコマンドは「拡張機能」のインストールスクリプトとしてパッケージ化されていますので、この作業を実行するのにCREATE EXTENSIONが利用できます。

1. The shared object for the language handler must be compiled and installed into an appropriate library directory. This works in the same way as building and installing modules with regular user-defined C functions does; see <xref linkend="dfunc"/>. Often, the language handler will depend on an external library that provides the actual programming language engine; if so, that must be installed as well. その言語ハンドラ用の共有オブジェクトがコンパイルされ、適切なライブラリディレクトリにインストールされている必要があります。 これは、通常のユーザ定義のC関数を使ってモジュールを構築しインストールする時と同じです。 38.10.5を参照してください。 実際のプログラミング言語エンジンを提供する外部ライブラリに、言語ハンドラが依存していることがよくあります。 この場合はそのライブラリもインストールしなければなりません。

2. The handler must be declared with the command ハンドラは下記のコマンドで宣言されなければなりません。

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

   The special return type of <type>language_handler</type> tells the database system that this function does not return one of the defined <acronym>SQL</acronym> data types and is not directly usable in <acronym>SQL</acronym> statements. language_handlerという特別な戻り値の型は、この関数が定義済みのSQLデータ型を返さず、SQL文では直接使用できないことをデータベースシステムに伝えます。

3. Optionally, the language handler can provide an <quote>inline</quote> handler function that executes anonymous code blocks (<link linkend="sql-do"><command>DO</command></link> commands) written in this language. If an inline handler function is provided by the language, declare it with a command like 省略可能ですが、言語ハンドラは、この言語で書かれた無名コードブロック(DOコマンド)を実行する「インライン」ハンドラ関数を提供することができます。 インラインハンドラ関数が言語により提供されるのであれば、以下のようなコマンドで宣言されます。

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

4. Optionally, the language handler can provide a <quote>validator</quote> function that checks a function definition for correctness without actually executing it. The validator function is called by <command>CREATE FUNCTION</command> if it exists. If a validator function is provided by the language, declare it with a command like 省略可能ですが、言語ハンドラは、実際に実行することなく関数定義の正確性を検査する「有効性検査」関数を提供することができます。 もし存在すれば、有効性検査関数はCREATE FUNCTIONで呼び出されます。 有効性検査関数が言語により提供されるのであれば、以下のようなコマンドで宣言されます。

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

5. Finally, the PL must be declared with the command 最終的に、PLは下記のコマンドで宣言されなければいけません。

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

   The optional key word <literal>TRUSTED</literal> specifies that the language does not grant access to data that the user would not otherwise have. Trusted languages are designed for ordinary database users (those without superuser privilege) and allows them to safely create functions and procedures. Since PL functions are executed inside the database server, the <literal>TRUSTED</literal> flag should only be given for languages that do not allow access to database server internals or the file system. The languages <application>PL/pgSQL</application>, <application>PL/Tcl</application>, and <application>PL/Perl</application> are considered trusted; the languages <application>PL/TclU</application>, <application>PL/PerlU</application>, and <application>PL/PythonU</application> are designed to provide unlimited functionality and should <emphasis>not</emphasis> be marked trusted. TRUSTEDというオプションキーワードは、ユーザがアクセス権を持たないデータに対して、その言語がアクセス権を持たないことを指定します。 TRUSTEDである言語は（スーパーユーザ権限を持たない）一般ユーザ用に設計されており、安全に関数やプロシージャを作成できます。 PL関数はデータベースサーバの内部で実行されますので、TRUSTEDフラグはデータベースサーバ内部やファイルシステムへのアクセスを持たない言語のみが使わなければなりません。 PL/pgSQLとPL/Tcl、PL/Perl言語はTRUSTEDと考えられています。 提供される機能が無制限に設計されているPL/TclU、PL/PerlU、PL/PythonU言語については、TRUSTEDを指定してはなりません。