PostgreSQL 定义返回表函数的操作
本文我们学习如何在PostgreSQL 开发返回表函数。
示例数据表
我们使用的示例数据库表为film,如下图所示:
示例1
第一个函数发挥所有满足条件film表记录,这里使用ilike操作,和like类似,但不区分大小写:
CREATE OR REPLACE FUNCTION get_film (p_pattern VARCHAR) RETURNS TABLE ( film_title VARCHAR, film_release_year INT ) AS $$ BEGIN RETURN QUERY SELECT title, cast( release_year as integer) FROM film WHERE title ILIKE p_pattern ; END; $$ LANGUAGE 'plpgsql';
get_film(varchar) 函数接收一个参数,为匹配title字段的模式字符串。
为了从函数中返回表,需要使用return table语法,以及表的字段,每个字段使用逗号分隔。
在函数中,我们返回一个查询(select 语句)作为返回结果。注意select语句中的字段必须和返回表的字段类型一致。因为film表中release_year的数据类型不是integer,所以我们要使用cast函数转换成integer。
下面进行测试该函数:
SELECT * FROM get_film ('Al%');
我们调用该函数,获取所有title以Al开头的记录:
注意,我们也可以使用下面语句进行调用:
SELECT get_film ('Al%');
PostgreSQL 返回已一列数组形式返回表。
示例2
实际开发中,我们经常需要在返回函数结果集之前处理每一行记录。下面通过示例说明:
CREATE OR REPLACE FUNCTION get_film (p_pattern VARCHAR,p_year INT) RETURNS TABLE ( film_title VARCHAR, film_release_year INT ) AS $$ DECLARE var_r record; BEGIN FOR var_r IN(SELECT title, release_year FROM film WHERE title ILIKE p_pattern AND release_year = p_year) LOOP film_title := upper(var_r.title) ; film_release_year := var_r.release_year; RETURN NEXT; END LOOP; END; $$ LANGUAGE 'plpgsql';
该函数与上一个名称一样get_film(varchar,int),但有两个参数:
第一个参数匹配title字段的模式字符串。仍然使用ilike操作执行搜索。
第二个参数是file的发行年度。
这两个函数在PostgreSQL中称为重载函数。我们想在返回结果之前处理每一行,使用 FOR LOOP语句进行处理。内部每个迭代中使用UPPER函数是film title 变为大写,仅为了演示而已。
return next语句是增加一行至函数结果集中,不断执行循环,在每次迭代中生成结果集。
下面进行测试:
SELECT * FROM get_film ('%er', 2006);
总结
现在你应该理解了如何开发返回表的函数,主要使用return query 和 return next 语句。
补充:Postgres自定义函数返回记录集(虚拟表结构)
看实例吧~
CREATE OR REPLACE FUNCTION fun_get_real_inv_qty(pvOrderId varchar) RETURNS SETOF record AS $BODY$begin --drop table if exists tmp_1 ; --create temp table tmp_1 as return query select fp_prod_id,fq_part_no,fq_name, sum(case when fo_type='P' then -fp_qty else 0 end ) as purchase_qty, sum(case when fo_type='S' then -fp_qty else 0 end ) as saleqty, sum(case when fo_type='S' then -fp_qty when fo_type='P' then fp_qty else 0 end ) as surplus_qty from tp_send_det,to_send_note,tq_prod_mstr where fp_order_id=pvOrderId and fo_note_id=fp_note_id and fq_prod_id=fp_prod_id and fq_type='I' group by fp_prod_id,fq_part_no,fq_name ; end;$BODY$ LANGUAGE plpgsql VOLATILE COST 100 ROWS 10; ALTER FUNCTION fun_get_real_inv_qty() OWNER TO postgres;
上面是例子,调用这个函数:
select * from fun_get_real_inv_qty('D302') f(fp_prod_id bigint,fq_part_no varchar ,fq_name varchar ,purchase_qty numeric ,saleqty numeric ,surplus_qty numeric );
f...后面带的是记录的column定义 必须与函数输出的列数量及每列数据类型一一对应.
以上为个人经验,希望能给大家一个参考,也希望大家多多支持。如有错误或未考虑完全的地方,望不吝赐教。
下一篇:PostgreSQL 实现查询表字段信息SQL脚本