DROP AGGREGATE

PostgreSQL 16.0文書
		SQLコマンド	誤訳等の報告
前へ	上へ	DROP AGGREGATE	次へ

DROP AGGREGATE <refpurpose>remove an aggregate function</refpurpose> — 集約関数を削除する

概要

DROP AGGREGATE [ IF EXISTS ] name ( aggregate_signature ) [, ...] [ CASCADE | RESTRICT ]


<phrase>where <replaceable>aggregate_signature</replaceable> is:</phrase>

ここでaggregate_signatureは以下の通りです。

* |
[ argmode ] [ argname ] argtype [ , ... ] |
[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]

説明

<title>Description</title>

<command>DROP AGGREGATE</command> removes an existing aggregate function. To execute this command the current user must be the owner of the aggregate function. DROP AGGREGATEを実行すると、既存の集約関数定義を削除することができます。このコマンドを実行するには、現在のユーザがその集約関数を所有している必要があります。

パラメータ

<title>Parameters</title>

IF EXISTS: Do not throw an error if the aggregate does not exist. A notice is issued in this case. 集約が存在しない場合でもエラーになりません。この場合注意メッセージが発行されます。
name: The name (optionally schema-qualified) of an existing aggregate function. 既存の集約関数の名前です（スキーマ修飾名も可）。
argmode: The mode of an argument: <literal>IN</literal> or <literal>VARIADIC</literal>. If omitted, the default is <literal>IN</literal>. 引数のモードで、INまたはVARIADICです。省略した場合のデフォルトはINです。
argname: The name of an argument. Note that <command>DROP AGGREGATE</command> does not actually pay any attention to argument names, since only the argument data types are needed to determine the aggregate function's identity. 引数の名前です。 DROP AGGREGATEは実際には引数の名前を無視することに注意してください。これは、集約関数の本体を特定するのに必要になるのは、引数のデータ型だけだからです。
argtype: An input data type on which the aggregate function operates. To reference a zero-argument aggregate function, write <literal>*</literal> in place of the list of argument specifications. To reference an ordered-set aggregate function, write <literal>ORDER BY</literal> between the direct and aggregated argument specifications. 集約関数の操作対象となる入力データ型です。引数を持たない関数を参照する場合は、引数指定の一覧の場所に*を記述してください。順序集合集約関数を参照する場合は、直接引数と集約引数の指定の間にORDER BYを記述してください。
CASCADE: Automatically drop objects that depend on the aggregate function (such as views using it), and in turn all objects that depend on those objects (see <xref linkend="ddl-depend"/>). その集約関数に依存しているオブジェクト（集約関数を利用しているビューなど）を自動的に削除し、さらにそれらのオブジェクトに依存するすべてのオブジェクトも削除します（5.14参照）。
RESTRICT: Refuse to drop the aggregate function if any objects depend on it. This is the default. 依存しているオブジェクトがある場合、その集約関数の削除要求を拒否します。こちらがデフォルトです。

注釈

<title>Notes</title>

Alternative syntaxes for referencing ordered-set aggregates are described under <xref linkend="sql-alteraggregate"/>. 順序集合集約を参照するための代替となる構文については、ALTER AGGREGATEに記述されています。

例

<title>Examples</title>

To remove the aggregate function <literal>myavg</literal> for type <type>integer</type>: integer型のmyavg集約関数を削除します。

DROP AGGREGATE myavg(integer);

To remove the hypothetical-set aggregate function <literal>myrank</literal>, which takes an arbitrary list of ordering columns and a matching list of direct arguments: 順序列の任意のリストと直接引数の適合するリストをとる、仮想集合集約関数myrankを削除します。

DROP AGGREGATE myrank(VARIADIC "any" ORDER BY VARIADIC "any");

To remove multiple aggregate functions in one command: 複数の集約関数を1つのコマンドで削除します。

DROP AGGREGATE myavg(integer), myavg(bigint);

互換性

<title>Compatibility</title>

There is no <command>DROP AGGREGATE</command> statement in the SQL standard. 標準SQLには、DROP AGGREGATE文はありません。

DROP AGGREGATE

概要

説明

パラメータ

注釈

例

互換性

関連項目