load.sgml
上传用户:blenddy
上传日期:2007-01-07
资源大小:6495k
文件大小:5k
源码类别:

数据库系统

开发平台:

Unix_Linux

  1. <refentry id="SQL-LOAD">
  2.  <refmeta>
  3.   <refentrytitle>
  4.    LOAD
  5.   </refentrytitle>
  6.   <refmiscinfo>SQL - Language Statements</refmiscinfo>
  7.  </refmeta>
  8.  <refnamediv>
  9.   <refname>
  10.    LOAD
  11.   </refname>
  12.   <refpurpose>
  13.    Dynamically loads an object file
  14.   </refpurpose>
  15.  </refnamediv>
  16.  <refsynopsisdiv>
  17.   <refsynopsisdivinfo>
  18.    <date>1998-09-24</date>
  19.   </refsynopsisdivinfo>
  20.   <synopsis>
  21. LOAD '<replaceable class="PARAMETER">filename</replaceable>'
  22.   </synopsis>
  23.   <refsect2 id="R2-SQL-LOAD-1">
  24.    <refsect2info>
  25.     <date>1998-09-01</date>
  26.    </refsect2info>
  27.    <title>
  28.     Inputs
  29.    </title>
  30.    <para>
  31.     <variablelist>
  32.      <varlistentry>
  33.       <term><replaceable class="PARAMETER">filename</replaceable></term>
  34.       <listitem>
  35.        <para>
  36. Object file for dynamic loading.
  37.        </para>
  38.       </listitem>
  39.      </varlistentry>
  40.     </variablelist>
  41.    </para>
  42.   </refsect2>
  43.   <refsect2 id="R2-SQL-LOAD-2">
  44.    <refsect2info>
  45.     <date>1998-09-24</date>
  46.    </refsect2info>
  47.    <title>
  48.     Outputs
  49.    </title>
  50.    <para>
  51.     <variablelist>
  52.      <varlistentry>
  53.       <term><computeroutput>
  54. LOAD
  55.        </computeroutput></term>
  56.       <listitem>
  57.        <para>
  58. Message returned on successful completion.
  59.        </para>
  60.       </listitem>
  61.      </varlistentry>
  62.      <varlistentry>
  63.       <term><computeroutput>
  64. ERROR:  LOAD: could not open file '<replaceable class="PARAMETER">filename</replaceable>'
  65.        </computeroutput></term>
  66.       <listitem>
  67.        <para>
  68. Message returned if the specified file is not found. The file must be visible
  69. <emphasis>to the <productname>Postgres</productname> backend</emphasis>,
  70. with the appropriate full path name specified, to avoid this message.
  71.        </para>
  72.       </listitem>
  73.      </varlistentry>
  74.     </variablelist>
  75.    </para>
  76.   </refsect2>
  77.  </refsynopsisdiv>
  78.  <refsect1 id="R1-SQL-LOAD-1">
  79.   <refsect1info>
  80.    <date>1998-09-24</date>
  81.   </refsect1info>
  82.   <title>
  83.    Description
  84.   </title>
  85.   <para>
  86.    Loads an object (or ".o") file into the 
  87.    <productname>Postgres</productname> backend address space.  Once a
  88.    file is loaded, all functions in that file can be accessed.  This
  89.    function is used in support of user-defined types and functions.
  90.   </para>
  91.   <para>
  92.    If a file is not loaded using
  93.    <command>LOAD</command>, 
  94.    the file will be loaded automatically the first time the
  95.    function is called by <productname>Postgres</productname>.
  96.    <command>LOAD</command>
  97.    can also be used to reload an object file if it has been edited and
  98.    recompiled.  Only objects created from C language files are supported
  99.    at this time.
  100.   </para>
  101.   <refsect2 id="R2-SQL-LOAD-3">
  102.    <refsect2info>
  103.     <date>1998-09-24</date>
  104.    </refsect2info>
  105.    <title>
  106.     Notes
  107.    </title>
  108.    <para>
  109.     Functions in loaded object files should not call functions in other
  110.     object files loaded through the
  111.     <command>LOAD</command>
  112.     command. For example, all functions in file <literal>A</literal> should
  113.     call each other, functions in the standard or math libraries, or in
  114.     Postgres itself.  They should not call functions defined in a different
  115.     loaded file <literal>B</literal>.
  116.     This is because if <literal>B</literal> is reloaded, the Postgres loader is
  117.     not able to relocate the calls from the functions in
  118.     <literal>A</literal> into
  119.     the new address space of <literal>B</literal>.
  120.     If <literal>B</literal> is not reloaded, however, there will
  121.     not be a problem.
  122.    </para>
  123.    <para>
  124.     Object files must be compiled to contain position independent code.
  125.     For example, 
  126.     on DECstations you must use
  127.     <application>/bin/cc</application>
  128.     with the <literal>-G 0</literal> option when compiling object files to be
  129.     loaded.
  130.    </para>
  131.    <para>
  132.     Note that if you are porting <productname>Postgres</productname>
  133.     to a new platform, <command>LOAD</command>
  134.     will have to work in order to support ADTs.
  135.    </para>
  136.   </refsect2>
  137.  </refsect1>
  138.  <refsect1 id="R1-SQL-LOAD-2">
  139.   <title>
  140.    Usage
  141.   </title>
  142.   <para>
  143.    Load the file <filename>/usr/postgres/demo/circle.o</filename>:
  144.    <programlisting>
  145. LOAD '/usr/postgres/demo/circle.o'
  146.    </programlisting>
  147.   </para>
  148.  </refsect1>
  149.  <refsect1 id="R1-SQL-LOAD-3">
  150.   <title>
  151.    Compatibility
  152.   </title>
  153.   <para>
  154.   </para>
  155.   <refsect2 id="R2-SQL-LOAD-4">
  156.    <refsect2info>
  157.     <date>1998-09-24</date>
  158.    </refsect2info>
  159.    <title>
  160.     SQL92
  161.    </title>
  162.    <para>
  163.     There is no <command>LOAD</command> in <acronym>SQL92</acronym>.
  164.    </para>
  165.   </refsect2>
  166.  </refsect1>
  167. </refentry>
  168. <!-- Keep this comment at the end of the file
  169. Local variables:
  170. mode: sgml
  171. sgml-omittag:nil
  172. sgml-shorttag:t
  173. sgml-minimize-attributes:nil
  174. sgml-always-quote-attributes:t
  175. sgml-indent-step:1
  176. sgml-indent-data:t
  177. sgml-parent-document:nil
  178. sgml-default-dtd-file:"../reference.ced"
  179. sgml-exposed-tags:nil
  180. sgml-local-catalogs:"/usr/lib/sgml/catalog"
  181. sgml-local-ecat-files:nil
  182. End:
  183. -->