VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

CALL

功能描述

使用CALL命令可以调用已定义的函数和存储过程。

注意事项

  • 函数或存储过程的所有者、被授予了函数或存储过程EXECUTE权限的用户或被授予EXECUTE ANY FUNCTION权限的用户有权调用函数或存储过程,系统管理员默认拥有此权限。

  • 在MySQL兼容模式下,针对无参的存储过程可不使用括号。

  • 在使用call语法调用时,允许使用变量对应作为out、inout类型的参数,可参考CALL

语法格式

CALL [schema.|package.] {func_name| procedure_name} ( param_expr );

参数说明

  • schema

    函数或存储过程所在的模式名称。

  • package

    函数或存储过程所在的package名称。

  • func_name| procedure_name

    所调用函数或存储过程的名称。

    取值范围:已存在的函数或存储过程名称。

  • param_expr

    参数列表可以用符号“:=”或者“=>”将参数名和参数值隔开,这种方法的好处是参数可以以任意顺序排列。若参数列表中仅出现参数值,则参数值的排列顺序必须和函数或存储过程定义时的相同。

    取值范围:已存在的函数参数名称或存储过程参数名称。

    参数可以包含入参(参数名和类型之间指定“IN”关键字)和出参(参数名和类型之间指定“OUT”关键字),使用CALL命令调用函数或存储过程时,对于非重载的函数,参数列表必须包含出参,出参可以传入一个变量或者任一常量。对于重载的package函数,参数列表里可以忽略出参(此处如果想创建只有出参不同入参相同的重载函数,需要设置behavior_compat_options =“proc_outparam_override” ),忽略出参时可能会导致函数找不到。因为其本质是调用了另一个同名的不含出参的重载函数。包含出参时,出参只能是常量。以上两种情况详见示例

示例

示例1:计算两个整数的和。

1、创建一个函数func_add_sql,计算两个整数的和,并返回结果。

CREATE FUNCTION func_add_sql(num1 integer, num2 integer) RETURN integer
AS
BEGIN
RETURN num1 + num2;
END;
/

2、按参数值传递。

CALL func_add_sql(1, 3);

结果显示如下:

 func_add_sql 
--------------
            4
(1 row)

3、使用命名标记法传参。

CALL func_add_sql(num1 => 1,num2 => 3);

结果显示如下:

 func_add_sql 
--------------
            4
(1 row)

4、删除函数。

DROP FUNCTION func_add_sql;

示例2:出参传入常量。

1、创建带出参的函数。

CREATE FUNCTION func_increment_sql(num1 IN integer, num2 IN integer, res OUT integer)
RETURN integer
AS
BEGIN
res := num1 + num2;
END;
/

2、出参传入常量。

CALL func_increment_sql(1,2,1);

结果显示如下:

 res 
-----
   3
(1 row)

3、删除函数。

DROP FUNCTION func_increment_sql;

示例3: 无参的存储过程不使用括号。

仅在MySQL兼容模式下,针对无参的存储过程可不使用括号。如下示例要求在MySQL兼容模式下执行。

1、创建无参存储过程。

CREATE PROCEDURE ptest()
AS
BEGIN
raise notice 'test';
END;
/

2、不加括号调用存储过程。

call ptest;

结果显示如下:

NOTICE: test
 ptest 
-------

(1 row)

示例4: call调用package属性的重载函数。

1、设置参数设置behavior_compat_options =“proc_outparam_override”,控制存储过程出参的重载行为。

set behavior_compat_options ="proc_outparam_override";

2、创建package属性的重载函数。

CREATE OR REPLACE PACKAGE test_overload IS
function testp(a int) return int;
function testp(a int, b out int) return int;
end test_overload;
/

create or replace package body test_overload --创建package body
is                               
function testp(a int) return int
is                
Begin
raise notice 'func without out_arg';
return a;
end;
function testp(a int, b out int)
return int
is
begin
b:=1;
Raise notice 'func with out_arg';
return 2;
end;
end test_overload;
/

3、使用call调用package属性的重载函数。

call test_overload.testp(1);--调用忽略出参
call test_overload.testp(1,2);--调用包含出参

返回结果为如下:

NOTICE:  func without out_arg
 testp
-------
     1
(1 row)

NOTICE:  func with out_arg
 testp | b
-------+---
     2 | 1
(1 row)