mirror of
https://github.com/postgres/postgres.git
synced 2025-12-21 05:21:08 +03:00
9ace03183c
as well allow DROP multiple INDEX, RULE, TYPE as well. Add missing CommandCounterIncrement to DROP loop, which could cause trouble otherwise with multiple DROP of items affecting same catalog entries. Try to bring a little consistency to various error messages using 'does not exist', 'nonexistent', etc --- I standardized on 'does not exist' since that's what the vast majority of the existing uses seem to be.
211 lines
4.3 KiB
Plaintext
211 lines
4.3 KiB
Plaintext
<!--
|
|
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_view.sgml,v 1.8 2000/10/22 23:32:38 tgl Exp $
|
|
Postgres documentation
|
|
-->
|
|
|
|
<refentry id="SQL-DROPVIEW">
|
|
<refmeta>
|
|
<refentrytitle id="SQL-DROPVIEW-TITLE">
|
|
DROP VIEW
|
|
</refentrytitle>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>
|
|
DROP VIEW
|
|
</refname>
|
|
<refpurpose>
|
|
Removes existing views from a database
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<refsynopsisdivinfo>
|
|
<date>1999-07-20</date>
|
|
</refsynopsisdivinfo>
|
|
<synopsis>
|
|
DROP VIEW <replaceable class="PARAMETER">name</replaceable> [, ...]
|
|
</synopsis>
|
|
|
|
<refsect2 id="R2-SQL-DROPVIEW-1">
|
|
<refsect2info>
|
|
<date>1998-09-22</date>
|
|
</refsect2info>
|
|
<title>
|
|
Inputs
|
|
</title>
|
|
<para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><replaceable class="PARAMETER">name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name of an existing view.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect2>
|
|
|
|
<refsect2 id="R2-SQL-DROPVIEW-2">
|
|
<refsect2info>
|
|
<date>1998-09-22</date>
|
|
</refsect2info>
|
|
<title>
|
|
Outputs
|
|
</title>
|
|
<para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><computeroutput>
|
|
DROP
|
|
</computeroutput></term>
|
|
<listitem>
|
|
<para>
|
|
The message returned if the command is successful.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><computeroutput>
|
|
ERROR: view <replaceable class="parameter">name</replaceable> does not exist
|
|
</computeroutput></term>
|
|
<listitem>
|
|
<para>
|
|
This message occurs if the specified view does not exist in
|
|
the database.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect2>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1 id="R1-SQL-DROPVIEW-1">
|
|
<refsect1info>
|
|
<date>1998-09-22</date>
|
|
</refsect1info>
|
|
<title>
|
|
Description
|
|
</title>
|
|
<para>
|
|
<command>DROP VIEW</command> drops an existing view from the database.
|
|
To execute this command you must be the owner of the
|
|
view.
|
|
</para>
|
|
|
|
<refsect2 id="R2-SQL-DROPVIEW-3">
|
|
<refsect2info>
|
|
<date>1998-09-22</date>
|
|
</refsect2info>
|
|
<title>
|
|
Notes
|
|
</title>
|
|
<para>
|
|
Refer to <command>CREATE VIEW</command>
|
|
for information on how to create views.
|
|
</para>
|
|
</refsect2>
|
|
</refsect1>
|
|
|
|
<refsect1 id="R1-SQL-DROPVIEW-2">
|
|
<title>
|
|
Usage
|
|
</title>
|
|
<para>
|
|
This command will remove the view called <literal>kinds</literal>:
|
|
</para>
|
|
<programlisting>
|
|
DROP VIEW kinds;
|
|
</programlisting>
|
|
</refsect1>
|
|
|
|
<refsect1 id="R1-SQL-DROPVIEW-3">
|
|
<title>
|
|
Compatibility
|
|
</title>
|
|
|
|
<refsect2 id="R2-SQL-DROPVIEW-4">
|
|
<refsect2info>
|
|
<date>1998-09-22</date>
|
|
</refsect2info>
|
|
<title>
|
|
SQL92
|
|
</title>
|
|
<para>
|
|
<acronym>SQL92</acronym> specifies some additional capabilities for
|
|
<command>DROP VIEW</command>:
|
|
|
|
<synopsis>
|
|
DROP VIEW <replaceable class="parameter">view</replaceable> { RESTRICT | CASCADE }
|
|
</synopsis>
|
|
</para>
|
|
|
|
<refsect3 id="R3-SQL-DROPVIEW-1">
|
|
<refsect3info>
|
|
<date>1998-09-22</date>
|
|
</refsect3info>
|
|
<title>
|
|
Inputs
|
|
</title>
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>RESTRICT</term>
|
|
<listitem>
|
|
<para>
|
|
Ensures that only a view with no dependent views or
|
|
integrity constraints can be destroyed.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>CASCADE</term>
|
|
<listitem>
|
|
<para>
|
|
Any referencing views and integrity constraints
|
|
will be dropped as well.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect3>
|
|
|
|
<refsect3 id="R3-SQL-DROPVIEW-2">
|
|
<refsect3info>
|
|
<date>1998-09-22</date>
|
|
</refsect3info>
|
|
<title>
|
|
Notes
|
|
</title>
|
|
<para>
|
|
At present, to remove a referenced view from a
|
|
<productname>Postgres</productname> database,
|
|
you must drop it explicitly.
|
|
</para>
|
|
</refsect3>
|
|
</refsect2>
|
|
</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:
|
|
-->
|