<!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.5 2001/03/03 22:11:40 tgl 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
  </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>
   <para>
   
   <variablelist>
     <varlistentry>
      <term>TEMPORARY or TEMP</term>
      <listitem>
       <para>
	If specified, the table is created only for 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 a new table to be created.
      </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.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><replaceable>select_clause</replaceable></term>
      <listitem>
       <para>
	A valid query statement. Refer to SELECT for a description of the
	allowed syntax.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect2>

  <refsect2>
   <refsect2info>
    <date>1998-09-22</date>
   </refsect2info>
   <title>
    Outputs
   </title>
   <para>
    Refer to <command>CREATE TABLE</command>
    and <command>SELECT</command> for a summary of possible output
    messages.
   </para>
  </refsect2>
 </refsynopsisdiv>
 
 <refsect1>
  <refsect1info>
   <date>1998-09-22</date>
  </refsect1info>
  <title>
   Description
  </title>
  <para>
   <command>CREATE TABLE AS</command> enables a table to be created
   from the contents of an existing table.
   It is functionally equivalent to
   <xref linkend="sql-selectinto" endterm="sql-selectinto-title">,
   but with perhaps a more direct syntax.
  </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:
-->
