CREATE PROCEDURE

功能描述

创建一个新的存储过程。

注意事项

  • 如果创建存储过程时参数或返回值带有精度,不进行精度检测。
  • 创建存储过程时,存储过程定义中对表对象的操作建议都显示指定模式,否则可能会导致存储过程执行异常。
  • 在创建存储过程时,存储过程内部通过SET语句设置current_schema和search_path无效。执行完函数search_path和current_schema与执行函数前的search_path和current_schema保持一致。
  • 如果存储过程参数中带有出参,SELECT调用存储过程必须缺省出参,CALL调用存储过程调用非重载函数时必须指定出参,对于重载的package函数,out参数可以缺省,具体信息参见CALL的示例。
  • 存储过程指定package属性时支持重载。
  • 在创建procedure时,不能在avg函数外面嵌套其他agg函数,或者其他系统函数。
  • 在存储过程内部调用其它无参数的存储过程时,可以省略括号,直接使用存储过程名进行调用。
  • 存储过程支持参数注释的查看与导出、导入。
  • 存储过程支持介于IS/AS与plsql_body之间的注释的查看与导出、导入。

语法格式

  1. CREATE [ OR REPLACE ] PROCEDURE procedure_name
  2. [ ( {[ argmode ] [ argname ] argtype [ { DEFAULT | := | = } expression ]}[,...]) ]
  3. [
  4. { IMMUTABLE | STABLE | VOLATILE }
  5. | { SHIPPABLE | NOT SHIPPABLE }
  6. | {PACKAGE}
  7. | [ NOT ] LEAKPROOF
  8. | { CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT }
  9. | {[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER | AUTHID DEFINER | AUTHID CURRENT_USER}
  10. | COST execution_cost
  11. | SET configuration_parameter { TO value | = value | FROM CURRENT }
  12. ][ ... ]
  13. { IS | AS }
  14. plsql_body
  15. /

参数说明

  • OR REPLACE

    当存在同名的存储过程时,替换原来的定义。

  • procedure_name

    创建的存储过程名称,可以带有模式名。

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

  • argmode

    参数的模式。

    CREATE PROCEDURE - 图1 须知: VARIADIC用于声明数组类型的参数。

    取值范围: IN、OUT、INOUT或VARIADIC。缺省值是IN。只有OUT模式的参数能跟在VARIADIC参数之后。

  • argname

    参数的名称。

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

  • argtype

    参数的数据类型。可以使用%TYPE或%ROWTYPE间接引用变量或表的类型,详细可参考存储过程章节定义变量

    取值范围:可用的数据类型。

  • configuration_parameter

    • value

      把指定的配置参数设置为给定的值。如果value是DEFAULT,则在新的会话中使用系统的缺省设置。OFF关闭设置。

      取值范围:字符串

      • DEFAULT
      • OFF
      • 指定默认值。
    • from current

      取当前会话中的值设置为configuration_parameter的值。

  • IMMUTABLE、STABLE

    行为约束可选项。各参数的功能与CREATE FUNCTION类似,详细说明见CREATE FUNCTION

  • plsql_body

    PL/SQL存储过程体。

    CREATE PROCEDURE - 图2 须知: 当在存储过程体中进行创建用户等涉及用户密码相关操作时,系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。

CREATE PROCEDURE - 图3 说明: argument_name和argmode的顺序没有严格要求,推荐按照argument_name、argmode、argument_type的顺序使用。

相关链接

DROP PROCEDURE

优化建议

  • analyse | analyze
    • 不支持在事务或匿名块中执行analyze 。
    • 不支持在函数或存储过程中执行analyze操作。