CREATE AGGREGATE name ( input_data_type [ , ... ] ) (
    SFUNC = sfunc,
    STYPE = state_data_type
    [ , FINALFUNC = ffunc ]
    [ , INITCOND = initial_condition ]
    [ , SORTOP = sort_operator ]
)

或者旧语法

CREATE AGGREGATE name (
    BASETYPE = base_type,
    SFUNC = sfunc,
    STYPE = state_data_type
    [ , FINALFUNC = ffunc ]
    [ , INITCOND = initial_condition ]
    [ , SORTOP = sort_operator ]
)

描述

CREATE AGGREGATE定义一个新的聚集函数。一些常用的聚集函数已经包含在 基础软件包里了；在节Section 9.18里有文档记录。如果你需要定义 一个新类型或需要一个还没有提供的聚集函数，这时CREATE AGGREGATE便可 排上用场。

如果给出了一个模式的名字(比如CREATE AGGREGATE myschema.myagg ...)，那么该 聚集函数是在指定模式中创建的。否则它是在当前模式中创建的。

一个聚集函数是用它的名字和输入数据类型来标识的。同一模式中如果两个聚集处理的输入数据不同， 它们可以有相同的名字。一个聚集函数的输入数据类型必须和所有同一模式中的普通函数的名字和输入 类型不同。

一个聚集函数是用一个或两个普通函数做成的：一个状态转换函数 sfunc和一个可选的最终计算函数 ffunc。它们是这样使用的：

sfunc( internal-state, next-data-values ) ---> next-internal-state
ffunc( internal-state ) ---> aggregate-value

PostgreSQL创建一个类型为 stype的临时变量。它保存这个聚集的 当前内部状态。对于每个输入数据条目，都调用状态转换函数计算内部状态值的新数值。 在处理完所有数据后，调用一次最终处理函数以计算聚集的返回值。如果没有最终处理函数， 则将最后的状态值当做返回值。

一个聚集函数还可能提供一个初始条件，也就是内部状态值的初始值。这个值是作为一个类型 为text的字段存储在数据库里的，不过它们必须是状态值数据类型的合法的外部 表现形式的常量。如果没有提供状态，那么状态值初始化为 NULL 。

如果该状态转换函数被定义为"strict"，那么就不能用 NULL 输入调用它。此时， 聚集的执行如下所述。带有任何 NULL 输入值的行将被忽略(不调用此函数并且保留前一个状态值)。 如果初始状态值是 NULL ，那么在第一个含有非 NULL 值的行上，使用第一个参数值替换状态值， 然后状态转换函数在随后所有的含有非 NULL 值的行上调用。这样做让比较容易实现像 max这样的聚集。请注意这种行为只是当 state_data_type与 input_data_type相同的时候才表现出来。 如果这些类型不同，你必须提供一个非 NULL 的初始条件或者使用一个非"strice"的状态转换函数。

如果状态转换函数不是严格(strict)的，那么它将无条件地在每个输入行上调用，并且必须自行 处理 NULL 输入和 NULL 转换值，这样就允许聚集的作者对聚集中的 NULL 有完全的控制。

如果最终转换函数定义为"strict"，那么如果最终状态值是 NULL 时就不会调用它； 而是自动输出一个 NULL 结果。这才是 strict 函数的正常特征。不管是那种情况，最终处理函数 可以自由选择是否返回 NULL 。比如，avg的最终处理函数在零输入记录时 就会返回 NULL 。

行为类似MIN或MAX的聚集有时候可以优化为使用索引，而不用扫描 每个输入行。如果这个聚集可以如此优化，则用一个排序操作符标识它。这里基本的要求是聚集 必须以操作符归纳出来的排序顺序生成第一个元素；换句话说

SELECT agg(col) FROM tab;

必须等于：

SELECT col FROM tab ORDER BY col USING sortop LIMIT 1;

更多的假设是聚集忽略 NULL 输入，并且只有在输入没有非空数值的时候，它才生成NULL结果。 通常，数据类型的 < 操作符是MIN的适用排序操作符，而 > 是MAX 的适用操作符。请注意，除非声明的操作符是 B-tree 索引操作符类的"小于"或者"大于"策略号， 否则这种优化将不会生效。

参数

CREATE AGGREGATE的参数可以以任何顺序书写，而不只是上面显示的顺序。

示例

See Section 35.10.

兼容性

CREATE AGGREGATE是PostgreSQL语言的扩展。SQL标准没有提供用户自定义聚集函数的功能。

又见

ALTER AGGREGATE, DROP AGGREGATE