CALL
功能描述
使用CALL命令可以调用已定义的函数和存储过程。
注意事项
函数或存储过程的所有者、被授予了函数或存储过程EXECUTE权限的用户或被授予EXECUTE ANY FUNCTION权限的用户有权调用函数或存储过程,系统管理员默认拥有此权限。
语法格式
1
|
CALL [ schema. ] { func_name | procedure_name } ( param_expr ); |
参数说明
- schema
函数或存储过程所在的模式名称。
- func_name
所调用函数或存储过程的名称。
取值范围:已存在的函数名称。
- param_expr
参数列表可以用符号":="或者"=>"将参数名和参数值隔开,这种方法的好处是参数可以以任意顺序排列。若参数列表中仅出现参数值,则参数值的排列顺序必须和函数或存储过程定义时的相同。
取值范围:已存在的函数参数名称或存储过程参数名称。
参数可以包含入参(参数名和类型之间指定“IN”关键字)和出参(参数名和类型之间指定“OUT”关键字),使用CALL命令调用函数或存储过程时,对于非重载的函数,参数列表必须包含出参,出参可以传入一个变量或者任一常量,详见示例。对于重载的package函数,参数列表里可以忽略出参,忽略出参时可能会导致函数找不到。包含出参时,出参只能是常量。
示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
--创建一个函数func_add_sql,计算两个整数的和,并返回结果。 openGauss=# CREATE FUNCTION func_add_sql(num1 integer, num2 integer) RETURN integer AS BEGIN RETURN num1 + num2; END; / --按参数值传递。 openGauss=# CALL func_add_sql(1, 3); --使用命名标记法传参。 openGauss=# CALL func_add_sql(num1 => 1,num2 => 3); openGauss=# CALL func_add_sql(num2 := 2, num1 := 3); --删除函数。 openGauss=# DROP FUNCTION func_add_sql; --创建带出参的函数。 openGauss=# CREATE FUNCTION func_increment_sql(num1 IN integer, num2 IN integer, res OUT integer) RETURN integer AS BEGIN res := num1 + num2; END; / --出参传入常量。 openGauss=# CALL func_increment_sql(1,2,1); --出参传入变量。 openGauss=# DECLARE res int; BEGIN func_increment_sql(1, 2, res); dbe_output.print_line(res); END; / --创建重载的函数。 openGauss=# CREATE OR REPLACE PROCEDURE package_func_overload(col int, col2 out int) PACKAGE AS DECLARE col_type text; BEGIN col := 122; dbe_output.print_line('two out parameters ' || col2); END; / openGauss=# CREATE OR REPLACE PROCEDURE package_func_overload(col int, col2 out varchar) PACKAGE AS DECLARE col_type text; BEGIN col2 := '122'; dbe_output.print_line('two varchar parameters ' || col2); END; / --函数调用。 openGauss=# CALL package_func_overload(1, 'test'); openGauss=# CALL package_func_overload(1, 1); --删除函数。 openGauss=# DROP FUNCTION package_func_overload; openGauss=# DROP FUNCTION func_increment_sql; |