<!--
$Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/ref/create_table_as.sgml,v 1.3 2001/06/28 09:37:07 natsuyo Exp $
Postgres documentation
-->

<refentry id="SQL-CREATETABLEAS">
 <refmeta>
  <refentrytitle id="SQL-CREATETABLEAS-TITLE">
   CREATE TABLE AS
  </refentrytitle>
  <refmiscinfo>SQL<!-- Language Statements -->言語</refmiscinfo>
 </refmeta>
 <refnamediv>
  <refname>
   CREATE TABLE AS
  </refname>
  <refpurpose>
   <!-- Creates a new table from the results of a SELECT -->
   SELECTの結果から新しいテーブルを作成します。<indexterm><primary>CREATE TABLE AS</primary></indexterm><indexterm><primary>SQL</primary><secondary>CREATE TABLE AS</secondary></indexterm><indexterm><primary sortas="てーぶる">テーブル</primary><secondary sortas="SELECTからさくせい">SELECTから作成</secondary></indexterm>
  </refpurpose>
 </refnamediv>
 <refsynopsisdiv>
  <refsynopsisdivinfo>
   <date>2001-03-03</date>
  </refsynopsisdivinfo>
<synopsis>
CREATE [ TEMPORARY | TEMP ] TABLE <replaceable>table</replaceable> [ (<replaceable>column</replaceable> [, ...] ) ]
     AS <replaceable>select_clause</replaceable>
</synopsis>
  
  <refsect2>
   <refsect2info>
    <date>1998-09-22</date>
   </refsect2info>
   <title>
    <!-- Inputs -->入力
   </title>
   
   <variablelist>
     <varlistentry>
      <term><!-- TEMPORARY or TEMP -->
      TEMPORARYまたはTEMP</term>
      <listitem>
       <para>
        <!-- 
	If specified, the table is created only within this session, and is
	automatically dropped on session exit.
	Existing permanent tables with the same name are not visible
	(in this session) while the temporary table exists.
	Any indexes created on a temporary table are automatically
	temporary as well. -->

        指定されている場合は、テーブルはこのセッション内でのみ作られ、セッションの終わりに自動的に削除されます。同じ名前を持つ既存の永続テーブルは（このセッション内では）一時テーブルが存在する間は見ることができません。一時テーブル上に作られるインデックスは自動的に一時的なものになります。

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

    <varlistentry>
     <term><replaceable>table</replaceable></term>
     <listitem>
      <para>
        <!-- The name of the new table to be created.
	This table must not already exist.  However, a temporary table
	can be created that has the same name as an existing permanent
	table. -->

        新しく作られるテーブル名です。このテーブルはすでに存在するものであってはいけません。しかし、既存の永続テーブルと同じ名前を持つ一時テーブルを作ることはできます。

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

     <varlistentry>
      <term><replaceable>column</replaceable></term>
      <listitem>
       <para>
        <!-- 
	The name of a column. Multiple column names can be specified using
	a comma-delimited list of column names.  If column names are not
	provided, they are taken from the output column names of the
	SELECT query. -->

        列の名前です。カンマで区切られた列名のリストを使って複数の列名を指定することができます。列名を指定しない場合は、SELECT問い合わせの出力列名からとられます。

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

     <varlistentry>
      <term><replaceable>select_clause</replaceable></term>
      <listitem>
       <para>
	<!-- A valid query statement. Refer to
	<xref linkend="sql-select" endterm="sql-select-title">
	for a description of the allowed syntax. -->

        有効な問い合わせ文です。認められる構文の説明は<xref linkend="sql-select" endterm="sql-select-title">を参照してください。

       </para>
      </listitem>
     </varlistentry>
    </variablelist>
  </refsect2>

  <refsect2>
   <refsect2info>
    <date>1998-09-22</date>
   </refsect2info>
   <title>
    <!-- Outputs -->出力
   </title>

   <para>
    <!-- Refer to
    <xref linkend="sql-createtable" endterm="sql-createtable-title">
    and
    <xref linkend="sql-select" endterm="sql-select-title">
    for a summary of possible output messages. -->

    出力メッセージの要約は<xref linkend="sql-createtable" endterm="sql-createtable-title">と<xref linkend="sql-select" endterm="sql-select-title">を参照してください。

   </para>
  </refsect2>
 </refsynopsisdiv>
 
 <refsect1>
  <refsect1info>
   <date>2001-03-20</date>
  </refsect1info>
  <title>
   <!-- Description -->説明
  </title>
  <para>
   <!-- 
   <command>CREATE TABLE AS</command> creates a table and fills it
   with data computed by a <command>SELECT</command> command.  The
   table columns have the names and datatypes associated with the
   output columns of the <command>SELECT</command> (except that you
   can override the <command>SELECT</command> column names by giving
   an explicit list of column names). -->

   <command>CREATE TABLE AS</command>は、テーブルを作成し、<command>SELECT</command>コマンドによって算出されるデータを格納します。テーブルの列は<command>SELECT</command>の出力列と関連する名前とデータ型を持ちます（ただし<command>SELECT</command>列名は列名を明示したリストを渡すことで無効にすることができます）。

  </para>

  <para>
   <!-- 
   <command>CREATE TABLE AS</command> bears some resemblance to creating
   a view, but it is really quite different: it creates a new table and
   evaluates the <command>SELECT</command> just once to fill the new table
   initially.  The new table will not track subsequent changes to
   the source tables of the <command>SELECT</command>.  In contrast,
   a view re-evaluates the given <command>SELECT</command> whenever queried.
   -->

   <command>CREATE TABLE AS</command>はビューの作成と似ている部分がありますが、実際はまったく異なります。CREATE TABLE ASは新しいテーブルを作成し、新しいテーブルの中身を初期化するために一度だけ<command>SELECT</command>を評価します。新しいテーブルはその次の変化を<command>SELECT</command>のソーステーブルに反映しません。反対に、ビューは与えられた<command>SELECT</command>を問い合わせられるたびに再評価します。

  </para>

  <para>
   <!-- This command is functionally equivalent to
   <xref linkend="sql-selectinto" endterm="sql-selectinto-title">,
   but it is preferred since it is less likely to be confused with
   other uses of the <command>SELECT ... INTO</command> syntax.
   -->

   このコマンドは<xref linkend="sql-selectinto" endterm="sql-selectinto-title">と同じ機能を持ちますが、<command>SELECT ... INTO</command>構文の他の使用方法と混乱する可能性が少ないため、こちらを使用する方がよいでしょう。

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