aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref/create_table_as.sgml
blob: a93989586acee701928cbbc236248c33c30083d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
<!--
$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:
-->