pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
CREATE AGGREGATE — 定义一个新的聚合函数
CREATE AGGREGATEname( BASETYPE =input_data_type, SFUNC =sfunc, STYPE =state_type[ , FINALFUNC =ffunc] [ , INITCOND =initial_condition] )
name要创建的聚合函数的名称。
input_data_type此聚合函数所操作的输入数据类型。对于不检查其输入值的聚合，可以将它指定为 ANY（这种聚合的一个例子是count(*)）。
sfunc要为每个输入数据值调用的状态转移函数的名称。它通常是一个双参数函数，第一个参数的类型为state_type，第二个参数的类型为input_data_type。或者，对于不检查其输入值的聚合，该函数只接受一个类型为state_type的参数。无论哪种情况，该函数都必须返回state_type类型的值。此函数接受当前状态值和当前输入数据项，并返回下一个状态值。
state_type聚合状态值的数据类型。
ffunc在遍历完所有输入数据之后调用的、用于计算聚合结果的最终函数的名称。该函数必须接受单个类型为state_type的参数。聚合的输出数据类型被定义为该函数的返回类型。如果没有指定ffunc，则结束状态值被用作聚合的结果，输出类型为state_type。
initial_condition状态值的初始设置。这必须是state_type数据类型所接受形式的字面常量。如果未指定，状态值将从 NULL 开始。
CREATE命令成功完成时返回的消息。
CREATE AGGREGATE 允许用户或程序员通过定义新的聚合函数来扩展 PostgreSQL 的功能。基本发行版中已经提供了一些针对基本类型的聚合函数，例如min(integer) 和avg(double precision)。如果定义了新的类型，或者需要一个尚未提供的聚合函数，就可以使用CREATE AGGREGATE 来提供所需的功能。
聚合函数由其名称和输入数据类型标识。两个聚合如果操作于不同的输入类型，则可以有相同的名称。为避免混淆，不要创建与某个聚合同名且具有相同输入数据类型的普通函数。
一个聚合函数由一个或两个普通 函数构成： 一个状态转移函数 sfunc， 以及一个可选的最终计算函数 ffunc。 它们的用法如下：
sfunc( internal-state, next-data-item ) ---> next-internal-stateffunc( internal-state ) ---> aggregate-value
PostgreSQL 会创建一个数据类型为 stype 的临时变量，用来保存聚合的当前内部状态。对于每个输入 数据项， 都会调用状态转移函数来计算新的 内部状态值。等到所有数据都处理完毕后， 再调用一次最终函数来计算聚合的输出 值。如果没有最终函数，则 原样返回结束时的状态值。
聚合函数可以提供一个初始条件，即内部状态值的初始值。它在数据库中以 text类型的字段的形式指定和存储，但它必须是状态值数据类型常量的 合法外部表示。如果未提供，则状态值初始为 NULL。
如果状态转移函数被声明为“strict”的，那么它不能以 NULL 输入被调用。使用这种转移函数时，聚合的执行行为如下。NULL 输入值会被忽略（不调用函数并保留先前的状态值）。如果初始状态值为 NULL，那么第一个非 NULL 输入值会取代状态值，而转移函数从第二个非 NULL 输入值开始被调用。这对于实现max这类聚合很方便。注意，只有当state_type与input_data_type相同时，此行为才可用。当这两种类型不同时，必须提供非 NULL 的初始条件或者使用非严格的转移函数。
如果状态转移函数不是严格的，那么它会在每个输入值上被无条件调用，并且必须自行处理 NULL 输入和 NULL 转移值。这使聚合作者能完全控制聚合对 NULL 的处理。
如果最终函数被声明为“strict”，那么当结束状态值为 NULL 时不会调用它；而是自动输出 NULL 结果。（这当然只是 strict 函数的正常行为。）无论如何，最终函数都可以选择返回 NULL。例如，avg的最终函数在发现输入元组数为零时会返回 NULL。
使用DROP AGGREGATE 删除聚合函数。
CREATE AGGREGATE的参数可以按任意顺序书写，而不只是按上面展示的顺序。
完整的使用示例请参阅PostgreSQL 程序员指南中关于聚合函数的章节。
CREATE AGGREGATE 是 PostgreSQL 的语言扩展。 SQL92 中没有CREATE AGGREGATE。
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。