PL/Python 写的函数用通常的 CREATE FUNCTION 语法声明。比如:
CREATE FUNCTION funcname (argument-list)
RETURNS return-type
AS $$
# PL/Python function body
$$ LANGUAGE plpythonu;
函数体是一个简单的 Python 脚本。当该函数被调用的时候,传递的参数将成为 args[] 数组的元素。命名参数也会被传递到脚本中并被当作普通变量。结果将使用 return 或 yield 照常返回。
例如,返回两个整数中较大者的函数:
CREATE FUNCTION pymax (a integer, b integer)
RETURNS integer
AS $$
if a > b:
return a
return b
$$ LANGUAGE plpythonu;
以函数体形式给出的 Python 转换成 Python 函数。比如,上面的转换成
def __plpython_procedure_pymax_23456():
if a > b:
return a
return b
这里假设 23456 是 PostgreSQL 赋予这个函数的 OID 。
PostgreSQL 函数变量可以通过全局的 args 列表获取。在 pymax 例子里,args[0] 包含第一个参数的数值。args[1] 包含第二个。除此在外,还可以使用上例中演示的已命名的参数,这种方法的可读性更好。
如果向函数传递了一个 NULL 值,参数值将会显示为 None 。上述函数定义将