更新时间:2026-10-21 GMT+08:00
分享

CALL

功能描述

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

注意事项

  • 函数或存储过程的所有者、被授予了函数或存储过程EXECUTE权限的用户或被授予EXECUTE ANY FUNCTION权限的用户,可以执行CALL命令,当三权分立开关关闭时,系统管理员默认拥有此权限。
  • 在database为当前数据库或pg_catalog时,支持使用三段式database.schema.name调用函数或存储过程,此时调用的均是当前数据库的对象。

语法格式

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

参数说明

  • schema.

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

  • package.

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

  • func_name

    要调用的函数的名称。

    取值范围:已存在的函数名称。

    • 支持使用DATABASE LINK方式对远端函数或存储过程进行操作,具体使用方式及约束请参见《开发指南》中“特性使用指导 > DATABASE LINK”章节。
    • 要调用的函数可以是独立函数,也可以是指定PACKAGE或指定模式中的成员。
    • 创建和系统函数重名的函数时,调用时需要指定函数所在的具体Schema。
  • procedure_name

    要调用的存储过程的名称。

    取值范围:字符串,要符合标识符命名规范。

    • 支持使用DATABASE LINK方式对远端函数或存储过程进行操作,具体使用方式及约束请参见《开发指南》中“特性使用指导 > DATABASE LINK”章节。
    • 要调用的存储过程可以是独立过程,也可以是指定PACKAGE或指定模式中的成员。
  • param_expr

    参数列表。

    可以使用命名标记法的方式传参,即使用“:=”符号或者“=>”符号将参数名和参数值隔开,这种方法可以对参数进行任意顺序的排列。

    若按照直接传入参数值的方式传参,即参数列表中仅出现参数值,则参数值的排列顺序必须和函数或存储过程定义时的相同。

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

    参数可以包含入参(参数名和类型之间指定“IN”关键字)和出参(参数名和类型之间指定“OUT”关键字),使用CALL命令调用函数或存储过程时,对于非重载的函数,参数列表必须包含出参,出参可以传入一个变量或者任一常量。对于重载的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=# DROP FUNCTION func_increment_sql;

相关文档