begriffs open source - ai-pg/blob - full-docs/man7/DROP_VIEW.7

   1 '\" t
   2 .\"     Title: DROP VIEW
   3 .\"    Author: The PostgreSQL Global Development Group
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 2025
   6 .\"    Manual: PostgreSQL 18.0 Documentation
   7 .\"    Source: PostgreSQL 18.0
   8 .\"  Language: English
   9 .\"
  10 .TH "DROP VIEW" "7" "2025" "PostgreSQL 18.0" "PostgreSQL 18.0 Documentation"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 DROP_VIEW \- remove a view
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 DROP VIEW [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
  36 .fi
  37 .SH "DESCRIPTION"
  38 .PP
  39 \fBDROP VIEW\fR
  40 drops an existing view\&. To execute this command you must be the owner of the view\&.
  41 .SH "PARAMETERS"
  42 .PP
  43 IF EXISTS
  44 .RS 4
  45 Do not throw an error if the view does not exist\&. A notice is issued in this case\&.
  46 .RE
  47 .PP
  48 \fIname\fR
  49 .RS 4
  50 The name (optionally schema\-qualified) of the view to remove\&.
  51 .RE
  52 .PP
  53 CASCADE
  54 .RS 4
  55 Automatically drop objects that depend on the view (such as other views), and in turn all objects that depend on those objects (see
  56 Section\ \&5.15)\&.
  57 .RE
  58 .PP
  59 RESTRICT
  60 .RS 4
  61 Refuse to drop the view if any objects depend on it\&. This is the default\&.
  62 .RE
  63 .SH "EXAMPLES"
  64 .PP
  65 This command will remove the view called
  66 kinds:
  67 .sp
  68 .if n \{\
  69 .RS 4
  70 .\}
  71 .nf
  72 DROP VIEW kinds;
  73 .fi
  74 .if n \{\
  75 .RE
  76 .\}
  77 .SH "COMPATIBILITY"
  78 .PP
  79 This command conforms to the SQL standard, except that the standard only allows one view to be dropped per command, and apart from the
  80 IF EXISTS
  81 option, which is a
  82 PostgreSQL
  83 extension\&.
  84 .SH "SEE ALSO"
  85 ALTER VIEW (\fBALTER_VIEW\fR(7)), CREATE VIEW (\fBCREATE_VIEW\fR(7))