# CALL
#### 功能描述
使用CALL命令可以调用已定义的函数和存储过程。
#### 注意事项
- 函数或存储过程的所有者、被授予了函数或存储过程EXECUTE权限的用户或被授予EXECUTE ANY FUNCTION权限的用户，可以执行CALL命令，当三权分立开关关闭时，系统管理员默认拥有此权限。
- 在database为当前数据库或pg_catalog时，支持使用三段式database.schema.name调用函数或存储过程，此时调用的均是当前数据库的对象。
 
#### 语法格式
```
CALL [ schema.|package.] { func_name | procedure_name } ( param_expr );
```
![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/figure/zh-cn_image_0000002764309588.png "点击放大")
#### 参数说明
- **schema.**
  函数或存储过程所在的模式名称。
  
- **package.**
  函数或存储过程所在的PACKAGE名称。
  
- **func_name**
  要调用的函数的名称。
  取值范围：已存在的函数名称。
  ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - 支持使用DATABASE LINK方式对远端函数或存储过程进行操作，具体使用方式及约束请参见《开发指南》中"特性使用指导 \> DATABASE LINK"章节。
  
  - 要调用的函数可以是独立函数，也可以是指定PACKAGE或指定模式中的成员。
  
  - 创建和系统函数重名的函数时，调用时需要指定函数所在的具体Schema。
    
- **procedure_name**
  要调用的存储过程的名称。
  取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-0003.html#ZH-CN_TOPIC_0000002793787739__section14873217506)。
  ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - 支持使用DATABASE LINK方式对远端函数或存储过程进行操作，具体使用方式及约束请参见《开发指南》中"特性使用指导 \> DATABASE LINK"章节。
  
  - 要调用的存储过程可以是独立过程，也可以是指定PACKAGE或指定模式中的成员。
    
- **param_expr**
  参数列表。
  可以使用命名标记法的方式传参，即使用":="符号或者"=\>"符号将参数名和参数值隔开，这种方法可以对参数进行任意顺序的排列。
  若按照直接传入参数值的方式传参，即参数列表中仅出现参数值，则参数值的排列顺序必须和函数或存储过程定义时的相同。
  取值范围：已存在的函数参数名称或存储过程参数名称。
  ![](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - 参数可以包含入参（参数名和类型之间指定"IN"关键字）和出参（参数名和类型之间指定"OUT"关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量。对于重载的PACKAGE函数，参数列表里可以忽略出参，忽略出参时可能会导致函数无法匹配；包含出参时，出参只能是常量。
  
  - 仅支持在ORA兼容性数据库中使用PACKAGE。
    
 
#### 示例
```
--创建一个函数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;
--创建重载的函数。
gaussdb=# 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;
/
gaussdb=# 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;
/
--函数调用。
gaussdb=# CALL package_func_overload(1, 'test'); 
gaussdb=# CALL package_func_overload(1, 1); 
--删除函数。
gaussdb=# DROP FUNCTION package_func_overload;
```
#### 相关链接
[CREATE FUNCTION](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-0249.html)，[CREATE PROCEDURE](https://support.huaweicloud.com/distributed-ref-v10-gaussdb/gaussdb-08-0261.html)