~vcs-imports/mammoth-replicator/trunk

« back to all changes in this revision

Viewing changes to doc/src/sgml/ref/drop_aggregate.sgml

  • Committer: alvherre
  • Date: 2005-12-16 21:24:52 UTC
  • Revision ID: svn-v4:db760fc0-0f08-0410-9d63-cc6633f64896:trunk:1
Initial import of the REL8_0_3 sources from the Pgsql CVS repository.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!--
 
2
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_aggregate.sgml,v 1.27 2003-11-29 19:51:38 pgsql Exp $
 
3
PostgreSQL documentation
 
4
-->
 
5
 
 
6
<refentry id="SQL-DROPAGGREGATE">
 
7
 <refmeta>
 
8
  <refentrytitle id="SQL-DROPAGGREGATE-TITLE">DROP AGGREGATE</refentrytitle>
 
9
  <refmiscinfo>SQL - Language Statements</refmiscinfo>
 
10
 </refmeta>
 
11
 
 
12
 <refnamediv>
 
13
  <refname>DROP AGGREGATE</refname>
 
14
  <refpurpose>remove an aggregate function</refpurpose>
 
15
 </refnamediv>
 
16
 
 
17
 <indexterm zone="sql-dropaggregate">
 
18
  <primary>DROP AGGREGATE</primary>
 
19
 </indexterm>
 
20
 
 
21
 <refsynopsisdiv>
 
22
<synopsis>
 
23
DROP AGGREGATE <replaceable class="PARAMETER">name</replaceable> ( <replaceable class="PARAMETER">type</replaceable> ) [ CASCADE | RESTRICT ]
 
24
</synopsis>
 
25
 </refsynopsisdiv>
 
26
 
 
27
 <refsect1>
 
28
  <title>Description</title>
 
29
 
 
30
  <para>
 
31
   <command>DROP AGGREGATE</command> will delete an existing
 
32
   aggregate function. To execute this command the current
 
33
   user must be the owner of the aggregate function.
 
34
  </para>
 
35
 </refsect1>
 
36
 
 
37
 <refsect1>
 
38
  <title>Parameters</title>
 
39
 
 
40
  <variablelist>
 
41
   <varlistentry>
 
42
    <term><replaceable class="parameter">name</replaceable></term>
 
43
    <listitem>
 
44
     <para>
 
45
      The name (optionally schema-qualified) of an existing aggregate function.
 
46
     </para>
 
47
    </listitem>
 
48
   </varlistentry>
 
49
 
 
50
   <varlistentry>
 
51
    <term><replaceable class="parameter">type</replaceable></term>
 
52
    <listitem>
 
53
     <para>
 
54
      The argument data type of the aggregate function, or
 
55
      <literal>*</literal> if the function accepts any data type.
 
56
     </para>
 
57
    </listitem>
 
58
   </varlistentry>
 
59
 
 
60
   <varlistentry>
 
61
    <term><literal>CASCADE</literal></term>
 
62
    <listitem>
 
63
     <para>
 
64
      Automatically drop objects that depend on the aggregate function.
 
65
     </para>
 
66
    </listitem>
 
67
   </varlistentry>
 
68
 
 
69
   <varlistentry>
 
70
    <term><literal>RESTRICT</literal></term>
 
71
    <listitem>
 
72
     <para>
 
73
      Refuse to drop the aggregate function if any objects depend on
 
74
      it.  This is the default.
 
75
     </para>
 
76
    </listitem>
 
77
   </varlistentry>
 
78
  </variablelist>
 
79
 </refsect1>
 
80
 
 
81
 <refsect1>
 
82
  <title>Examples</title>
 
83
 
 
84
  <para>
 
85
   To remove the aggregate function <literal>myavg</literal> for type
 
86
   <type>integer</type>:
 
87
<programlisting>
 
88
DROP AGGREGATE myavg(integer);
 
89
</programlisting>
 
90
  </para>
 
91
 </refsect1>
 
92
 
 
93
 <refsect1>
 
94
  <title>Compatibility</title>
 
95
 
 
96
  <para>
 
97
   There is no <command>DROP AGGREGATE</command> statement in the SQL
 
98
   standard.
 
99
  </para>
 
100
 </refsect1>
 
101
 
 
102
 <refsect1>
 
103
  <title>See Also</title>
 
104
 
 
105
  <simplelist type="inline">
 
106
   <member><xref linkend="sql-alteraggregate" endterm="sql-alteraggregate-title"></member>
 
107
   <member><xref linkend="sql-createaggregate" endterm="sql-createaggregate-title"></member>
 
108
  </simplelist>
 
109
 </refsect1>
 
110
 
 
111
</refentry>
 
112
 
 
113
<!-- Keep this comment at the end of the file
 
114
Local variables:
 
115
mode: sgml
 
116
sgml-omittag:nil
 
117
sgml-shorttag:t
 
118
sgml-minimize-attributes:nil
 
119
sgml-always-quote-attributes:t
 
120
sgml-indent-step:1
 
121
sgml-indent-data:t
 
122
sgml-parent-document:nil
 
123
sgml-default-dtd-file:"../reference.ced"
 
124
sgml-exposed-tags:nil
 
125
sgml-local-catalogs:"/usr/lib/sgml/catalog"
 
126
sgml-local-ecat-files:nil
 
127
End:
 
128
-->