← 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/ALTER_COLLATION.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_COLLATION.7
 
1
'\" t
 
2
.\"     Title: ALTER COLLATION
 
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 COLLATION" "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_COLLATION \- change the definition of a collation
 
23
.\" ALTER COLLATION
 
24
.SH "SYNOPSIS"
 
25
.sp
 
26
.nf
 
27
ALTER COLLATION \fIname\fR RENAME TO \fInew_name\fR
 
28
ALTER COLLATION \fIname\fR OWNER TO \fInew_owner\fR
 
29
ALTER COLLATION \fIname\fR SET SCHEMA \fInew_schema\fR
 
30
.fi
 
31
.SH "DESCRIPTION"
 
32
.PP
 
33
ALTER COLLATION
 
34
changes the definition of a collation\&.
 
35
.PP
 
36
You must own the collation to use
 
37
ALTER COLLATION\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
 
38
CREATE
 
39
privilege on the collation\(aqs schema\&. (These restrictions enforce that altering the owner doesn\(aqt do anything you couldn\(aqt do by dropping and recreating the collation\&. However, a superuser can alter ownership of any collation anyway\&.)
 
40
.SH "PARAMETERS"
 
41
.PP
 
42
\fIname\fR
 
43
.RS 4
 
44
The name (optionally schema\-qualified) of an existing collation\&.
 
45
.RE
 
46
.PP
 
47
\fInew_name\fR
 
48
.RS 4
 
49
The new name of the collation\&.
 
50
.RE
 
51
.PP
 
52
\fInew_owner\fR
 
53
.RS 4
 
54
The new owner of the collation\&.
 
55
.RE
 
56
.PP
 
57
\fInew_schema\fR
 
58
.RS 4
 
59
The new schema for the collation\&.
 
60
.RE
 
61
.SH "EXAMPLES"
 
62
.PP
 
63
To rename the collation
 
64
de_DE
 
65
to
 
66
german:
 
67
.sp
 
68
.if n \{\
 
69
.RS 4
 
70
.\}
 
71
.nf
 
72
ALTER COLLATION "de_DE" RENAME TO german;
 
73
.fi
 
74
.if n \{\
 
75
.RE
 
76
.\}
 
77
.PP
 
78
To change the owner of the collation
 
79
en_US
 
80
to
 
81
joe:
 
82
.sp
 
83
.if n \{\
 
84
.RS 4
 
85
.\}
 
86
.nf
 
87
ALTER COLLATION "en_US" OWNER TO joe;
 
88
.fi
 
89
.if n \{\
 
90
.RE
 
91
.\}
 
92
.SH "COMPATIBILITY"
 
93
.PP
 
94
There is no
 
95
ALTER COLLATION
 
96
statement in the SQL standard\&.
 
97
.SH "SEE ALSO"
 
98
CREATE COLLATION (\fBCREATE_COLLATION\fR(7)), DROP COLLATION (\fBDROP_COLLATION\fR(7))