1 声明函数参数
传递给函数的参数被命名为$1, $2等。作为可选项我们可以为参数$n起一个别名。无论是数字标识符还是别名都可以用来指向一个参数。
有两种创建别名的方式。推荐的方式是使用__CREATE FUNCTION__命令,举个例子来说:
CREATE FUNCTION sales_tax(subtotal real) RETURNS real AS $$BEGINRETURN subtotal * 0.06;END;$$ LANGUAGE plpgsql;
另一种方式是使用显式的声明语句:
name ALIAS FOR $n;
用同样的方式声明一个参数的别名
CREATE FUNCTION sales_tax(real) RETURNS real AS $$DECLARE subtotal ALIAS FOR $1BEGIN RETURN subtotal * 0.06;END $$ LANGUAGE plpgsql
注意
上述两个例子并不完全相同。在第一个例子中,subtotal可以使用sales_tax.subtotal的方式来引用,但是第二种例子中则不可以。在多举一些例子:
CREATE FUNCTION instr(varchar, integer) RETURNS integer AS $$DECLARE v_string ALIAS FOR $1 index ALIAS FOR $2 BEGIN -- some computations using v_string and index hereEND;$$ LANGUAGE plpgsqlCREATE FUNCTION concat_selected_fields(in_t 表名) RETURNStext AS $$BEGINRETURN in_t.f1 || in_t.f3 || in_t.f5 || in_t.f7;END;$$ LANGUAGE plpgsql;
当PL/pgSQL函数声明输出参数时,输出参数的命名方式和别名的创建方式与输入参数类似,输出参数的初始值是NULL,所以在函数执行的过程中必须给输出参数赋值。输出参数的最后得到的值就是函数的返回值。举例来说,sales-tax的例子也可以这么做:
CREATE FUNCTION sales_tax(subtotal real, OUT tax real) AS $$BEGIN tax := subtotal * 0.06;END;$$ LANGUAGE plpgsql;
注意我们删去了语句RETURNS real - 我们可以将其包含在内,但那是多余的。
当函数返回多个值时,输出参数是相当有用的,举例来说:CREATE FUNCTION sum_n_product(x int, y int, OUT sum int, OUT prod int) AS $$BEGIN sum := x + y; prod := x * y;END;$$ LANGUAGE plpgsql;
如同37.4.4小节讨论的,这种方式为函数的结果创建了一个匿名的record类型。如果出现一个RETURNS语句,那么它一定是RETURNS record
另一种声明PL/pgSQL函数的方法是RETURN TABLE,举例来说:
CREATE FUNCTION extended_sales(p_itemno int)RETURNS TABLE(quantity int, total numeric) AS $$BEGIN RETURN QUERY SELECT s.quantity, s.quantity * s.price FROM salesAS s WHERE s.itemno = p_itemno;END;$$ LANGUAGE plpgsql;
这种方式类似于声明一个或多个OUT参数以及使用RETURNS SETOF sometype
2. 别名
newname ALIAS FOR oldname;