← 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/html/sql-altergroup.html

  • 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/html/sql-altergroup.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>ALTER GROUP</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 
9
REV="MADE"
 
10
HREF="mailto:pgsql-docs@postgresql.org"><LINK
 
11
REL="HOME"
 
12
TITLE="PostgreSQL 9.1beta1 Documentation"
 
13
HREF="index.html"><LINK
 
14
REL="UP"
 
15
TITLE="SQL Commands"
 
16
HREF="sql-commands.html"><LINK
 
17
REL="PREVIOUS"
 
18
TITLE="ALTER FUNCTION"
 
19
HREF="sql-alterfunction.html"><LINK
 
20
REL="NEXT"
 
21
TITLE="ALTER INDEX"
 
22
HREF="sql-alterindex.html"><LINK
 
23
REL="STYLESHEET"
 
24
TYPE="text/css"
 
25
HREF="stylesheet.css"><META
 
26
HTTP-EQUIV="Content-Type"
 
27
CONTENT="text/html; charset=ISO-8859-1"><META
 
28
NAME="creation"
 
29
CONTENT="2011-04-27T21:20:33"></HEAD
 
30
><BODY
 
31
CLASS="REFENTRY"
 
32
><DIV
 
33
CLASS="NAVHEADER"
 
34
><TABLE
 
35
SUMMARY="Header navigation table"
 
36
WIDTH="100%"
 
37
BORDER="0"
 
38
CELLPADDING="0"
 
39
CELLSPACING="0"
 
40
><TR
 
41
><TH
 
42
COLSPAN="5"
 
43
ALIGN="center"
 
44
VALIGN="bottom"
 
45
><A
 
46
HREF="index.html"
 
47
>PostgreSQL 9.1beta1 Documentation</A
 
48
></TH
 
49
></TR
 
50
><TR
 
51
><TD
 
52
WIDTH="10%"
 
53
ALIGN="left"
 
54
VALIGN="top"
 
55
><A
 
56
TITLE="ALTER FUNCTION"
 
57
HREF="sql-alterfunction.html"
 
58
ACCESSKEY="P"
 
59
>Prev</A
 
60
></TD
 
61
><TD
 
62
WIDTH="10%"
 
63
ALIGN="left"
 
64
VALIGN="top"
 
65
><A
 
66
TITLE="ALTER FUNCTION"
 
67
HREF="sql-alterfunction.html"
 
68
>Fast Backward</A
 
69
></TD
 
70
><TD
 
71
WIDTH="60%"
 
72
ALIGN="center"
 
73
VALIGN="bottom"
 
74
></TD
 
75
><TD
 
76
WIDTH="10%"
 
77
ALIGN="right"
 
78
VALIGN="top"
 
79
><A
 
80
TITLE="ALTER INDEX"
 
81
HREF="sql-alterindex.html"
 
82
>Fast Forward</A
 
83
></TD
 
84
><TD
 
85
WIDTH="10%"
 
86
ALIGN="right"
 
87
VALIGN="top"
 
88
><A
 
89
TITLE="ALTER INDEX"
 
90
HREF="sql-alterindex.html"
 
91
ACCESSKEY="N"
 
92
>Next</A
 
93
></TD
 
94
></TR
 
95
></TABLE
 
96
><HR
 
97
ALIGN="LEFT"
 
98
WIDTH="100%"></DIV
 
99
><H1
 
100
><A
 
101
NAME="SQL-ALTERGROUP"
 
102
></A
 
103
>ALTER GROUP</H1
 
104
><DIV
 
105
CLASS="REFNAMEDIV"
 
106
><A
 
107
NAME="AEN60547"
 
108
></A
 
109
><H2
 
110
>Name</H2
 
111
>ALTER GROUP&nbsp;--&nbsp;change role name or membership</DIV
 
112
><DIV
 
113
CLASS="REFSYNOPSISDIV"
 
114
><A
 
115
NAME="AEN60552"
 
116
></A
 
117
><H2
 
118
>Synopsis</H2
 
119
><PRE
 
120
CLASS="SYNOPSIS"
 
121
>ALTER GROUP <TT
 
122
CLASS="REPLACEABLE"
 
123
><I
 
124
>group_name</I
 
125
></TT
 
126
> ADD USER <TT
 
127
CLASS="REPLACEABLE"
 
128
><I
 
129
>user_name</I
 
130
></TT
 
131
> [, ... ]
 
132
ALTER GROUP <TT
 
133
CLASS="REPLACEABLE"
 
134
><I
 
135
>group_name</I
 
136
></TT
 
137
> DROP USER <TT
 
138
CLASS="REPLACEABLE"
 
139
><I
 
140
>user_name</I
 
141
></TT
 
142
> [, ... ]
 
143
 
 
144
ALTER GROUP <TT
 
145
CLASS="REPLACEABLE"
 
146
><I
 
147
>group_name</I
 
148
></TT
 
149
> RENAME TO <TT
 
150
CLASS="REPLACEABLE"
 
151
><I
 
152
>new_name</I
 
153
></TT
 
154
></PRE
 
155
></DIV
 
156
><DIV
 
157
CLASS="REFSECT1"
 
158
><A
 
159
NAME="AEN60560"
 
160
></A
 
161
><H2
 
162
>Description</H2
 
163
><P
 
164
>   <TT
 
165
CLASS="COMMAND"
 
166
>ALTER GROUP</TT
 
167
> changes the attributes of a user group.
 
168
   This is an obsolete command, though still accepted for backwards
 
169
   compatibility, because groups (and users too) have been superseded by the
 
170
   more general concept of roles.
 
171
  </P
 
172
><P
 
173
>   The first two variants add users to a group or remove them from a group.
 
174
   (Any role can play the part of either a <SPAN
 
175
CLASS="QUOTE"
 
176
>"user"</SPAN
 
177
> or a
 
178
   <SPAN
 
179
CLASS="QUOTE"
 
180
>"group"</SPAN
 
181
> for this purpose.)  These variants are effectively
 
182
   equivalent to granting or revoking membership in the role named as the
 
183
   <SPAN
 
184
CLASS="QUOTE"
 
185
>"group"</SPAN
 
186
>; so the preferred way to do this is to use
 
187
   <A
 
188
HREF="sql-grant.html"
 
189
>GRANT</A
 
190
> or
 
191
   <A
 
192
HREF="sql-revoke.html"
 
193
>REVOKE</A
 
194
>.
 
195
  </P
 
196
><P
 
197
>   The third variant changes the name of the group.  This is exactly
 
198
   equivalent to renaming the role with
 
199
   <A
 
200
HREF="sql-alterrole.html"
 
201
>ALTER ROLE</A
 
202
>.
 
203
  </P
 
204
></DIV
 
205
><DIV
 
206
CLASS="REFSECT1"
 
207
><A
 
208
NAME="AEN60572"
 
209
></A
 
210
><H2
 
211
>Parameters</H2
 
212
><P
 
213
></P
 
214
><DIV
 
215
CLASS="VARIABLELIST"
 
216
><DL
 
217
><DT
 
218
><TT
 
219
CLASS="REPLACEABLE"
 
220
><I
 
221
>group_name</I
 
222
></TT
 
223
></DT
 
224
><DD
 
225
><P
 
226
>      The name of the group (role) to modify.
 
227
     </P
 
228
></DD
 
229
><DT
 
230
><TT
 
231
CLASS="REPLACEABLE"
 
232
><I
 
233
>user_name</I
 
234
></TT
 
235
></DT
 
236
><DD
 
237
><P
 
238
>      Users (roles) that are to be added to or removed from the group.
 
239
      The users must already exist; <TT
 
240
CLASS="COMMAND"
 
241
>ALTER GROUP</TT
 
242
> does not
 
243
      create or drop users.
 
244
     </P
 
245
></DD
 
246
><DT
 
247
><TT
 
248
CLASS="REPLACEABLE"
 
249
><I
 
250
>new_name</I
 
251
></TT
 
252
></DT
 
253
><DD
 
254
><P
 
255
>      The new name of the group.
 
256
     </P
 
257
></DD
 
258
></DL
 
259
></DIV
 
260
></DIV
 
261
><DIV
 
262
CLASS="REFSECT1"
 
263
><A
 
264
NAME="AEN60591"
 
265
></A
 
266
><H2
 
267
>Examples</H2
 
268
><P
 
269
>   Add users to a group:
 
270
 
 
271
</P><PRE
 
272
CLASS="PROGRAMLISTING"
 
273
>ALTER GROUP staff ADD USER karl, john;</PRE
 
274
><P>
 
275
 
 
276
   Remove a user from a group:
 
277
 
 
278
</P><PRE
 
279
CLASS="PROGRAMLISTING"
 
280
>ALTER GROUP workers DROP USER beth;</PRE
 
281
><P>
 
282
 
 
283
  </P
 
284
></DIV
 
285
><DIV
 
286
CLASS="REFSECT1"
 
287
><A
 
288
NAME="AEN60596"
 
289
></A
 
290
><H2
 
291
>Compatibility</H2
 
292
><P
 
293
>   There is no <TT
 
294
CLASS="COMMAND"
 
295
>ALTER GROUP</TT
 
296
> statement in the SQL
 
297
   standard.
 
298
  </P
 
299
></DIV
 
300
><DIV
 
301
CLASS="REFSECT1"
 
302
><A
 
303
NAME="AEN60600"
 
304
></A
 
305
><H2
 
306
>See Also</H2
 
307
><A
 
308
HREF="sql-grant.html"
 
309
>GRANT</A
 
310
>, <A
 
311
HREF="sql-revoke.html"
 
312
>REVOKE</A
 
313
>, <A
 
314
HREF="sql-alterrole.html"
 
315
>ALTER ROLE</A
 
316
></DIV
 
317
><DIV
 
318
CLASS="NAVFOOTER"
 
319
><HR
 
320
ALIGN="LEFT"
 
321
WIDTH="100%"><TABLE
 
322
SUMMARY="Footer navigation table"
 
323
WIDTH="100%"
 
324
BORDER="0"
 
325
CELLPADDING="0"
 
326
CELLSPACING="0"
 
327
><TR
 
328
><TD
 
329
WIDTH="33%"
 
330
ALIGN="left"
 
331
VALIGN="top"
 
332
><A
 
333
HREF="sql-alterfunction.html"
 
334
ACCESSKEY="P"
 
335
>Prev</A
 
336
></TD
 
337
><TD
 
338
WIDTH="34%"
 
339
ALIGN="center"
 
340
VALIGN="top"
 
341
><A
 
342
HREF="index.html"
 
343
ACCESSKEY="H"
 
344
>Home</A
 
345
></TD
 
346
><TD
 
347
WIDTH="33%"
 
348
ALIGN="right"
 
349
VALIGN="top"
 
350
><A
 
351
HREF="sql-alterindex.html"
 
352
ACCESSKEY="N"
 
353
>Next</A
 
354
></TD
 
355
></TR
 
356
><TR
 
357
><TD
 
358
WIDTH="33%"
 
359
ALIGN="left"
 
360
VALIGN="top"
 
361
>ALTER FUNCTION</TD
 
362
><TD
 
363
WIDTH="34%"
 
364
ALIGN="center"
 
365
VALIGN="top"
 
366
><A
 
367
HREF="sql-commands.html"
 
368
ACCESSKEY="U"
 
369
>Up</A
 
370
></TD
 
371
><TD
 
372
WIDTH="33%"
 
373
ALIGN="right"
 
374
VALIGN="top"
 
375
>ALTER INDEX</TD
 
376
></TR
 
377
></TABLE
 
378
></DIV
 
379
></BODY
 
380
></HTML
 
381
>
 
 
b'\\ No newline at end of file'