mirror of
https://github.com/postgres/postgres.git
synced 2025-12-21 05:21:08 +03:00
bb4eefe7bf
DocBook XML is superficially compatible with DocBook SGML but has a slightly stricter DTD that we have been violating in a few cases. Although XSLT doesn't care whether the document is valid, the style sheets don't necessarily process invalid documents correctly, so we need to work toward fixing this. This first commit moves the indexterms in refentry elements to an allowed position. It has no impact on the output.
152 lines
4.9 KiB
Plaintext
152 lines
4.9 KiB
Plaintext
<!--
|
|
doc/src/sgml/ref/create_materialized_view.sgml
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="SQL-CREATEMATERIALIZEDVIEW">
|
|
<indexterm zone="sql-creatematerializedview">
|
|
<primary>CREATE MATERIALIZED VIEW</primary>
|
|
</indexterm>
|
|
|
|
<refmeta>
|
|
<refentrytitle>CREATE MATERIALIZED VIEW</refentrytitle>
|
|
<manvolnum>7</manvolnum>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>CREATE MATERIALIZED VIEW</refname>
|
|
<refpurpose>define a new materialized view</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<synopsis>
|
|
CREATE MATERIALIZED VIEW <replaceable>table_name</replaceable>
|
|
[ (<replaceable>column_name</replaceable> [, ...] ) ]
|
|
[ WITH ( <replaceable class="PARAMETER">storage_parameter</replaceable> [= <replaceable class="PARAMETER">value</replaceable>] [, ... ] ) ]
|
|
[ TABLESPACE <replaceable class="PARAMETER">tablespace_name</replaceable> ]
|
|
AS <replaceable>query</replaceable>
|
|
[ WITH [ NO ] DATA ]
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>
|
|
<command>CREATE MATERIALIZED VIEW</command> defines a materialized view of
|
|
a query. The query is executed and used to populate the view at the time
|
|
the command is issued (unless <command>WITH NO DATA</> is used) and may be
|
|
refreshed later using <command>REFRESH MATERIALIZED VIEW</command>.
|
|
</para>
|
|
|
|
<para>
|
|
<command>CREATE MATERIALIZED VIEW</command> is similar to
|
|
<command>CREATE TABLE AS</>, except that it also remembers the query used
|
|
to initialize the view, so that it can be refreshed later upon demand.
|
|
A materialized view has many of the same properties as a table, but there
|
|
is no support for temporary materialized views or automatic generation of
|
|
OIDs.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Parameters</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><replaceable>table_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name (optionally schema-qualified) of the materialized view to be
|
|
created.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable>column_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name of a column in the new materialized view. If column names are
|
|
not provided, they are taken from the output column names of the query.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><literal>WITH ( <replaceable class="PARAMETER">storage_parameter</replaceable> [= <replaceable class="PARAMETER">value</replaceable>] [, ... ] )</literal></term>
|
|
<listitem>
|
|
<para>
|
|
This clause specifies optional storage parameters for the new
|
|
materialized view; see <xref linkend="sql-createtable-storage-parameters"
|
|
endterm="sql-createtable-storage-parameters-title"> for more
|
|
information. All parameters supported for <literal>CREATE
|
|
TABLE</literal> are also supported for <literal>CREATE MATERIALIZED
|
|
VIEW</literal> with the exception of <literal>OIDS</literal>.
|
|
See <xref linkend="sql-createtable"> for more information.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><literal>TABLESPACE <replaceable class="PARAMETER">tablespace_name</replaceable></literal></term>
|
|
<listitem>
|
|
<para>
|
|
The <replaceable class="PARAMETER">tablespace_name</replaceable> is the name
|
|
of the tablespace in which the new materialized view is to be created.
|
|
If not specified, <xref linkend="guc-default-tablespace"> is consulted.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable>query</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
A <xref linkend="sql-select">, <link linkend="sql-table">TABLE</link>,
|
|
or <xref linkend="sql-values"> command. This query will run within a
|
|
security-restricted operation; in particular, calls to functions that
|
|
themselves create temporary tables will fail.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><literal>WITH [ NO ] DATA</></term>
|
|
<listitem>
|
|
<para>
|
|
This clause specifies whether or not the materialized view should be
|
|
populated at creation time. If not, the materialized view will be
|
|
flagged as unscannable and cannot be queried until <command>REFRESH
|
|
MATERIALIZED VIEW</> is used.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Compatibility</title>
|
|
|
|
<para>
|
|
<command>CREATE MATERIALIZED VIEW</command> is a
|
|
<productname>PostgreSQL</productname> extension.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
|
|
<simplelist type="inline">
|
|
<member><xref linkend="sql-altermaterializedview"></member>
|
|
<member><xref linkend="sql-createtableas"></member>
|
|
<member><xref linkend="sql-createview"></member>
|
|
<member><xref linkend="sql-dropmaterializedview"></member>
|
|
<member><xref linkend="sql-refreshmaterializedview"></member>
|
|
</simplelist>
|
|
</refsect1>
|
|
|
|
</refentry>
|