← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/src/sgml/man7/DROP_OPERATOR_CLASS.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:
doc/src/sgml/man7/DROP_OPERATOR_CLASS.7
 
1
'\" t
 
2
.\"     Title: DROP OPERATOR CLASS
 
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 OPERATOR CLASS" "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_OPERATOR_CLASS \- remove an operator class
 
23
.\" DROP OPERATOR CLASS
 
24
.SH "SYNOPSIS"
 
25
.sp
 
26
.nf
 
27
DROP OPERATOR CLASS [ IF EXISTS ] \fIname\fR USING \fIindex_method\fR [ CASCADE | RESTRICT ]
 
28
.fi
 
29
.SH "DESCRIPTION"
 
30
.PP
 
31
DROP OPERATOR CLASS
 
32
drops an existing operator class\&. To execute this command you must be the owner of the operator class\&.
 
33
.PP
 
34
DROP OPERATOR CLASS
 
35
does not drop any of the operators or functions referenced by the class\&. If there are any indexes depending on the operator class, you will need to specify
 
36
CASCADE
 
37
for the drop to complete\&.
 
38
.SH "PARAMETERS"
 
39
.PP
 
40
IF EXISTS
 
41
.RS 4
 
42
Do not throw an error if the operator class does not exist\&. A notice is issued in this case\&.
 
43
.RE
 
44
.PP
 
45
\fIname\fR
 
46
.RS 4
 
47
The name (optionally schema\-qualified) of an existing operator class\&.
 
48
.RE
 
49
.PP
 
50
\fIindex_method\fR
 
51
.RS 4
 
52
The name of the index access method the operator class is for\&.
 
53
.RE
 
54
.PP
 
55
CASCADE
 
56
.RS 4
 
57
Automatically drop objects that depend on the operator class\&.
 
58
.RE
 
59
.PP
 
60
RESTRICT
 
61
.RS 4
 
62
Refuse to drop the operator class if any objects depend on it\&. This is the default\&.
 
63
.RE
 
64
.SH "NOTES"
 
65
.PP
 
66
DROP OPERATOR CLASS
 
67
will not drop the operator family containing the class, even if there is nothing else left in the family (in particular, in the case where the family was implicitly created by
 
68
CREATE OPERATOR CLASS)\&. An empty operator family is harmless, but for the sake of tidiness you might wish to remove the family with
 
69
DROP OPERATOR FAMILY; or perhaps better, use
 
70
DROP OPERATOR FAMILY
 
71
in the first place\&.
 
72
.SH "EXAMPLES"
 
73
.PP
 
74
Remove the B\-tree operator class
 
75
widget_ops:
 
76
.sp
 
77
.if n \{\
 
78
.RS 4
 
79
.\}
 
80
.nf
 
81
DROP OPERATOR CLASS widget_ops USING btree;
 
82
.fi
 
83
.if n \{\
 
84
.RE
 
85
.\}
 
86
.sp
 
87
This command will not succeed if there are any existing indexes that use the operator class\&. Add
 
88
CASCADE
 
89
to drop such indexes along with the operator class\&.
 
90
.SH "COMPATIBILITY"
 
91
.PP
 
92
There is no
 
93
DROP OPERATOR CLASS
 
94
statement in the SQL standard\&.
 
95
.SH "SEE ALSO"
 
96
ALTER OPERATOR CLASS (\fBALTER_OPERATOR_CLASS\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), DROP OPERATOR FAMILY (\fBDROP_OPERATOR_FAMILY\fR(7))