← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/src/sgml/man7/ALTER_OPERATOR.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/ALTER_OPERATOR.7
 
1
'\" t
 
2
.\"     Title: ALTER OPERATOR
 
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 "ALTER OPERATOR" "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
ALTER_OPERATOR \- change the definition of an operator
 
23
.\" ALTER OPERATOR
 
24
.SH "SYNOPSIS"
 
25
.sp
 
26
.nf
 
27
ALTER OPERATOR \fIname\fR ( { \fIleft_type\fR | NONE } , { \fIright_type\fR | NONE } ) OWNER TO \fInew_owner\fR
 
28
ALTER OPERATOR \fIname\fR ( { \fIleft_type\fR | NONE } , { \fIright_type\fR | NONE } ) SET SCHEMA \fInew_schema\fR
 
29
.fi
 
30
.SH "DESCRIPTION"
 
31
.PP
 
32
ALTER OPERATOR
 
33
changes the definition of an operator\&. The only currently available functionality is to change the owner of the operator\&.
 
34
.PP
 
35
You must own the operator to use
 
36
ALTER OPERATOR\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
 
37
CREATE
 
38
privilege on the operator\(aqs schema\&. (These restrictions enforce that altering the owner doesn\(aqt do anything you couldn\(aqt do by dropping and recreating the operator\&. However, a superuser can alter ownership of any operator anyway\&.)
 
39
.SH "PARAMETERS"
 
40
.PP
 
41
\fIname\fR
 
42
.RS 4
 
43
The name (optionally schema\-qualified) of an existing operator\&.
 
44
.RE
 
45
.PP
 
46
\fIleft_type\fR
 
47
.RS 4
 
48
The data type of the operator\(aqs left operand; write
 
49
NONE
 
50
if the operator has no left operand\&.
 
51
.RE
 
52
.PP
 
53
\fIright_type\fR
 
54
.RS 4
 
55
The data type of the operator\(aqs right operand; write
 
56
NONE
 
57
if the operator has no right operand\&.
 
58
.RE
 
59
.PP
 
60
\fInew_owner\fR
 
61
.RS 4
 
62
The new owner of the operator\&.
 
63
.RE
 
64
.PP
 
65
\fInew_schema\fR
 
66
.RS 4
 
67
The new schema for the operator\&.
 
68
.RE
 
69
.SH "EXAMPLES"
 
70
.PP
 
71
Change the owner of a custom operator
 
72
a @@ b
 
73
for type
 
74
text:
 
75
.sp
 
76
.if n \{\
 
77
.RS 4
 
78
.\}
 
79
.nf
 
80
ALTER OPERATOR @@ (text, text) OWNER TO joe;
 
81
.fi
 
82
.if n \{\
 
83
.RE
 
84
.\}
 
85
.SH "COMPATIBILITY"
 
86
.PP
 
87
There is no
 
88
ALTER OPERATOR
 
89
statement in the SQL standard\&.
 
90
.SH "SEE ALSO"
 
91
CREATE OPERATOR (\fBCREATE_OPERATOR\fR(7)), DROP OPERATOR (\fBDROP_OPERATOR\fR(7))