<!--
$Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/xplang.sgml,v 1.5 2001/09/17 02:02:03 i-kaori Exp $
-->

 <chapter id="xplang">
  <!--<title id="xplang-title">Procedural Languages</title>-->
  <title id="xplang-title">手続き言語</title>
<indexterm><primary sortas="てつづきがたげんご">手続き型言語</primary></indexterm>
  <para>
   <!--<productname>Postgres</productname> allows users to add new
   programming languages to be available for writing functions and
   procedures.  These are called <firstterm>procedural
   languages</firstterm> (PL).  In the case of a function or trigger
   procedure written in a procedural language, the database server has
   no built-in knowledge about how to interpret the function's source
   text. Instead, the task is passed to a special handler that knows
   the details of the language.  The handler could either do all the
   work of parsing, syntax analysis, execution, etc. itself, or it
   could serve as <quote>glue</quote> between
   <productname>Postgres</productname> and an existing implementation
   of a programming language.  The handler itself is a special
   programming language function compiled into a shared object and
   loaded on demand.-->

   <productname>Postgres</productname>では、関数やプロシージャを書くために新たなプログラミング言語を追加することが可能です。これらは<firstterm>手続き言語</firstterm>（PL：Procedural Languages）と呼ばれています。手続き言語で関数やトリガか記述されていた場合、データベースサーバーはその関数のソースを理解する能力がありません。代わりに、そのタスクはその言語を解釈する特別なハンドラに引き渡します。そのハンドラは解析、構文分析、実行などすべてのことを行うこともできますし、<productname>Postgres</productname>と存在するプログラミング言語の実装との橋渡しともなり得ます。ハンドラそのものは特別なプログラミング言語関数で、共有オブジェクトにコンパイルされ、要求に応じて呼び出されます。<indexterm><primary>PostgreSQL</primary><secondary sortas="ぷろぐらみんぐげんごのついか">プログラミング言語の追加</secondary></indexterm><indexterm><primary sortas="ぷろぐらみんぐげんごのついか">プログラミング言語の追加</primary></indexterm>
  </para>

  <para>
   <!--Writing a handler for a new procedural language is outside the
   scope of this manual, although some information is provided in
   the CREATE LANGUAGE reference page.  Several procedural languages are
   available in the standard <productname>Postgres</productname> distribution.-->

   新しい手続き言語のハンドラを作成する方法はこのマニュアルで取り扱う範囲ではありませんが、CREATE LANGUAGEのページで少々記述されています。いくつかの手続き言語は<productname>Postgres</productname>の標準ディストリビューションに付随しています。
  </para>

  <sect1 id="xplang-install">
   <!--<title>Installing Procedural Languages</title>-->
   <title>手続き言語のインストール</title>
<indexterm><primary sortas="ぷろぐらみんぐげんごのついか">プログラミング言語の追加</primary><secondary sortas="てつづきげんごのいんすとーる">手続き言語のインストール</secondary></indexterm><indexterm><primary>PostgreSQL</primary><secondary sortas="てつづきげんごのいんすとーる">手続き言語のインストール</secondary></indexterm>
   <para>
    <!--A procedural language must be <quote>installed</quote> into each
    database where it is to be used.  But procedural languages installed in
    the template1 database are automatically available in all
    subsequently created databases. So the database administrator can
    decide which languages are available in which databases, and can make
    some languages available by default if he chooses.-->

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

   <para>
    <!--For the languages supplied with the standard distribution, the
    shell script <filename>createlang</filename> may be used instead
    of carrying out the details by hand.  For example, to install PL/pgSQL
    into the template1 database, use-->

    標準ディストリビューションで入っている言語に関しては、手動で実行するのではなく、シェルスクリプトで<filename>createlang</filename>を使用することができます。たとえば、PL/pgSQLをtemplate1のデータベースにインストールするには、次のようにしてください。
</para>

<programlisting>
createlang plpgsql template1
</programlisting>

<para>
    <!--The manual procedure described below is only recommended for
    installing custom languages that <filename>createlang</filename>
    does not know about.-->

    以下の内容は、<filename>createlang</filename>が認識できない言語に対してのみ使用することをお勧めします。
   </para>

   <procedure>
    <title>
     <!--Manual Procedural Language Installation-->
     手続き言語のインストール方法
    </title>

    <para>
     <!--A procedural language is installed in the database in three
     steps, which must be carried out by a database superuser.-->

     手続き言語は、データベースのスーパーユーザーによって、次の3段階でデータベースにインストールすることができます。
    </para>

    <step performance="required">
     <para>
      <!--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">.-->

      まず、その言語のハンドラ用の共有オブジェクトがコンパイルされ、インストールされている必要があります。これはCで書かれたユーザー定義関数を作成してインストールする場合と同じです。<xref linkend="dfunc">を参照してください。
     </para>
    </step>

    <step performance="required">
     <para>
      <!--The handler must be declared with the command-->
      ハンドラは下記のコマンドで定義されなければいけません。
</para>

<synopsis>
CREATE FUNCTION <replaceable>handler_function_name</replaceable> ()
    RETURNS OPAQUE AS
    '<replaceable>path-to-shared-object</replaceable>' LANGUAGE 'C';
</synopsis>

<para>
      <!--The special return type of <type>OPAQUE</type> tells
      the database 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.-->

      <type>OPAQUE</type>という特別な戻り値の型を持っている関数は、定義済みの<acronym>SQL</acronym>の型を返さず、<acronym>SQL</acronym>文では直接使用できないことをデータベースに伝えます。<indexterm><primary sortas="でーたがた">データ型</primary><secondary>OPAQUE</secondary></indexterm>
     </para>
    </step>

    <step performance="required">
     <para>
      <!--The PL must be declared with the command-->
      PLは下記のコマンドで宣言されなければいけません。
</para>

<synopsis>
CREATE <optional>TRUSTED</optional> <optional>PROCEDURAL</optional> LANGUAGE '<replaceable>language-name</replaceable>'
    HANDLER <replaceable>handler_function_name</replaceable>
    LANCOMPILER '<replaceable>description</replaceable>';
</synopsis>

<para>
      <!--The optional key word <token>TRUSTED</token> tells
      whether ordinary database users that have no superuser
      privileges should be allowed to use this language to create functions
      and trigger procedures. Since PL functions are
      executed inside the database backend, the <acronym>TRUSTED</acronym>
      flag should only be given for
      languages that do not allow access to database backends
      internals or the filesystem. The languages PL/pgSQL,
      PL/Tcl, and PL/Perl are known to be trusted; the language PL/TclU
      should <emphasis>not</emphasis> be marked trusted.-->

      <token>TRUSTED</token>というオプションキーワードは、スーパーユーザーの権利を持たない一般ユーザーがこの言語を使って関数やトリガプロシージャを作成できるかどうかを知らせます。PL関数はデータベースバックエンドの内部で実行されますので、<acronym>TRUSTED</acronym>はデータベースバックエンド内部やファイルシステムへのアクセスを持たない言語のみが使われるべきです。PL/pgSQL、PL/Tcl、PL/Perlでは使用できることが確認できています。PL/TclUでは<emphasis>使用しない</emphasis>でください。<indexterm><primary>TRUSTED</primary></indexterm><indexterm><primary sortas="ぷろぐらみんぐげんごのついか">プログラミング言語の追加</primary><secondary>TRUSTED</secondary></indexterm>
     </para>
    </step>
   </procedure>

   <para>
    <!--In a default <productname>Postgres</productname> installation, the
    handler for the PL/pgSQL language is built and installed into the
    <quote>library</quote> directory. If Tcl/Tk support is configured
    in, the handlers for PL/Tcl and PL/TclU are also built and installed in
    the same location.  Likewise, the PL/Perl handler is built and installed
    if Perl support is configured.  The <filename>createlang</filename>
    script automates the two CREATE steps described above.-->

    <productname>Postgres</productname>のデフォルトのインストールでは、PL/pgSQLのハンドラは<quote>library</quote>ディレクトリにビルドされ、インストールされています。Tcl/Tkサポートが設定された場合、PL/TclとPL/TclUのハンドラも同じ場所にビルドされ、インストールされます。同様にPerlサポートが設定された場合PL/Perlハンドラも同じ場所にビルドされインストールされます。<filename>createlang</filename>スクリプトは上記の2つのCREATE手順を自動に行います。
   </para>

   <procedure>
    <title><!--Example-->例</title>
<indexterm><primary sortas="ぷろぐらみんぐげんごのついか">プログラミング言語の追加</primary><secondary sortas="れい">例</secondary></indexterm>
    <step performance="required">
     <para>
      <!--The following command tells the database where to find the 
      shared object for the PL/pgSQL language's call handler function.-->

      以下のコマンドはデータベースにPL/pgSQL言語呼び出しハンドラ関数用の共有オブジェクトがどこにあるかを指定します。
</para>

<programlisting>
CREATE FUNCTION plpgsql_call_handler () RETURNS OPAQUE AS
    '/usr/local/pgsql/lib/plpgsql.so' LANGUAGE 'C';
</programlisting>
    </step>

    <step performance="Required">

<programlisting>
CREATE TRUSTED PROCEDURAL LANGUAGE 'plpgsql'
    HANDLER plpgsql_call_handler
    LANCOMPILER 'PL/pgSQL';
</programlisting>

<para>
      <!--then defines that the previously declared call handler function
      should be invoked for functions and trigger procedures where the
      language attribute is 'plpgsql'.-->

      そして、上記のコマンドのlanguage属性「plpgsql」で、前に宣言された呼び出しハンドラ関数が、関数とトリガプロシージャ用に呼び出されるべきであることを定義します。
     </para>
    </step>
   </procedure>

  </sect1>

</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode:sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"./reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
-->
