<!-- $Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/ref/pg_restore.sgml,v 1.4 2001/06/28 03:03:40 natsuyo Exp $ -->

<refentry id="APP-PGRESTORE">
 <docinfo>
  <date>2001-03-06</date>
 </docinfo>

 <refmeta>
  <refentrytitle>
   pg_restore
  </refentrytitle>
  <manvolnum>1</manvolnum>
  <refmiscinfo><!-- Application -->アプリケーション</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>pg_restore</refname>

  <refpurpose>
   <!-- Restore a <PRODUCTNAME>Postgres</PRODUCTNAME> database from an archive 
   file created by <command>pg_dump</command> -->

   <command>pg_dump</command>が作ったアーカイブファイルから<PRODUCTNAME>Postgres</PRODUCTNAME>データベースを復元します。<indexterm><primary>pg_restore</primary></indexterm><indexterm><primary>PostgreSQL</primary><secondary>pg_restore</secondary></indexterm><indexterm><primary sortas="でーたべーす">データベース</primary><secondary sortas="リストア">リストア</secondary></indexterm>

  </refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <cmdsynopsis>
   <command>pg_restore</command>
   <arg> -a </arg>
   <arg> -c </arg>
   <arg> -C </arg>
   <arg> -d <replaceable class="parameter">dbname</replaceable> </arg>
   <arg> -f <replaceable class="parameter">archive-file</replaceable> </arg>
   <arg> -F <replaceable class="parameter">format</replaceable> </arg>
   <arg> -i  <replaceable class="parameter">index</replaceable> </arg>
   <arg> -l </arg>
   <arg> -L <replaceable class="parameter">contents-file</replaceable> </arg>
   <group> <arg> -N </arg> <arg> -o </arg> <arg> -r </arg> </group>
   <arg> -O </arg>
   <arg> -P <replaceable class="parameter">function-name</replaceable> </arg>
   <arg> -R </arg>
   <arg> -s </arg>
   <arg> -S </arg>
   <arg> -t  <replaceable class="parameter">table</replaceable> </arg>
   <arg> -T  <replaceable class="parameter">trigger</replaceable> </arg>
   <arg> -v </arg>
   <arg> -x </arg>
   <arg> -h  <replaceable class="parameter">host</replaceable> </arg>
   <arg> -p  <replaceable class="parameter">port</replaceable> </arg>
   <arg> -u </arg>
   <arg> <replaceable class="parameter">archive-file</replaceable> </arg>
  </cmdsynopsis>
 </refsynopsisdiv>


 <refsect1 id="app-pgrestore-description">
  <title>
   <!-- Description -->説明
  </title>

  <para>
   <!-- <command>pg_restore</command> is a utility for restoring a
   <productname>Postgres</productname> database dumped by
   <xref linkend="app-pgdump"> in one of the non-plain-text formats.
   -->

   <command>pg_restore</command>は<xref linkend="app-pgdump">によって非プレーンテキストフォーマットでダンプされた<productname>Postgres</productname>データベースを格納するためのものです。

  </para>

  <para>
   <!-- The archive files, new with the 7.1 release, contain enough 
   information for <command>pg_restore</command> to rebuild the database, 
   but also allow <command>pg_restore</command> to be selective about what 
   is restored, or even to reorder the items prior to being restored. 
   The archive files are designed to be portable across architectures. 
   <command>pg_dump</command> will produce the queries necessary to 
   re-generate all user-defined types, functions, tables, indices, aggregates, 
   and operators.  In addition, all the data is copied out (in text format 
   for scripts) so that it can be readily copied in again. -->

   7.1リリースで新しくできたアーカイブファイルは、<command>pg_restore</command>がデータベースを再構築するための十分な情報を持っていますが、<command>pg_restore</command>が何をリストアするかを選ぶこと、さらにリストアされる前のアイテムを並べ替えることまで可能です。アーカイブファイルはアーキテクチャを越えて移植できるよう設計されています。<command>pg_dump</command>はすべてのユーザー定義型、関数、テーブル、インデックス、集約、演算子を再生成させるために必要な問い合わせを作ります。さらに、すべてのデータはコピーされるので（スクリプト用のテキストフォーマットで）、またいつでも読み込むことができます。
   
  </para>

  <para>
   <!--  
   <command>pg_restore</command> reads the archive file and outputs the 
   appropriate SQL in the required order based on the command parameters. 
   Obviously, it can not restore information that is not present in the dump 
   file; so if the dump is made using the <quote>dump data as 
   <command>INSERT</command>s</quote> option, <command>pg_restore</command> 
   will not be able to load the data using <command>COPY</command> statements.
   -->

   <command>pg_restore</command>は、アーカイブファイルを読み込み、コマンドパラメータに基づく要求される順番で適切なSQLを出力します。明らかに、ダンプファイルに存在しない情報はリストアすることができません。ですから、もしそのダンプが<quote><command>INSERT</command>のオプションとしてのダンプデータ</quote>を使って作られた場合、<command>pg_restore</command>は<command>COPY</command>文を使ってロードすることはできません。
  
  </para>

  <para>
   <!-- 
   The most flexible output file format is the <quote>custom</quote> format 
   (<option>-Fc</option>). It allows for selection and reordering of all 
   archived items, and is compressed by default. The <filename>tar</filename>
   format (<option>-Ft</option>) is not compressed and it is not possible to 
   reorder data when loading, but it is otherwise quite flexible. -->

   最も柔軟な出力ファイルフォーマットは<quote>カスタム</quote>フォーマット（<option>-Fc</option>）です。これはすべてのアーカイブに格納されたセレクトと並べ替えを可能にし、デフォルトでは圧縮されます。<filename>tar</filename>フォーマット（<option>-Ft</option>）は圧縮されず、ロード時にデータを並べ替えすることは不可能ですが、それ以外では非常に柔軟です。
  </para>

  <para>
   <!-- To reorder the items, it is first necessary to dump the contents of the 
   archive: -->

   アイテムを並べ替えるためには、まず始めにアーカイブの中身をダンプすることが必要です。
</para>

<screen>
<prompt>$</prompt> <userinput>pg_restore archive.file -l &gt; archive.list</userinput>
</screen>

<para>
   <!-- This file consists of a header and one line for each item, e.g., -->
   このファイルはヘッダーとそれぞれのアイテムに対する1行で構成されています。例を示します。
</para>

<programlisting>
;
; Archive created at Fri Jul 28 22:28:36 2000
;     dbname: birds
;     TOC Entries: 74
;     Compression: 0
;     Dump Version: 1.4-0
;     Format: CUSTOM
;
;
; Selected TOC Entries:
;
2; 145344 TABLE species postgres
3; 145344 ACL species
4; 145359 TABLE nt_header postgres
5; 145359 ACL nt_header
6; 145402 TABLE species_records postgres
7; 145402 ACL species_records
8; 145416 TABLE ss_old postgres
9; 145416 ACL ss_old
10; 145433 TABLE map_resolutions postgres
11; 145433 ACL map_resolutions
12; 145443 TABLE hs_old postgres
13; 145443 ACL hs_old
</programlisting>

<para>
   <!-- 
   Semi-colons are comment delimiters, and the numbers at the start of
   lines refer to the internal archive ID assigned to each item. -->

   セミコロン（;）はコメント区切り文字で、行の始まりの数字はそれぞれのアイテムに割り当てられた内部アーカイブIDを意味します。

  </para>

  <para>
   <!-- 
   Lines in the file can be commented out, deleted, and reordered. For example,
   -->
   ファイル内の行は、以下のようにコメントアウト、削除、並べ替えることができます。
</para>

<programlisting>
10; 145433 TABLE map_resolutions postgres
;2; 145344 TABLE species postgres
;4; 145359 TABLE nt_header postgres
6; 145402 TABLE species_records postgres
;8; 145416 TABLE ss_old postgres
</programlisting>

<para>
   <!-- 
   could be used as input to <command>pg_restore</command> and would only 
   restore items 10 and 6, in that order. -->
   上記の内容のファイルは、以下のようにして<command>pg_restore</command>への入力として使うことができ、アイテム10と6のみをその順でリストアします。
</para>

<screen>
<prompt>$</prompt> <userinput>pg_restore archive.file -L archive.list</userinput>
</screen>

  <refsect2 id="app-pgrestore-options">
   <title>
    <!-- Options -->オプション
   </title>

   <para>
    <!-- <command>pg_restore</command> accepts the following command
    line arguments.  (Long option forms are only available on some platforms.)
    -->
    <command>pg_restore</command>は以下のコマンドラインオプションを受け付けます（長いオプションフォームは限られたプラットフォームでしか使うことができません）。
</para>

    <variablelist>
     <varlistentry>
      <term><replaceable class="parameter">archive-name</replaceable></term>
      <listitem>
       <para>
       <!-- Specifies the location of the archive file to be restored.
       If not specified, and no <option>-f</option> option is specified, 
       then the standard input is used. -->

       リストアされるべきアーカイブファイルの位置を指定します。もし指定されず、<option>-f</option>オプションも指定されない場合は標準入力が使われます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-a</term>
      <term>--data-only</term>
      <listitem>
       <para>
	<!-- Restore only the data, no schema (definitions). -->
        データのみをリストアし、スキーマ（定義）は格納しません。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-c</term>
      <term>--clean</term>
      <listitem>
       <para>
	<!-- Clean (drop) schema prior to create. -->
        作成する前にスキーマを掃除（削除）します。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-C</term>
      <term>--create</term>
      <listitem>
       <para>
	<!-- Include SQL to create the schema. -->
        スキーマを作成するためにSQLを含めます。
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-d <replaceable class="parameter">dbname</replaceable></term>
      <term>--dbname=<replaceable class="parameter">dbname</replaceable></term>
      <listitem>
       <para>
        <!-- 
        Connect to database <replaceable class="parameter">dbname</replaceable>
        and restore directly into the database. BLOBs can only be restored 
        by using a direct database connection. -->

        データベース<replaceable class="parameter">dbname</replaceable>に接続し、データベースに直接リストアします。BLOBは直接データベース接続を使ってのみリストアすることができます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-f <replaceable>filename</replaceable></term>
      <term>--file=<replaceable>filename</replaceable></term>
      <listitem>
       <para>
        <!-- Specify output file for generated script. (Use with the
        <option>-l</option> option.) Default is the standard output.
        -->

        作成されたスクリプト用の出力ファイルを指定します（<option>-l</option>オプションと一緒に使います）。デフォルトは標準出力です。
 
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-F <replaceable class="parameter">format</replaceable></term>
      <term>--format=<replaceable class="parameter">format</replaceable></term>
      <listitem>
       <para>
	<!--   Specify format of the archive.
        It is not necessary to specify the format, since 
        <COMMAND>pg_restore</COMMAND> will determine the format automatically. 
        If specified, it can be one of the following: -->

        アーカイブのフォーマットを指定します。<COMMAND>pg_restore</COMMAND>がフォーマットを自動的に決定するため、フォーマットの指定は必ずしも必要ではありません。指定された場合、下記のうちのいずれかになります。

       </para>

       <variablelist>

        <varlistentry>
         <term>t</term>
         <listitem>
          <para>
           <!-- 
           Archive is a <filename>tar</filename> archive. Using this archive 
           format allows reordering and/or exclusion of schema elements at 
           the time the database is restored. It is also possible to limit 
           which data is reloaded at restore time. -->

           アーカイブは<filename>tar</filename>のアーカイブです。このアーカイブフォーマットを使うことによって並べ替えもしくはデータベースがリストアされる際のスキーマ要素の削除が可能になります。さらに、どのデータがリストア時にリロードされるかを制限することも可能です。

           </para>
         </listitem>
        </varlistentry>

        <varlistentry>
         <term>c</term>
         <listitem>
          <para>
           <!-- 
           Archive is in the custom format of <command>pg_dump</command>. 
           This is the most flexible format in that it allows reordering of 
           data load as well as schema elements.
           This format is also compressed by default. -->

           アーカイブは<command>pg_dump</command>のカスタムフォーマットです。これはもっとも柔軟なフォーマットで、スキーマ要素やデータロードの再オーダーなどが許可されます。このフォーマットもデフォルトでは圧縮されています。
          </para>
         </listitem>
        </varlistentry>

       </variablelist>

      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-i <replaceable class="parameter">index</replaceable></term>
      <term>--index=<replaceable class="parameter">index</replaceable></term>
      <listitem>
       <para>
	<!-- Restore definition for named 
       <replaceable class="parameter">index</replaceable> only. -->

       指定された<replaceable class="parameter">index</replaceable>の定義のみをリストアします。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-l</term>
      <term>--list</term>
      <listitem>
       <para>
        <!-- List the contents of the archive. The output of this command 
        can be used with the <option>-L</option> option
        to restrict and reorder the items that are restored. -->

        アーカイブの中身を一覧表示します。このコマンドの出力は、リストアされるアイテムを制限、並べ替えするために<option>-L</option>オプションで使うことができます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-L <replaceable class="parameter">list-file</replaceable></term>
      <term>--use-list=<replaceable class="parameter">list-file</replaceable></term>
      <listitem>
       <para>
	  <!-- Restore elements in 
          <REPLACEABLE CLASS="PARAMETER">list-file</REPLACEABLE> only, 
          and in the order they appear in the file. Lines can be moved and 
          may also be commented out by placing a ';' at the start of the line.
          -->

          <REPLACEABLE CLASS="PARAMETER">list-file</REPLACEABLE>の要素のみをファイルに現われる順にリストアします。行は動かすことができ、行の始めに「;」を付けることによりコメントアウトすることができます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-N</term>
      <term>--orig-order</term>
      <listitem>
       <para>
        <!-- Restore items in the original dump order. By default 
        <command>pg_dump</command> will dump items in an order convenient
        to <command>pg_dump</command>, then save the archive in a modified 
        OID order. This option overrides the OID ordering. -->

        元のダンプの順番でアイテムをリストアします。デフォルトでは<command>pg_dump</command>は、<command>pg_dump</command>をするのに便利な順番でアイテムをダンプします。そして変えられたOID順でアーカイブを保存します。このオプションはOIDの順番を無効にします。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-o</term>
      <term>--oid-order</term>
      <listitem>
       <para>
        <!-- 
        Restore items in the OID order. By default <command>pg_dump</command> 
        will dump items in an order convenient to <command>pg_dump</command>, 
        then save the archive in a modified OID order. This option enforces 
        strict OID ordering. -->
 
        アイテムをOIDの順番でリストアします。デフォルトでは<command>pg_dump</command>は、<command>pg_dump</command>にとって便利な順番でアイテムをダンプします。そして変えられたOIDの順番でアーカイブを保存します。このオプションはOIDの順番を厳しく強制します。 
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-O</term>
      <term>--no-owner</term>
      <listitem>
       <para>
        <!-- Prevent any attempt to restore original object ownership. 
        Objects will be owned by the user name used to attach to the database.
        -->

        元のオブジェクト所有権をリストアするための試みを防ぎます。オブジェクトは、データベースに接続するために使われたユーザー名に所有されます。
 
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-P <replaceable class="parameter">function-name</replaceable></term>
      <term>--function=<replaceable class="parameter">function-name</replaceable></term>
      <listitem>
       <para>
        <!-- Specify a procedure or function to be restored. -->
        リストアされるべきプロシージャもしくは関数を指定します。
   
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-r</term>
      <term>--rearrange</term>
      <listitem>
       <para>
        <!-- Restore items in modified OID order. By default 
        <command>pg_dump</command> will dump items in an order convenient
        to <command>pg_dump</command>, then save the archive in a modified OID 
        order. Most objects will be restored in OID order, but some things 
        (e.g., rules and indices) will be restored at the end of
        the process irrespective of their OIDs. This option is the default.
        -->

        変えられたOIDの順番でアイテムをリストアします。デフォルトでは<command>pg_dump</command>は<command>pg_dump</command>にとって便利な順番でアイテムをダンプし、変えられたOIDの順番でアーカイブを保存します。ほとんどのオブジェクトはOID順にリストアされますが、いくつかのもの（たとえばルールやインデックス）はOIDに関係なくプロセスの最後にリストアされます。このオプションはデフォルトです。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-R</term>
      <term>--no-reconnect</term>
      <listitem>
       <para>
	  <!-- Prohibit <COMMAND>pg_restore</COMMAND> from issuing any 
<programlisting>&bsol;connect</programlisting> statements or reconnecting 
          to the database if directly connected. -->
          <COMMAND>pg_restore</COMMAND>が<command>&bsol;connect</command>文、もしくは直接接続されている場合はデータベースへの再接続を発行することを禁止します。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-s</term>
      <term>--schema-only</term>
      <listitem>
       <para>
        <!-- 
	Restore the schema (definitions), no data. Sequence values will be 
        reset. -->

        スキーマ（定義）をリストアし、データはリストアしません。シーケンス値はリセットされます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-S <replaceable class="parameter">username</replaceable></term>
      <term>--superuser=<replaceable class="parameter">username</replaceable></term>
      <listitem>
       <para>
        <!--  
        Specify the superuser user name to use when disabling triggers and/or 
        setting ownership of schema elements.
        By default, <COMMAND>pg_restore</COMMAND> will use the current user 
        name if it is a superuser. -->

        トリガを無効にする際、もしくはスキーマ要素の所有権を設定する際に使うために、スーパーユーザーのユーザー名を指定します。デフォルトでは<COMMAND>pg_restore</COMMAND>は、もしそれがスーパーユーザーならば現在のユーザー名を使います。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-t <replaceable class="parameter">table</replaceable></term>
      <term>--table=<replaceable class="parameter">table</replaceable></term>
      <listitem>
       <para>
	<!-- Restore schema/data for 
        <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> only. -->

        スキーマ/データを<REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE>にのみリストアします。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-T <replaceable class="parameter">trigger</replaceable></term>
      <term>--trigger=<replaceable class="parameter">trigger</replaceable></term>
      <listitem>
       <para>
	 <!--  Restore definition of 
         <REPLACEABLE CLASS="PARAMETER">trigger</REPLACEABLE> only. -->

         <REPLACEABLE CLASS="PARAMETER">トリガ</REPLACEABLE>の定義のみをリストアします。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-v</term>
      <term>--verbose</term>
      <listitem>
       <para>
	<!-- Specifies verbose mode. -->verboseモードを指定します。
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-x</term>
      <term>--no-acl</term>
      <listitem>
       <para>
	<!-- Prevent restoration of ACLs (grant/revoke commands). -->
        ACL（grant/revokeコマンド）のリストアを防ぎます。

       </para>
      </listitem>
     </varlistentry>

    </variablelist>

   <para>
    <!-- <command>pg_restore</command> also accepts
    the following command line arguments for connection parameters: -->

    <command>pg_restore</command>はさらに以下のコマンドライン引数を接続パラメータとして受け付けます。
</para>

    <variablelist>
     <varlistentry>
      <term>-h <replaceable class="parameter">host</replaceable></term>
      <term>--host=<replaceable class="parameter">host</replaceable></term>
      <listitem>
       <para>
	<!-- Specifies the host name of the machine on which the
	<command>postmaster</command>
	is running.  If host begins with a slash, it is used 
	as the directory for the Unix domain socket. -->

        <command>postmaster</command>が起動しているマシンのホスト名を指定します。もしホストがスラッシュで始まる場合、Unixドメインソケット用のディレクトリとして使われます。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-p <replaceable class="parameter">port</replaceable></term>
      <term>--port=<replaceable class="parameter">port</replaceable></term>
      <listitem>
       <para>
        <!-- 
	Specifies the Internet TCP/IP port or local Unix domain socket file
	extension on which the <command>postmaster</command>
	is listening for connections.  The port number defaults to 5432,
	or the value of the <envar>PGPORT</envar>
	environment variable (if set). -->

        <command>postmaster</command>が接続を監視するインターネットTCP/IPポートもしくはUnixドメインソケットファイル拡張を指定します。ポート番号はデフォルトでは5,432もしくは環境変数<envar>PGPORT</envar>（設定されている場合）になります。

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>-u</term>
      <listitem>
       <para>
	<!-- Use password authentication. Prompts for user name and password.
        -->パスワード認証を使います。ユーザー名とパスワードを促します。
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
  </refsect2>

 </refsect1>


 <refsect1 id="app-pgrestore-diagnostics">
  <title><!-- Diagnostics -->診断</title>

  <msgset>
   <msgentry>
    <msg>
     <msgmain>
      <msgtext>
<screen><computeroutput>
Connection to database 'template1' failed.
connectDBStart() -- connect() failed: No such file or directory
        Is the postmaster running locally
        and accepting connections on Unix socket '/tmp/.s.PGSQL.5432'?
</computeroutput></screen>
      </msgtext>
     </msgmain>
    </msg>

    <msgexplan>
       <para>
	<!-- <command>pg_restore</command> could not attach to the
	<command>postmaster</command>
	process on the specified host and port.  If you see this message,
	ensure that the <command>postmaster</command>
	is running on the proper host and that you have specified the proper
	port.  If your site uses an authentication system, ensure that you
	have obtained the required authentication credentials. -->

        <command>pg_restore</command>は、指定されたホストとポート上の<command>postmaster</command>プロセスに接続することができませんでした。このメッセージが表示された場合は、<command>postmaster</command>が正しいホスト上で起動していて正しいポートを指定していることを確認してください。もし認証システムを使うサイトの場合は、必要とされる認証証明があることを確認してください。

       </para>
    </msgexplan>
   </msgentry>
  </msgset>  

   <note>
    <para>
     <!-- 
     When a direct database connection is specified using the -d option, 
     <command>pg_restore</command> internally executes  <command>SQL</command> 
     statements. If you  have problems running
     <command>pg_restore</command>,
     make sure you are able to select information from the database using, for
     example, <command>psql</command>. -->

     直接データベース接続が-dオプションで指定されるとき、<command>pg_restore</command>は内部で<command>SQL</command>を実行します。もし<command>pg_restore</command>の実行で問題がある場合、たとえば<command>psql</command>などを使ってデータベースから情報を選択できることを確認してください。

    </para>
   </note>
 </refsect1>


 <refsect1 id="app-pgrestore-notes">
  <title>
   <!-- Notes -->注釈
  </title>

  <para>
   <!-- 
   The limitations of <command>pg_restore</command> are detailed below.
   -->
   <command>pg_restore</command>の制限を以下に示します。
</para>

   <itemizedlist>
    <listitem>
     <para>
      <!-- 
      When restoring data to a table, <command>pg_restore</command> emits 
      queries to disable triggers on user tables before inserting the data 
      then emits queries to re-enable them after the data has been inserted.  
      If the restore is stopped in the middle, the system catalogs may be 
      left in the wrong state. -->

      データをテーブルに格納するとき、<command>pg_restore</command>は、データを挿入する前にユーザーテーブルにトリガを無効とするための問い合わせを発行し、そしてデータが挿入されるとそれらをまた可能にするための問い合わせを発行します。もしリストアが途中で中止された場合、システムカタログは間違った状態で残されるかもしれません。

     </para>
    </listitem>

    <listitem>
     <para>
      <!--   
      <command>pg_restore</command> will not restore BLOBs for a single table. 
      If an archive contains BLOBs, then all BLOBs will be restored. -->

      <command>pg_restore</command>は単一のテーブルにはBLOB（ラージオブジェクト）をリストアしません。もしアーカイブがBLOBを含む場合、すべてのBLOBがリストアされます。

     </para>
    </listitem>

   </itemizedlist>

  <para>
   <!-- See the <xref linkend="app-pgdump"> documentation for details on
   limitation of <command>pg_dump</command>. -->

   <command>pg_dump</command>の制限に関する詳細は、<xref linkend="app-pgdump">
   のドキュメントを見てください。

  </para>
 </refsect1>


 <refsect1 id="app-pgrestore-examples">
  <title>
   <!-- Examples -->例
  </title>

  <para>
   <!-- To dump a database: -->以下はデータベースをダンプする例です。
</para>

<screen>
<prompt>$</prompt> <userinput>pg_dump mydb &gt; db.out</userinput>
</screen>

  <para>
   <!-- To reload this database: -->このデータベースをリロードするには以下のようにします。
</para>

<screen>
<prompt>$</prompt> <userinput>psql -d database -f db.out</userinput>
</screen>

  <para>
   <!-- To dump a database called mydb that contains
   <acronym>BLOB</acronym>s to a <filename>tar</filename> file: -->

   mydbという<acronym>BLOB</acronym>（ラージオブジェクト）を含むデータベースを<filename>tar</filename>ファイルにダンプするには以下のようにします。
</para>

<screen>
<prompt>$</prompt> <userinput>pg_dump -Ft -b mydb &gt; db.tar</userinput>
</screen>

  <para>
   <!-- To reload this database (with <acronym>BLOB</acronym>s) to an
   existing database called newdb: -->

   このデータベース（<acronym>BLOB</acronym>――ラージオブジェクトを含むもの）を既存のnewdbというデータベースにリロードするには以下のようにします。
</para>

<screen>
<prompt>$</prompt> <userinput>pg_restore -d newdb db.tar</userinput>
</screen>

 </refsect1>


 <refsect1>
  <title><!-- See Also -->参照</title>

  <simplelist type="inline">
   <member><xref linkend="app-pgdump"></member>
   <member><xref linkend="app-pg-dumpall"></member>
   <member><xref linkend="app-psql"></member>
   <member><citetitle><!-- PostgreSQL Administrator's Guide -->
   &admin-guide;</citetitle></member>
  </simplelist>
 </refsect1>
</refentry>

<!-- 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:
-->
