← 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/html/sql-alterextension.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-alterextension.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 EXTENSION</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 DOMAIN"
 
19
HREF="sql-alterdomain.html"><LINK
 
20
REL="NEXT"
 
21
TITLE="ALTER FOREIGN DATA WRAPPER"
 
22
HREF="sql-alterforeigndatawrapper.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 DOMAIN"
 
57
HREF="sql-alterdomain.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 DOMAIN"
 
67
HREF="sql-alterdomain.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 FOREIGN DATA WRAPPER"
 
81
HREF="sql-alterforeigndatawrapper.html"
 
82
>Fast Forward</A
 
83
></TD
 
84
><TD
 
85
WIDTH="10%"
 
86
ALIGN="right"
 
87
VALIGN="top"
 
88
><A
 
89
TITLE="ALTER FOREIGN DATA WRAPPER"
 
90
HREF="sql-alterforeigndatawrapper.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-ALTEREXTENSION"
 
102
></A
 
103
>ALTER EXTENSION</H1
 
104
><DIV
 
105
CLASS="REFNAMEDIV"
 
106
><A
 
107
NAME="AEN59899"
 
108
></A
 
109
><H2
 
110
>Name</H2
 
111
>ALTER EXTENSION&nbsp;--&nbsp;   change the definition of an extension
 
112
  </DIV
 
113
><DIV
 
114
CLASS="REFSYNOPSISDIV"
 
115
><A
 
116
NAME="AEN59904"
 
117
></A
 
118
><H2
 
119
>Synopsis</H2
 
120
><PRE
 
121
CLASS="SYNOPSIS"
 
122
>ALTER EXTENSION <TT
 
123
CLASS="REPLACEABLE"
 
124
><I
 
125
>extension_name</I
 
126
></TT
 
127
> UPDATE [ TO <TT
 
128
CLASS="REPLACEABLE"
 
129
><I
 
130
>new_version</I
 
131
></TT
 
132
> ]
 
133
ALTER EXTENSION <TT
 
134
CLASS="REPLACEABLE"
 
135
><I
 
136
>extension_name</I
 
137
></TT
 
138
> SET SCHEMA <TT
 
139
CLASS="REPLACEABLE"
 
140
><I
 
141
>new_schema</I
 
142
></TT
 
143
>
 
144
ALTER EXTENSION <TT
 
145
CLASS="REPLACEABLE"
 
146
><I
 
147
>extension_name</I
 
148
></TT
 
149
> ADD <TT
 
150
CLASS="REPLACEABLE"
 
151
><I
 
152
>member_object</I
 
153
></TT
 
154
>
 
155
ALTER EXTENSION <TT
 
156
CLASS="REPLACEABLE"
 
157
><I
 
158
>extension_name</I
 
159
></TT
 
160
> DROP <TT
 
161
CLASS="REPLACEABLE"
 
162
><I
 
163
>member_object</I
 
164
></TT
 
165
>
 
166
 
 
167
<SPAN
 
168
CLASS="phrase"
 
169
><SPAN
 
170
CLASS="PHRASE"
 
171
>where <TT
 
172
CLASS="REPLACEABLE"
 
173
><I
 
174
>member_object</I
 
175
></TT
 
176
> is:</SPAN
 
177
></SPAN
 
178
>
 
179
 
 
180
  AGGREGATE <TT
 
181
CLASS="REPLACEABLE"
 
182
><I
 
183
>agg_name</I
 
184
></TT
 
185
> (<TT
 
186
CLASS="REPLACEABLE"
 
187
><I
 
188
>agg_type</I
 
189
></TT
 
190
> [, ...] ) |
 
191
  CAST (<TT
 
192
CLASS="REPLACEABLE"
 
193
><I
 
194
>source_type</I
 
195
></TT
 
196
> AS <TT
 
197
CLASS="REPLACEABLE"
 
198
><I
 
199
>target_type</I
 
200
></TT
 
201
>) |
 
202
  COLLATION <TT
 
203
CLASS="REPLACEABLE"
 
204
><I
 
205
>object_name</I
 
206
></TT
 
207
> |
 
208
  CONVERSION <TT
 
209
CLASS="REPLACEABLE"
 
210
><I
 
211
>object_name</I
 
212
></TT
 
213
> |
 
214
  DOMAIN <TT
 
215
CLASS="REPLACEABLE"
 
216
><I
 
217
>object_name</I
 
218
></TT
 
219
> |
 
220
  FOREIGN DATA WRAPPER <TT
 
221
CLASS="REPLACEABLE"
 
222
><I
 
223
>object_name</I
 
224
></TT
 
225
> |
 
226
  FOREIGN TABLE <TT
 
227
CLASS="REPLACEABLE"
 
228
><I
 
229
>object_name</I
 
230
></TT
 
231
> |
 
232
  FUNCTION <TT
 
233
CLASS="REPLACEABLE"
 
234
><I
 
235
>function_name</I
 
236
></TT
 
237
> ( [ [ <TT
 
238
CLASS="REPLACEABLE"
 
239
><I
 
240
>argmode</I
 
241
></TT
 
242
> ] [ <TT
 
243
CLASS="REPLACEABLE"
 
244
><I
 
245
>argname</I
 
246
></TT
 
247
> ] <TT
 
248
CLASS="REPLACEABLE"
 
249
><I
 
250
>argtype</I
 
251
></TT
 
252
> [, ...] ] ) |
 
253
  OPERATOR <TT
 
254
CLASS="REPLACEABLE"
 
255
><I
 
256
>operator_name</I
 
257
></TT
 
258
> (<TT
 
259
CLASS="REPLACEABLE"
 
260
><I
 
261
>left_type</I
 
262
></TT
 
263
>, <TT
 
264
CLASS="REPLACEABLE"
 
265
><I
 
266
>right_type</I
 
267
></TT
 
268
>) |
 
269
  OPERATOR CLASS <TT
 
270
CLASS="REPLACEABLE"
 
271
><I
 
272
>object_name</I
 
273
></TT
 
274
> USING <TT
 
275
CLASS="REPLACEABLE"
 
276
><I
 
277
>index_method</I
 
278
></TT
 
279
> |
 
280
  OPERATOR FAMILY <TT
 
281
CLASS="REPLACEABLE"
 
282
><I
 
283
>object_name</I
 
284
></TT
 
285
> USING <TT
 
286
CLASS="REPLACEABLE"
 
287
><I
 
288
>index_method</I
 
289
></TT
 
290
> |
 
291
  [ PROCEDURAL ] LANGUAGE <TT
 
292
CLASS="REPLACEABLE"
 
293
><I
 
294
>object_name</I
 
295
></TT
 
296
> |
 
297
  SCHEMA <TT
 
298
CLASS="REPLACEABLE"
 
299
><I
 
300
>object_name</I
 
301
></TT
 
302
> |
 
303
  SEQUENCE <TT
 
304
CLASS="REPLACEABLE"
 
305
><I
 
306
>object_name</I
 
307
></TT
 
308
> |
 
309
  SERVER <TT
 
310
CLASS="REPLACEABLE"
 
311
><I
 
312
>object_name</I
 
313
></TT
 
314
> |
 
315
  TABLE <TT
 
316
CLASS="REPLACEABLE"
 
317
><I
 
318
>object_name</I
 
319
></TT
 
320
> |
 
321
  TEXT SEARCH CONFIGURATION <TT
 
322
CLASS="REPLACEABLE"
 
323
><I
 
324
>object_name</I
 
325
></TT
 
326
> |
 
327
  TEXT SEARCH DICTIONARY <TT
 
328
CLASS="REPLACEABLE"
 
329
><I
 
330
>object_name</I
 
331
></TT
 
332
> |
 
333
  TEXT SEARCH PARSER <TT
 
334
CLASS="REPLACEABLE"
 
335
><I
 
336
>object_name</I
 
337
></TT
 
338
> |
 
339
  TEXT SEARCH TEMPLATE <TT
 
340
CLASS="REPLACEABLE"
 
341
><I
 
342
>object_name</I
 
343
></TT
 
344
> |
 
345
  TYPE <TT
 
346
CLASS="REPLACEABLE"
 
347
><I
 
348
>object_name</I
 
349
></TT
 
350
> |
 
351
  VIEW <TT
 
352
CLASS="REPLACEABLE"
 
353
><I
 
354
>object_name</I
 
355
></TT
 
356
></PRE
 
357
></DIV
 
358
><DIV
 
359
CLASS="REFSECT1"
 
360
><A
 
361
NAME="AEN59947"
 
362
></A
 
363
><H2
 
364
>Description</H2
 
365
><P
 
366
>   <TT
 
367
CLASS="COMMAND"
 
368
>ALTER EXTENSION</TT
 
369
> changes the definition of an installed
 
370
   extension.  There are several subforms:
 
371
 
 
372
   <P
 
373
></P
 
374
></P><DIV
 
375
CLASS="VARIABLELIST"
 
376
><DL
 
377
><DT
 
378
><TT
 
379
CLASS="LITERAL"
 
380
>UPDATE</TT
 
381
></DT
 
382
><DD
 
383
><P
 
384
>      This form updates the extension to a newer version.  The extension
 
385
      must supply a suitable update script (or series of scripts) that can
 
386
      modify the currently-installed version into the requested version.
 
387
     </P
 
388
></DD
 
389
><DT
 
390
><TT
 
391
CLASS="LITERAL"
 
392
>SET SCHEMA</TT
 
393
></DT
 
394
><DD
 
395
><P
 
396
>      This form moves the extension's objects into another schema. The
 
397
      extension has to be <I
 
398
CLASS="FIRSTTERM"
 
399
>relocatable</I
 
400
> for this command to
 
401
      succeed.
 
402
     </P
 
403
></DD
 
404
><DT
 
405
><TT
 
406
CLASS="LITERAL"
 
407
>ADD <TT
 
408
CLASS="REPLACEABLE"
 
409
><I
 
410
>member_object</I
 
411
></TT
 
412
></TT
 
413
></DT
 
414
><DD
 
415
><P
 
416
>      This form adds an existing object to the extension.  This is mainly
 
417
      useful in extension update scripts.  The object will subsequently
 
418
      be treated as a member of the extension; notably, it can only be
 
419
      dropped by dropping the extension.
 
420
     </P
 
421
></DD
 
422
><DT
 
423
><TT
 
424
CLASS="LITERAL"
 
425
>DROP <TT
 
426
CLASS="REPLACEABLE"
 
427
><I
 
428
>member_object</I
 
429
></TT
 
430
></TT
 
431
></DT
 
432
><DD
 
433
><P
 
434
>      This form removes a member object from the extension.  This is mainly
 
435
      useful in extension update scripts.  The object is not dropped, only
 
436
      disassociated from the extension.
 
437
     </P
 
438
></DD
 
439
></DL
 
440
></DIV
 
441
><P>
 
442
 
 
443
   See <A
 
444
HREF="extend-extensions.html"
 
445
>Section 35.15</A
 
446
> for more information about these
 
447
   operations.
 
448
  </P
 
449
><P
 
450
>   You must own the extension to use <TT
 
451
CLASS="COMMAND"
 
452
>ALTER EXTENSION</TT
 
453
>.
 
454
   The <TT
 
455
CLASS="LITERAL"
 
456
>ADD</TT
 
457
>/<TT
 
458
CLASS="LITERAL"
 
459
>DROP</TT
 
460
> forms require ownership of the
 
461
   added/dropped object as well.
 
462
  </P
 
463
></DIV
 
464
><DIV
 
465
CLASS="REFSECT1"
 
466
><A
 
467
NAME="AEN59980"
 
468
></A
 
469
><H2
 
470
>Parameters</H2
 
471
><P
 
472
>   <P
 
473
></P
 
474
></P><DIV
 
475
CLASS="VARIABLELIST"
 
476
><DL
 
477
><DT
 
478
><TT
 
479
CLASS="REPLACEABLE"
 
480
><I
 
481
>extension_name</I
 
482
></TT
 
483
></DT
 
484
><DD
 
485
><P
 
486
>       The name of an installed extension.
 
487
      </P
 
488
></DD
 
489
><DT
 
490
><TT
 
491
CLASS="REPLACEABLE"
 
492
><I
 
493
>new_version</I
 
494
></TT
 
495
></DT
 
496
><DD
 
497
><P
 
498
>       The desired new version of the extension.  This can be written as
 
499
       either an identifier or a string literal.  If not specified,
 
500
       <TT
 
501
CLASS="COMMAND"
 
502
>ALTER EXTENSION UPDATE</TT
 
503
> attempts to update to whatever is
 
504
       shown as the default version in the extension's control file.
 
505
      </P
 
506
></DD
 
507
><DT
 
508
><TT
 
509
CLASS="REPLACEABLE"
 
510
><I
 
511
>new_schema</I
 
512
></TT
 
513
></DT
 
514
><DD
 
515
><P
 
516
>       The new schema for the extension.
 
517
      </P
 
518
></DD
 
519
><DT
 
520
><TT
 
521
CLASS="REPLACEABLE"
 
522
><I
 
523
>object_name</I
 
524
></TT
 
525
><BR><TT
 
526
CLASS="REPLACEABLE"
 
527
><I
 
528
>agg_name</I
 
529
></TT
 
530
><BR><TT
 
531
CLASS="REPLACEABLE"
 
532
><I
 
533
>function_name</I
 
534
></TT
 
535
><BR><TT
 
536
CLASS="REPLACEABLE"
 
537
><I
 
538
>operator_name</I
 
539
></TT
 
540
></DT
 
541
><DD
 
542
><P
 
543
>       The name of an object to be added to or removed from the extension.
 
544
       Names of tables,
 
545
       aggregates, domains, foreign tables, functions, operators,
 
546
       operator classes, operator families, sequences, text search objects,
 
547
       types, and views can be schema-qualified.
 
548
      </P
 
549
></DD
 
550
><DT
 
551
><TT
 
552
CLASS="REPLACEABLE"
 
553
><I
 
554
>agg_type</I
 
555
></TT
 
556
></DT
 
557
><DD
 
558
><P
 
559
>       An input data type on which the aggregate function operates.
 
560
       To reference a zero-argument aggregate function, write <TT
 
561
CLASS="LITERAL"
 
562
>*</TT
 
563
>
 
564
       in place of the list of input data types.
 
565
      </P
 
566
></DD
 
567
><DT
 
568
><TT
 
569
CLASS="REPLACEABLE"
 
570
><I
 
571
>source_type</I
 
572
></TT
 
573
></DT
 
574
><DD
 
575
><P
 
576
>       The name of the source data type of the cast.
 
577
      </P
 
578
></DD
 
579
><DT
 
580
><TT
 
581
CLASS="REPLACEABLE"
 
582
><I
 
583
>target_type</I
 
584
></TT
 
585
></DT
 
586
><DD
 
587
><P
 
588
>       The name of the target data type of the cast.
 
589
      </P
 
590
></DD
 
591
><DT
 
592
><TT
 
593
CLASS="REPLACEABLE"
 
594
><I
 
595
>argmode</I
 
596
></TT
 
597
></DT
 
598
><DD
 
599
><P
 
600
>       The mode of a function argument: <TT
 
601
CLASS="LITERAL"
 
602
>IN</TT
 
603
>, <TT
 
604
CLASS="LITERAL"
 
605
>OUT</TT
 
606
>,
 
607
       <TT
 
608
CLASS="LITERAL"
 
609
>INOUT</TT
 
610
>, or <TT
 
611
CLASS="LITERAL"
 
612
>VARIADIC</TT
 
613
>.
 
614
       If omitted, the default is <TT
 
615
CLASS="LITERAL"
 
616
>IN</TT
 
617
>.
 
618
       Note that <TT
 
619
CLASS="COMMAND"
 
620
>ALTER EXTENSION</TT
 
621
> does not actually pay
 
622
       any attention to <TT
 
623
CLASS="LITERAL"
 
624
>OUT</TT
 
625
> arguments, since only the input
 
626
       arguments are needed to determine the function's identity.
 
627
       So it is sufficient to list the <TT
 
628
CLASS="LITERAL"
 
629
>IN</TT
 
630
>, <TT
 
631
CLASS="LITERAL"
 
632
>INOUT</TT
 
633
>,
 
634
       and <TT
 
635
CLASS="LITERAL"
 
636
>VARIADIC</TT
 
637
> arguments.
 
638
      </P
 
639
></DD
 
640
><DT
 
641
><TT
 
642
CLASS="REPLACEABLE"
 
643
><I
 
644
>argname</I
 
645
></TT
 
646
></DT
 
647
><DD
 
648
><P
 
649
>       The name of a function argument.
 
650
       Note that <TT
 
651
CLASS="COMMAND"
 
652
>ALTER EXTENSION</TT
 
653
> does not actually pay
 
654
       any attention to argument names, since only the argument data
 
655
       types are needed to determine the function's identity.
 
656
      </P
 
657
></DD
 
658
><DT
 
659
><TT
 
660
CLASS="REPLACEABLE"
 
661
><I
 
662
>argtype</I
 
663
></TT
 
664
></DT
 
665
><DD
 
666
><P
 
667
>       The data type(s) of the function's arguments (optionally
 
668
       schema-qualified), if any.
 
669
      </P
 
670
></DD
 
671
><DT
 
672
><TT
 
673
CLASS="LITERAL"
 
674
>PROCEDURAL</TT
 
675
></DT
 
676
><DD
 
677
><P
 
678
>       This is a noise word.
 
679
      </P
 
680
></DD
 
681
></DL
 
682
></DIV
 
683
><P>
 
684
  </P
 
685
></DIV
 
686
><DIV
 
687
CLASS="REFSECT1"
 
688
><A
 
689
NAME="AEN60058"
 
690
></A
 
691
><H2
 
692
>Examples</H2
 
693
><P
 
694
>   To update the <TT
 
695
CLASS="LITERAL"
 
696
>hstore</TT
 
697
> extension to version 2.0:
 
698
</P><PRE
 
699
CLASS="PROGRAMLISTING"
 
700
>ALTER EXTENSION hstore UPDATE TO '2.0';</PRE
 
701
><P>
 
702
  </P
 
703
><P
 
704
>   To change the schema of the <TT
 
705
CLASS="LITERAL"
 
706
>hstore</TT
 
707
> extension
 
708
   to <TT
 
709
CLASS="LITERAL"
 
710
>utils</TT
 
711
>:
 
712
</P><PRE
 
713
CLASS="PROGRAMLISTING"
 
714
>ALTER EXTENSION hstore SET SCHEMA utils;</PRE
 
715
><P>
 
716
  </P
 
717
><P
 
718
>   To add an existing function to the <TT
 
719
CLASS="LITERAL"
 
720
>hstore</TT
 
721
> extension:
 
722
</P><PRE
 
723
CLASS="PROGRAMLISTING"
 
724
>ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);</PRE
 
725
><P>
 
726
  </P
 
727
></DIV
 
728
><DIV
 
729
CLASS="REFSECT1"
 
730
><A
 
731
NAME="SQL-ALTEREXTENSION-SEE-ALSO"
 
732
></A
 
733
><H2
 
734
>See Also</H2
 
735
><A
 
736
HREF="sql-createextension.html"
 
737
>CREATE EXTENSION</A
 
738
>, <A
 
739
HREF="sql-dropextension.html"
 
740
>DROP EXTENSION</A
 
741
></DIV
 
742
><DIV
 
743
CLASS="NAVFOOTER"
 
744
><HR
 
745
ALIGN="LEFT"
 
746
WIDTH="100%"><TABLE
 
747
SUMMARY="Footer navigation table"
 
748
WIDTH="100%"
 
749
BORDER="0"
 
750
CELLPADDING="0"
 
751
CELLSPACING="0"
 
752
><TR
 
753
><TD
 
754
WIDTH="33%"
 
755
ALIGN="left"
 
756
VALIGN="top"
 
757
><A
 
758
HREF="sql-alterdomain.html"
 
759
ACCESSKEY="P"
 
760
>Prev</A
 
761
></TD
 
762
><TD
 
763
WIDTH="34%"
 
764
ALIGN="center"
 
765
VALIGN="top"
 
766
><A
 
767
HREF="index.html"
 
768
ACCESSKEY="H"
 
769
>Home</A
 
770
></TD
 
771
><TD
 
772
WIDTH="33%"
 
773
ALIGN="right"
 
774
VALIGN="top"
 
775
><A
 
776
HREF="sql-alterforeigndatawrapper.html"
 
777
ACCESSKEY="N"
 
778
>Next</A
 
779
></TD
 
780
></TR
 
781
><TR
 
782
><TD
 
783
WIDTH="33%"
 
784
ALIGN="left"
 
785
VALIGN="top"
 
786
>ALTER DOMAIN</TD
 
787
><TD
 
788
WIDTH="34%"
 
789
ALIGN="center"
 
790
VALIGN="top"
 
791
><A
 
792
HREF="sql-commands.html"
 
793
ACCESSKEY="U"
 
794
>Up</A
 
795
></TD
 
796
><TD
 
797
WIDTH="33%"
 
798
ALIGN="right"
 
799
VALIGN="top"
 
800
>ALTER FOREIGN DATA WRAPPER</TD
 
801
></TR
 
802
></TABLE
 
803
></DIV
 
804
></BODY
 
805
></HTML
 
806
>
 
 
b'\\ No newline at end of file'