
# CALL
#### 功能描述
使用CALL命令可以调用已定义的函数和存储过程。
#### 注意事项
如果自定义函数的函数名与系统函数同名，调用自定义函数时需指定schema，否则系统会优先调用系统函数。
#### 语法格式
```
CALL [schema.] {func_name| procedure_name} ( param_expr );
```
#### 参数说明
表1CALL参数说明 
| 参数         | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                    | 取值范围                                                                                                                                                 |
|:---|:---|:---|
| schema     | 函数或存储过程所在的模式名称。                                                                                                                                                                                                                                                                                                                                                                                                                       | 字符串，要符合标识符命名规范。详情请参见[标识符命名规范](https://support.huaweicloud.com/sqlreference-dws/dws_06_0007.html#ZH-CN_TOPIC_0000001811634529__section1475018612353)。 |
| func_name  | 所调用函数或存储过程的名称。                                                                                                                                                                                                                                                                                                                                                                                                                        | 已存在的函数名称。                                                                                                                                            |
| param_expr | 参数列表可以用符号":="或者"=\>"将参数名和参数值隔开，优点是参数可以以任意顺序排列。若参数列表中仅出现参数值，则参数值的排列顺序必须和函数或存储过程定义时的相同。 说明： 参数可以包含入参（参数名和类型之间指定"IN"关键字）和出参（参数名和类型之间指定"OUT"关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见[示例]。对于重载的package函数，参数列表里可以忽略出参，忽略出参时可能会导致函数找不到。包含出参时，出参只能是常量。 | 已存在的函数参数名称或存储过程参数名称。                                                                                                                                 |
   
 #### 示例
创建一个函数func_add_sql，计算两个整数的和，并返回结果：
```
CREATE FUNCTION func_add_sql(num1 integer, num2 integer) RETURN integer
AS
BEGIN
RETURN num1 + num2;
END;
/
```
按参数值传递：
```
CALL func_add_sql(1, 3);
```
使用命名标记法传参：
```
CALL func_add_sql(num1 => 1,num2 => 3);
CALL func_add_sql(num2 := 2, num1 := 3);
```
删除函数：
```
DROP FUNCTION func_add_sql;
```
创建带出参的函数：
```
CREATE FUNCTION func_increment_sql(num1 IN integer, num2 IN integer, res OUT integer)
RETURN integer
AS
BEGIN
res := num1 + num2;
END;
/
```
出参传入常量：
```
CALL func_increment_sql(1,2,1);
```
出参传入变量：
```
DECLARE
res int;
BEGIN
func_increment_sql(1, 2, res);
dbms_output.put_line(res);
END;
/
```
创建重载的函数：
```
create or replace procedure package_func_overload(col int, col2 out int) package
as
declare
    col_type text;
begin
     col := 122;
         dbms_output.put_line('two out parameters ' || col2);
end;
/
```
```
create or replace procedure package_func_overload(col int, col2 out varchar)
package
as
declare
    col_type text;
begin
     col2 := '122';
         dbms_output.put_line('two varchar parameters ' || col2);
end;
/
```
函数调用：
```
call package_func_overload(1, 'test'); 
call package_func_overload(1, 1);
```
删除函数：
```
DROP FUNCTION func_increment_sql;
```
