<!--
$Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/manage.sgml,v 1.9 2001/09/10 05:23:38 t-ishii Exp $
-->

 <Chapter Id="manage">
  <!--<Title>Managing a Database</Title>-->
  <Title>データベース管理</Title>
<indexterm><primary sortas="でーたべーすかんり">データベース管理</primary></indexterm>
<indexterm><primary>PostgreSQL</primary><secondary sortas="でーたべーすかんり">データベース管理</secondary></indexterm>

  <Note>
   <para>
    <!--This section is currently a thinly disguised copy of the
    Tutorial. Needs to be augmented.
    - thomas 1998-01-12-->

    このセクションは、現在<citetitle>&tutorial-guide;</citetitle>にある内容を元に少々手を加えたものです。今後内容を増やす必要があります。
   </para>
  </Note>

  <para>
   <!--Although the <FirstTerm>site administrator</FirstTerm> is responsible for overall management 
   of the <ProductName>Postgres</ProductName> installation, some databases within the
   installation may be managed by another person, 
   designated the <FirstTerm>database administrator</FirstTerm>.
   This assignment of responsibilities occurs when a database is created. 
   A user may be assigned explicit privileges to create databases and/or to create new users. 
   A user assigned both privileges can perform most administrative task 
   within <ProductName>Postgres</ProductName>, but will
   not by default have the same operating system privileges as the site administrator.-->

   <FirstTerm>サイト管理者</FirstTerm>は、<ProductName>Postgres</ProductName>のインストール全般に渡って責任があるとはいっても、インストール内のいくつかのデータベースは<FirstTerm>データベース管理者</FirstTerm>と呼ばれる別の人に管理をゆだねることができます。<indexterm><primary sortas="さいとかんりしゃ">サイト管理者</primary></indexterm><indexterm><primary sortas="でーたべーすかんりしゃ">データベース管理者</primary></indexterm>この責任の付与はデータベースが作成されたときに発生します。あるユーザーに、データベース作成を行う権限とユーザー登録を行う権限を明示的に付与することができます。両権現を持ったユーザーは、<ProductName>Postgres</ProductName>内でほとんどの管理作業を行うことができますが、デフォルトではサイト管理者とは異なって、オペレーティングシステム上での同じような権限を持ちません。

  </para>

  <para>
   <!--The Database Administrator's Guide covers these topics in more detail.-->
   <citetitle>&admin-guide;</citetitle>では、これらの話題についてより詳細に扱っています。
  </para>

  <Sect1 id="db-creation">
   <!--<Title>Database Creation</Title>-->
   <Title>データベースの作成</Title>
<indexterm><primary sortas="でーたべーす">データベース</primary><secondary sortas="さくせい">作成</secondary></indexterm>
<indexterm><primary>PostgreSQL</primary><secondary sortas="でーたべーすのさくせい">データベースの作成</secondary></indexterm>
   <para>
    <!--Databases are created by the <Command>create database</Command> issued from
    within <ProductName>Postgres</ProductName>. <Application>createdb</Application> is a command-line
    utility provided to give the same functionality from outside <ProductName>Postgres</ProductName>.-->

    データベースは、<ProductName>Postgres</ProductName>内から<Command>create database</Command>コマンドを発行することで作成されます。<Application>createdb</Application>はコマンドラインユーティリティで、<ProductName>Postgres</ProductName>外部から同じ機能を提供するものです。
   </para>

   <para>
    <!--The <ProductName>Postgres</ProductName> backend must be running for either method
    to succeed, and the user issuing the command must be the <ProductName>Postgres</ProductName>
    <FirstTerm>superuser</FirstTerm> or have been assigned database creation privileges by the
    superuser.-->

    どちらの方法もうまく動作するためには、<ProductName>Postgres</ProductName>バックエンドが実行していなければいけません。また、コマンドを発行するユーザーは<ProductName>Postgres</ProductName>の<firstterm>スーパーユーザー</firstterm>、またはスーパーユーザーからデータベース作成の権限を付与されている人でなければいけません。

   </para>

   <para>
    <!--To create a new database named <literal>mydb</literal> from the command line, type-->

    コマンドラインから<literal>mydb</literal>というデータベースを作成するには、以下のように入力します。</para>

<programlisting>
% <userinput>createdb mydb</userinput>
</programlisting>

    <!--and to do the same from within <Application>psql</Application> type-->
<para><Application>psql</Application>からの場合は以下のように入力します。</para>

<programlisting>
=> <userinput>CREATE DATABASE mydb;</userinput>
</programlisting>

   <para>
    <!--If you do not have the privileges required to create a database, you will see
    the following:-->
  
    データベースを作成する権限がなかった場合は以下のメッセージが表示されます。</para>

<programlisting>
ERROR:  CREATE DATABASE: Permission denied.
</programlisting>

   <para>
    <!--<ProductName>Postgres</ProductName>  allows  you to create any number of databases
    at a  given  site  and  you  automatically  become  the
    database  administrator  of  the database you just created.  
    Database names must  have  an  alphabetic  first
    character and are limited to 32 characters in length.-->

    <ProductName>Postgres</ProductName>は、ある特定のサイトにおいて、いくつでもデータベースを作成することを許しており、その作成者は自動的に、作成したデータベースの管理者となります。データベースの名前は英文字で始まり32文字以内に限られます。
   </para>

  </Sect1>

  <Sect1 id="altern-locations">
   <!--<Title>Alternate Database Locations</Title>-->
   <Title>データベースの代替領域</Title>
<indexterm><primary sortas="でーたべーす">データベース</primary><secondary sortas="だいたいりょういき">代替領域</secondary></indexterm>
<indexterm><primary>PostgreSQL</primary><secondary sortas="でーたべーすのだいたいりょういき">データベースの代替領域</secondary></indexterm>
   <para>
    <!--It is possible to create a database in a location other than the default
    location for the installation. Remember that all database access actually
    occurs through the database backend, so that any location specified must
    be accessible by the backend.-->

    インストールの際のデフォルトの領域以外にも、データベースを作成することが可能です。しかし、すべてのデータベースアクセスはデータベースバックエンドを通じて発生するため、指定されたいかなる領域もバックエンドからアクセスできる必要があります。
   </para>

   <para>
    <!--Alternate database locations are created and referenced by an environment variable 
    which gives the absolute path to the intended storage location.  
    This environment variable must have been defined before the postmaster was started 
    and the location it points to must be writable by the postgres administrator account.
    Consult with the site administrator
    regarding preconfigured alternate database locations.  
    Any valid environment variable name may be used to reference an alternate location, 
    although using variable names with a prefix of <envar>PGDATA</envar> is recommended 
    to avoid confusion 
    and conflict with other variables.-->

    作成された代替のデータベース領域へは、意図された記憶領域への絶対パスを指定する環境変数を使って参照されます。環境変数はpostmasterが起動する前に設定され、postgresの管理者アカウントで書き込めなければいけません。すでに設定済みの代替のデータベース領域に関しては、サイト管理者に相談してください。代替領域を参照するためには、いかなる環境変数名も使用できますが混乱と他の変数とのコンフリクトを避けるため、変数名の先頭に「PGDATA」を付けておくことを推奨します。
   </para>

   <Note>
    <para>
     <!--In previous versions of <ProductName>Postgres</ProductName>, 
     it was also permissable to use an absolute path name to specify 
     an alternate storage location.  
     Although the environment variable style of specification
     is to be preferred since it allows the site administrator more flexibility in
     managing disk storage, it is also possible to use an absolute path 
     to specify an alternate location.  
     The administrator's guide discusses how to enable this feature.-->

     前のバージョンの<ProductName>Postgres</ProductName>では、絶対パス名で代替記憶領域を指定することも許されていました。サイト管理者がより柔軟にディスク管理を行えるために環境変数での設定が好まれますが、絶対パスを代替領域の指定に使うことも可能です。<citetitle>&admin-guide;</citetitle>にはこの機能を有効にする方法についての記載があります。
    </para>
   </Note>

   <para>
    <!--For security and integrity reasons,
    any path or environment variable specified has some
    additional path fields appended.
    Alternate database locations must be prepared by running 
    <Application>initlocation</Application>.-->

    セキュリティと一貫性の理由から、指定されたパスや環境変数には付加的なパスフィールドが加えられます。代替のデータベース領域を用意するには、<Application>initlocation</Application>を実行しなければいけません。
   </para>

   <para>
    <!--To create a data storage area using the environment variable 
    <envar>PGDATA2</envar> (for this example set to <filename>/alt/postgres</filename>), 
    ensure that <FileName>/alt/postgres</FileName> already exists and is writable by 
    the Postgres administrator account.
    Then, from the command line, type-->

    データ記憶領域を環境変数<envar>PGDATA2</envar>（この例では/alt/postgresに設定されています）を使って作成するには、<FileName>/alt/postgres</FileName>がすでに存在しているかどうか、またPostgres管理者アカウントで書き込み可能かを確認してください。確認ができたら、コマンドラインから以下を入力します。</para>

<programlisting>
% <userinput>initlocation PGDATA2</userinput>
The location will be initialized with username "postgres".
This user will own all the files and must also own the server process.

Creating directory /alt/postgres/data
Creating directory /alt/postgres/data/base

initlocation is complete.
You can now create a database using
   CREATE DATABASE &lt;name&gt; WITH LOCATION = 'PGDATA2'
in SQL, or
   createdb &lt;name&gt; -D 'PGDATA2'
from the shell.
</programlisting>

   <para>
    <!--To create a database in the alternate storage area <envar>PGDATA2</envar>
    from the command line, use the following command: -->

    代替記憶領域<envar>PGDATA2</envar>にデータベースを作成するにはコマンドラインから下記のコマンドを入力します。</para>

<programlisting>
% <userinput>createdb -D PGDATA2 mydb</userinput>
</programlisting>

    <!--and to do the same from within <Application>psql</Application> type-->

<para>同じ事を<Application>psql</Application>から行うには、以下のように入力します。</para>

<programlisting>
=> <userinput>CREATE DATABASE mydb WITH LOCATION = 'PGDATA2';</userinput>
</programlisting>


   <para>
    <!--If you do not have the privileges required to create a database, you will see
    the following:-->

    データベースを作成する権限がなかった場合は以下のメッセージが表示されます。</para>

<programlisting>
ERROR:  CREATE DATABASE: permission denied
</programlisting>

   <para>
    <!--If the specified location does not exist or the database backend does not have
    permission to access it or to write to directories under it, you will see
    the following:-->

指定した場所が存在しない、あるいはデータベースバックエンドがそこへアクセスする権限がない、あるいはそのディレクトリ下に書き込む権限がない場合には下記のようなメッセージが表示されます。</para>

<programlisting>
ERROR:  The database path '/no/where' is invalid. This may be due to a character that is not allowed or because the chosen path isn't permitted for databases. 
</programlisting>

  </Sect1>

<Sect1 id="db-accessing">
<!--<Title>Accessing a Database</Title>-->
<Title>データベースへの接続</Title>
<indexterm><primary sortas="でーたべーす">データベース</primary><secondary sortas="せつぞく">接続</secondary></indexterm>
<indexterm><primary>PostgreSQL</primary><secondary sortas="でーたべーすへのせつぞく">データベースへの接続</secondary></indexterm>
<para>
     <!--Once you have constructed a database, you can access it
     by:-->

     データベースが作成されたら、以下の方法で接続することができます。
</para>

<ItemizedList Mark="bullet" Spacing="compact">

<ListItem>
<para>
     <!--running the <ProductName>PostgreSQL</ProductName>  interactive terminal
     <Application>psql</Application> which allows you to interactively
     enter, edit, and execute <Acronym>SQL</Acronym> commands.-->

     <Acronym>SQL</Acronym>コマンドを対話的に入力、編集、実行する<ProductName>PostgreSQL</ProductName>のインタラクティブターミナルである、<Application>psql</Application>を使用します。

</para>
</ListItem>

<ListItem>
<para>
        <!--writing a  C  program  using  the  LIBPQ  subroutine
        library.   This  allows  you  to submit <Acronym>SQL</Acronym> commands
        from C and get answers and status messages  back  to
        your  program.   This interface is discussed further
        in <citetitle>The PostgreSQL Programmer's Guide</citetitle>.-->

        サブルーチンライブラリlibpqを使ったCプログラムを書きます。これはSQLコマンドをCから発行し、結果とステータスメッセージはプログラムが受け取ります。このインターフェイスの詳細は<citetitle>&programmer-guide;</citetitle>を参照してください。

</para>
</ListItem>
</ItemizedList>

<!--You might want to start up <Application>psql</Application>, 
to try out the examples in this manual.
 It can be activated for the <Database>mydb</Database>
     database by typing the command:-->

<para>
このマニュアルでは、いくつかの例の検証として<Application>psql</Application>
を起動しています。データベース<Database>mydb</Database>の起動には、以下のように入力します。
</para>

<programlisting>
% <userinput>psql mydb</userinput>
</programlisting>

     <!--You will be greeted with the following message:-->
<para>
すると次のように表示されます。
</para>

<programlisting>
Welcome to psql, the PostgreSQL interactive terminal.
 
Type:  &bsol;copyright for distribution terms
       &bsol;h for help with SQL commands
       &bsol;? for help on internal slash commands
       &bsol;g or terminate with semicolon to execute query
       &bsol;q to quit

mydb=>
</programlisting>

<para>
<!--This prompt indicates that psql is listening
  to you and that you can type <Acronym>SQL</Acronym> queries into a
     workspace maintained by the terminal monitor.
     The <Application>psql</Application> program responds to escape  codes  that  begin
     with  the  backslash  character, "<literal>&bsol;</literal>".  For example, you
     can get help on the syntax of various
 <ProductName>PostgreSQL</ProductName> <Acronym>SQL</Acronym> commands by typing:-->

このプロンプトは、ターミナルモニタは入力待ち状態で、ターミナルモニタが維持している作業スペースに<Acronym>SQL</Acronym>文を入力できることを示しています。<Application>psql</Application>プログラムはバックスラッシュ文字、「<literal>&bsol;</literal>」で始まるエスケープコードに応答します。<ProductName>PostgreSQL</ProductName> <Acronym>SQL</Acronym>文の文法のヘルプは、下記のように入力することで得ることができます。 </para>

<programlisting>
mydb=> <userinput>&bsol;h</userinput>
</programlisting>

     <!--Once  you  have finished entering your queries into the
     workspace, you can pass the contents of  the  workspace
     to the <ProductName>Postgres</ProductName> server by typing:-->

<para>作業スペースへの問い合わせの入力が終了したら、作業スペースの内容を<ProductName>Postgres</ProductName>サーバーへ次のように入力して渡すことができます。</para>

<programlisting>
mydb=> <userinput>&bsol;g</userinput>
</programlisting>

     <!--This  tells  the  server  to process the query.  If you
     terminate your query with a semicolon, the  "<literal>&bsol;g</literal>" is  not
     necessary.   
     <Application>psql</Application> will automatically process semicolon 
     terminated queries.  To read queries from a file,  say  myFile,  instead  of
     entering them interactively, type:-->

<para>これはサーバーに問い合わせの処理を督促します。問い合わせをセミコロンで終わらせた場合には、「<literal>&bsol;g</literal>」は必要ありません。<Application>psql</Application>はセミコロンで終わった問い合わせを自動的に処理します。対話的に入力するのではなく、ファイルから問い合わせを読み込ませたい場合は、以下のように入力します。</para>

<programlisting>
mydb=> <userinput>&bsol;i fileName</userinput>
</programlisting>

     <!--To get out of <Application>psql</Application> and return to Unix, type-->

<para><Application>psql</Application>から抜けてUNIXに戻るには、以下のように入力します。</para>

<programlisting>
mydb=> <userinput>&bsol;q</userinput>
</programlisting>

     <!--and  <Application>psql</Application>  will  quit  and  return  you to your command
     shell. (For more escape codes, type <Command>&bsol;?</Command> at  the  psql
     prompt.)
     White  space  (i.e.,  spaces, tabs and newlines) may be
     used freely in <Acronym>SQL</Acronym> queries.  Single-line comments  are  denoted  by-->

<para><Application>psql</Application>は終了し、コマンドシェルに戻ります（その他のエスケープコードについては、モニタのプロンプトで<Command>&bsol;?</Command>と入力してください）。空白（スペース、タブ、改行）は<Acronym>SQL</Acronym>文の中で自由に使うことができます。一行のコメントは"<literal>--</literal>"で表します。

     <!--Everything  after the dashes up to the end of the
     line is ignored. Multiple-line comments, and comments within a line,
     are denoted by-->

ハイフンの後の行の最後まではすべて無視されます。複数行のコメントと、行の中にいれるコメントは「<literal>/* ... */</literal>」で表します。
</para>

</Sect1>
     
<Sect1 id="db-destroy">
<!--<Title>Destroying a Database</Title>-->
<Title>データベースの削除</Title>
<indexterm><primary sortas="でーたべーす">データベース</primary><secondary sortas="さくじょ">削除</secondary></indexterm>
<indexterm><primary>PostgreSQL</primary><secondary sortas="でーたべーすのさくじょ">データベースの削除</secondary></indexterm>
<para>
     <!--If you are the owner of the  database
     <Database>mydb</Database>,  you can destroy it using the following Unix command:-->

     データベース<Database>mydb</Database>の所有者であれば、下記のUnixコマンドでデータベースを削除できます。</para>

<programlisting>
% <userinput>dropdb mydb</userinput>
</programlisting>

     <!--This action physically removes all of the Unix files
     associated  with  the database and cannot be undone, so
     this should only be done with a great deal of forethought.-->

<para>この作業は、データベースに付随関連するすべてのUnixファイルを物理的に削除します。削除したものは復元ができませんので、十分注意してください。

</para>
</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:
-->
