~ubuntu-branches/ubuntu/oneiric/postgresql-9.1/oneiric-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/man7/DROP_SERVER.7

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2011-05-11 10:41:53 UTC
  • Revision ID: james.westby@ubuntu.com-20110511104153-psbh2o58553fv1m0
Tags: upstream-9.1~beta1
ImportĀ upstreamĀ versionĀ 9.1~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
'\" t
 
2
.\"     Title: DROP SERVER
 
3
.\"    Author: The PostgreSQL Global Development Group
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
 
5
.\"      Date: 2011-04-27
 
6
.\"    Manual: PostgreSQL 9.1beta1 Documentation
 
7
.\"    Source: PostgreSQL 9.1beta1
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "DROP SERVER" "7" "2011-04-27" "PostgreSQL 9.1beta1" "PostgreSQL 9.1beta1 Documentation"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * set default formatting
 
13
.\" -----------------------------------------------------------------
 
14
.\" disable hyphenation
 
15
.nh
 
16
.\" disable justification (adjust text to left margin only)
 
17
.ad l
 
18
.\" -----------------------------------------------------------------
 
19
.\" * MAIN CONTENT STARTS HERE *
 
20
.\" -----------------------------------------------------------------
 
21
.SH "NAME"
 
22
DROP_SERVER \- remove a foreign server descriptor
 
23
.\" DROP SERVER
 
24
.SH "SYNOPSIS"
 
25
.sp
 
26
.nf
 
27
DROP SERVER [ IF EXISTS ] \fIserver_name\fR [ CASCADE | RESTRICT ]
 
28
.fi
 
29
.SH "DESCRIPTION"
 
30
.PP
 
31
DROP SERVER
 
32
removes an existing foreign server descriptor\&. To execute this command, the current user must be the owner of the server\&.
 
33
.SH "PARAMETERS"
 
34
.PP
 
35
IF EXISTS
 
36
.RS 4
 
37
Do not throw an error if the server does not exist\&. A notice is issued in this case\&.
 
38
.RE
 
39
.PP
 
40
\fIserver_name\fR
 
41
.RS 4
 
42
The name of an existing server\&.
 
43
.RE
 
44
.PP
 
45
CASCADE
 
46
.RS 4
 
47
Automatically drop objects that depend on the server (such as user mappings)\&.
 
48
.RE
 
49
.PP
 
50
RESTRICT
 
51
.RS 4
 
52
Refuse to drop the server if any objects depend on it\&. This is the default\&.
 
53
.RE
 
54
.SH "EXAMPLES"
 
55
.PP
 
56
Drop a server
 
57
foo
 
58
if it exists:
 
59
.sp
 
60
.if n \{\
 
61
.RS 4
 
62
.\}
 
63
.nf
 
64
DROP SERVER IF EXISTS foo;
 
65
.fi
 
66
.if n \{\
 
67
.RE
 
68
.\}
 
69
.SH "COMPATIBILITY"
 
70
.PP
 
71
DROP SERVER
 
72
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. The
 
73
IF EXISTS
 
74
clause is a
 
75
PostgreSQL
 
76
extension\&.
 
77
.SH "SEE ALSO"
 
78
CREATE SERVER (\fBCREATE_SERVER\fR(7)), ALTER SERVER (\fBALTER_SERVER\fR(7))