PgSQL 自7.3起支持SRF( Set Returning Func. 集合返回函数) 配合有一些新的函数权限选项,
使 schema 的设置更灵活性。SRF 除了手册里提到的内置函数 generate_series generate_subscript 外,自定义函数也可返回集合。 下面示例摘译自 PgSQL wiki :PL/PgSQL如何返回多行结果
我们从处理简单表单函数说起。
create table department(id int primary key, name text); create table employee(id int primary key, name text, salary int, departmentid int references department); insert into department values (1, 'Management'); insert into department values (2, 'IT'); insert into employee values (1, 'John Smith', 30000, 1); insert into employee values (2, 'Jane Doe', 50000, 1); insert into employee values (3, 'Jack Jackson', 60000, 2);SRF 可以返回的数据类型可以是现有表中定义过的 rowtype 或通用的 record 类型。
首先我们看一个简单的SQL函数返回现有表中的 rowtype
这个非常简单的函数直接返回 employee 中的所有行:
其返回类型为 setof employee 即返回由 employee 各行组成的行集合,
其主体采用简单SQL语句,生成输出的行。
SRF 可以在查询中代替 FROM 中的 表 或 子查询 。
例如用函数返回所有id>2的聘员只要:
很好,但要返回更复杂的数据怎么办?
例如: 部门列表及其中所有聘员的薪水,
要返回现有记录类型,你需要创建一个虚构类型来保存输出的数据,
例如:
这里创建了新的复合类型 holder 由名为 departmentid 的 int
和名为 totalsalary 的 bigint 组成,我们可以让函数返回此类型的集合:
这次我们用 SQL 和 PL/pgSQL 来分别实现这个函数:
SQL的版本与之前的很相像,返回由 holder (int, int8) 类型定义的 rowtype,
返回的行由函数体中的 group by 查询决定。
PL/pgSQL 版本稍复杂,首先变量 r 被声明为 rowtype holder 。用此变量保存行函数体中的查询结果,函数主体对 group by 查询的结果循环执行,r 依次被赋值为结果中的各行,循环体中采用了新的return形式 'return next' 即将结果追加到返回的集合中,但不会造成函数返回。目前 PL/pgSQL 的 SRF 函数在全部结果生成完毕前不会返回。如果集合很大会写入硬盘。此限制未来的版本中也许会改变。
新函数的使用与之前相同,
PL/pgSQL 函数还可以对结果进行运算,只返回某些结果。
例如:要计算部门运营成本:部门总薪资 70,000 以上的开销是 75%, 其他为 50%,
返回薪资+开销>100,000的部门的部门id。
create or replace function ExpensiveDepartments() returns setof int as ' declare r holder%rowtype; begin for r in select departmentid, sum(salary) as totalsalary from GetEmployees() group by departmentid loop if (r.totalsalary > 70000) then r.totalsalary := CAST(r.totalsalary * 1.75 as int8); else r.totalsalary := CAST(r.totalsalary * 1.5 as int8); end if; if (r.totalsalary > 100000) then return next r.departmentid; end if; end loop; return; end ' language 'plpgsql';比较一下本次与之前 PLpgSQLDepartmentSales() 的区别。
因为本次只需要返回高成本部门的 department id
函数返回一个整数集合 (department id) 而非之前的复合类型。
然后判断 totalsalary 是否大于 100,000 如果为真,则返回识别符
if (r.totalsalary > 100000) then return next r.departmentid; end if;注意本次 return next 没有返回记录 r 而只有 departmentid,
如果需要同时返回 薪资总额与开销之和,
前面声明中可以定义为 return setof holder 这里使用 return next r;
以上函数返回的复合类型使用的前提是返回的类型与函数的 return 声明中的相同。
如果不同,SQL版本在创建时会报错,PL/pgSQL 版本在运行中会出现错。
但如果结果中的类型只能在运行中确定该怎么办?
此时你可以声明 return setof record 以返回复合类型的集合,
返回的类型可以调用时设置。例如我们要创建一个函数返回指定表中的所有行:
create or replace function GetRows(text) returns setof record as ' declare r record; begin for r in EXECUTE ''select * from '' || $1 loop return next r; end loop; return; end ' language 'plpgsql';调用此函数时比之前的要稍复杂,查询中需要指定函数返回的数据。
PostgreSQL 对 SRF函数 的处理与子查询相似,语法上与为子查询中别名的设定相似。
我们将 Department 作为参数传入,结果应该与 Department 表的一般记录相同,
由一个 INT 和一个 TEXT 组成。于是我们告诉PgSQL,结果dept 为别名,
包含一个名为 deptid 的整数和 deptname 的文本。
最后我们试试完全用 PL/pgSQL函数生成数据。让我们从最简单的做起:
写一个函数,接收返回1到任意数间的所有数,以及这个他们的二倍。
我们先写一个以预定义类型的为内部和返回类型的版本。
create type numtype as (num int, doublenum int); create or replace function GetNum(int) returns setof numtype as ' declare r numtype%rowtype; i int; begin for i in 1 .. $1 loop r.num := i; r.doublenum := i*2; return next r; end loop; return; end ' language 'plpgsql';函数非常简单,声明中 r 为名为 numtype 的自定义 rowtype 。
将1到参数间的每个值,赋给 num 和 doublenum
然后 return next r 将结果加入输出集合的队列中;
用 record 类型可以实现通用效果,免去函数外的类型声明,
不过做起来会更复杂而且需要多一次 select 调用。
类似返回多个结果的还有 动态 SQL 查询语句
(PREPARE STATEMENT... + EXECUTE...INTO...USING + DEALLOCATE PREPARE)
通过返回 指针 也可以实现返回多行结果。
https://www.postgresql.org/docs/current/static/ecpg-dynamic.html
另外有需要云服务器可以了解下创新互联cdcxhl.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。