GaussDB-CALL
功能描述
使用CALL命令可以调用已定义的函数和存储过程。
注意事项
函数或存储过程的所有者、被授予了函数或存储过程EXECUTE权限的用户、或被授予EXECUTE ANY FUNCTION权限的用户，有权使用CALL命令，当三权分立开关关闭时，系统管理员默认拥有此权限。
语法格式
| ``` CALL [ schema. ] { func_name | procedure_name } ( param_expr );
| ------------------------------------------------------------------------ |
#### 参数说明
- **schema**
函数或存储过程所在的模式名称。
- **func_name**
所调用函数或存储过程的名称。
取值范围：已存在的函数名称。
支持使用DATABASE LINK方式对远端函数或存储过程进行操作，使用方式详情请见[DATABASE LINK](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0711.html#ZH-CN_TOPIC_0000001865745520)。
- **param_expr**
参数列表可以用符号":="或者"=>"将参数名和参数值隔开，这种方法的好处是参数可以以任意顺序排列。若参数列表中仅出现参数值，则参数值的排列顺序必须和函数或存储过程定义时的相同。
取值范围：已存在的函数参数名称或存储过程参数名称。
- 参数可以包含入参（参数名和类型之间指定“IN”关键字）和出参（参数名和类型之间指定“OUT”关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见[示例](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0523.html#ZH-CN_TOPIC_0000001911666569__zh-cn_topic_0000001704458673_zh-cn_topic_0059778236_s299dc001fa4b48cd9b56412a73db23c0)。
[]()[]()
#### 示例
| ```
--创建一个函数func_add_sql，计算两个整数的和，并返回结果。 gaussdb=# CREATE FUNCTION func_add_sql(num1 integer, num2 integer) RETURN integer AS BEGIN RETURN num1 + num2; END; / --按参数值传递。 gaussdb=# CALL func_add_sql(1, 3); --使用命名标记法传参。 gaussdb=# CALL func_add_sql(num1 => 1,num2 => 3); gaussdb=# CALL func_add_sql(num2 := 2, num1 := 3); --删除函数。 gaussdb=# DROP FUNCTION func_add_sql; --创建带出参的函数。 gaussdb=# CREATE FUNCTION func_increment_sql(num1 IN integer, num2 IN integer, res OUT integer) RETURN integer AS BEGIN res := num1 + num2; END; / --出参传入常量。 gaussdb=# CALL func_increment_sql(1,2,1); --出参传入变量。 gaussdb=# DECLARE res int; BEGIN func_increment_sql(1, 2, res); dbe_output.print_line(res); END; / --删除函数。 gaussdb=# DROP FUNCTION func_increment_sql;
``` |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
#### 相关链接
[CREATE FUNCTION](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0546.html#ZH-CN_TOPIC_0000001911586717)，[CREATE PROCEDURE](https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/devg-dist/gaussdb-12-0558.html#ZH-CN_TOPIC_0000001911586749)
更多详情请参考GaussDB 文档中心：<https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html>
