CREATE PACKAGE

功能描述

创建一个新的PACKAGE。

注意事项

在package specification中声明过的函数或者存储过程，必须在package body中找到定义。
在实例化中，无法调用带有commit/rollback的存储过程。
不能在Trigger中调用package函数。
不能在外部SQL中直接使用package当中的变量。
不允许在package外部调用package的私有变量和存储过程。
不支持其它存储过程不支持的用法，例如，在function中不允许调用commit/rollback，则package的function中同样无法调用commit/rollback。
不支持schema与package同名。
只支持Oracle风格的存储过程和函数定义。
不支持package内有同名变量，包括包内同名参数。
package的全局变量为session级，不同session之间package的变量不共享。
package中不支持声明ref cursor变量。
package默认为SECURITY INVOKER权限，如果想将默认行为改为SECURITY DEFINER权限，需要设置GUC参数behavior_compat_options=“plsql_security_definer”。
被授予CREATE ANY PACKAGE权限的用户，可以在public模式和用户模式下创建PACKAGE。
如果需要创建带有特殊字符的package名，特殊字符中不能含有空格，并且最好设置GUC参数behavior_compat_options=“skip_insert_gs_source”，否则可能引起报错。
允许创建package时忽略依赖关系进行创建，并对未定义的类型/存储过程/函数/包变量提供告警功能，需要设置guc参数behavior_compat_options='plpgsql_dependency'。

语法格式

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 CURRENT_USER，分别为定义者权限和调用者权限。
- item_list_1可以为声明的变量或者存储过程以及函数。
- ACKAGE 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，详见示例。

参数说明

OR REPLACE

当存在同名的PACKAGE时，替换原来的定义。
package_name

创建的PACKAGE名称，可以带有模式名。

取值范围：字符串，要符合标识符的命名规范。
invoker_rights_clause

可以被声明为AUTHID DEFINER或者AUTHID CURRENT_USER，分别为定义者权限和调用者权限。
item_list_1

声明的变量、存储过程、函数等。
declare_section

声明部分，PACKAGE SPECIFICATION中声明的变量、存储过程、函数的具体定义。
initialize_section

初始化变量并设置一次性的步骤。首次引用包时，对于每个会话包初始化部分中的语句会执行一次。

示例

CREATE PACKAGE SPECIFICATION示例。

CREATE OR REPLACE PACKAGE emp_bonus IS
var1 int:=1;--公有变量
var2 int:=2;
PROCEDURE testpro1(var3 int);--公有存储过程，可以被外部调用
END ;
/

CREATE PACKAGE BODY示例。

drop table if exists test1;
create or replace package body emp_bonus is
var3 int:=3;
var4 int:=4;
procedure testpro1(var3 int)
is
begin
create table if not exists test1(col1 int);
insert into test1 values(var1);
insert into test1 values(var4);
end;
begin  --实例化开始
var4:=9;
testpro1(var4);
end;
end;
/

调用PACKAGE示例。

call emp_bonus.testpro1(1); --使用call调用package存储过程
select emp_bonus.testpro1(1); --使用select调用package存储过程
--匿名块里调用package存储过程
begin
emp_bonus.testpro1(1);
end;
/

VastbaseG100

CREATE PACKAGE

功能描述

注意事项

语法格式

参数说明

示例

弹框头部