search
sun-outline
light

openGauss

开源数据库

openGauss社区官网

开源社区

博客chevron-rightMogDB2.1数据库新特性之：CREATE PACKAGE

MogDB2.1数据库新特性之：CREATE PACKAGE

云和恩墨2022-04-15MogDB2.1数据库新特性之：CREATE PACKAGE

MogDB2.1 数据库新特性之：CREATE PACKAGE ​

本文出处：https://www.modb.pro/db/390543

MogDB2.1 版本开始支持创建 PACKAGE。

使用 PACKAGE 的注意事项： ​

  • 由于升级的限制，即使在不同的 Package 间，也无法创建同名同参的存储过程。
  • package 只支持集中式，无法在分布式中使用。
  • 在 package specification 中声明过的函数或者存储过程，必须在 package body 中找到定义。
  • 在实例化中，无法调用带有 commit/rollback 的存储过程。
  • 不能在 Trigger 中调用 package 函数。
  • 不能在外部 SQL 中直接使用 package 当中的变量。
  • 不允许在 package 外部调用 package 的私有变量和存储过程。
  • 不支持其它存储过程不支持的用法，例如，在 function 中不允许调用 commit/rollback，则 package 的 function 中同样无法调用 commit/rollback。
  • 不支持 schema 与 package 同名。
  • 只支持 A 风格的存储过程和函数定义。
  • 不支持 package 内有同名变量，包括包内同名参数。
  • package 的全局变量为 session 级，不同 session 之间 package 的变量不共享。
  • package 中调用自治事务的函数，不允许使用公有变量，以及递归的使用公有变量的函数。
  • package 中不支持声明 ref cursor 类型。

CREATE PACKAGE 语法： ​

CREATE PACKAGE SPECIFICATION 语法格式

CREATE [ OR REPLACE ] PACKAGE [ schema ] package_name
    [ invoker_rights_clause ] { IS | AS } item_list_1 END package_name;

invoker_rights_clause 可以被声明为 AUTHID DEFINER 或者 AUTHID INVOKER，分别为定义者权限和调用者权限。 item_list_1 可以为声明的变量或者存储过程以及函数。 PACKAGE SPECIFICATION(包规格)声明了包内的公有变量、函数、异常等，可以被外部函数或者存储过程调用。在 PACKAGE SPECIFICATION 中只能声明存储过程，函数，不能定义存储过程或者函数。

CREATE PACKAGE BODY 语法格式。

CREATE [ OR REPLACE ] PACKAGE BODY [ schema ] package_name
    { IS | AS } declare_section [ initialize_section ] END package_name;

PACKAGE BODY(包体内)定义了包的私有变量，函数等。如果变量或者函数没有在 PACKAGE SPECIFICATION 中声明过，那么这个变量或者函数则为私有变量或者函数。 PACKAGE BODY 也可以声明实例化部分，用来初始化 package

测试： ​

1.创建 PACKAGE： ​

plsql
CREATE OR REPLACE PACKAGE package1 IS
  O_SQLERROR varchar2(2000);
  FUNCTION func1(num1 int,num2 int) RETURN int;
  PROCEDURE proc1(i_num1 IN int,i_num2 IN int, O_RESULT OUT int, O_ERRCODE OUT varchar, O_ERROR OUT varchar) ;
end package1;
/
CREATE OR REPLACE PACKAGE BODY package1 IS
    FUNCTION func1(num1 int,num2 int) RETURN int iS
     func_result int;
     BEGIN
              func_result:= num1+num2;
              O_SQLERROR :='00000';
              RETURN func_result;
     EXCEPTION
       WHEN OTHERS THEN
         RETURN NULL;
   END ;
   PROCEDURE proc1(i_num1 IN int,i_num2 IN int, O_RESULT OUT int, O_ERRCODE OUT varchar, O_ERROR OUT varchar)  IS
   BEGIN
     o_result := i_num1 + i_num2;
     O_ERRCODE := '0000';
     O_ERROR := 'successful completion';
     O_SQLERROR :='11111';
      EXCEPTION
       WHEN OTHERS THEN
         O_ERRCODE := SQLSTATE;
         O_ERROR := SQLERRM;
   END ;
  end package1;
/

测试执行包中的存储过程和函数：

  测试结果：
ora_proc=> call package1.proc1(1,2,a,b,c);
 o_result | o_errcode |        o_error
----------+-----------+-----------------------
        3 | 0000      | successful completion
(1 row)
ora_proc=> select package1.func1(1,2);
 func1
-------
     3
(1 row)

2.已在 PACKAGE 中定义的存储过程/函数，不能和在其他 PACKAGE 中定义的存储过程/函数同名且同参数,也不能和不是在 PACKAGE 中定义的存储过程/函数同名且同参数。 ​

plsql
ora_proc=>        create or replace FUNCTION func1(num1 int,num2 int) RETURN int package IS
ora_proc$>      func_result int;
ora_proc$>      BEGIN
ora_proc$>               func_result:= num1+num2;
ora_proc$>               RETURN func_result;
ora_proc$>      EXCEPTION
ora_proc$>        WHEN OTHERS THEN
ora_proc$>          RETURN NULL;
ora_proc$>    END ;
ora_proc$> /
ERROR:  Due to upgrade mode,Do not allow different package have same function name with same parameter,please drop package by oid 17309 first
ora_proc=>     create or replace FUNCTION func1(num1 int,num2 int,num3 int) RETURN int iS
ora_proc$>      func_result int;
ora_proc$>      BEGIN
ora_proc$>               func_result:= num1+num2 +num3;
ora_proc$>               RETURN func_result;
ora_proc$>      EXCEPTION
ora_proc$>        WHEN OTHERS THEN
ora_proc$>          RETURN NULL;
ora_proc$>    END ;
ora_proc$> /
CREATE FUNCTION