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

语句

  • 执行语句之前,请分别设置以下GUC参数:
    SET plsql_code_type=BYTECODE;
    SET behavior_compat_options='compat_cursor,allow_procedure_compile_check,proc_outparam_override,dynamic_sql_compat,proc_outparam_transfer_length,varray_compat';
  • 该章节中的示例可根据字节码相关DFX章节介绍,判断存储过程是否通过字节码框架进行执行。

当前字节码支持的语句场景如表1所示。

表1 字节码支持的表语句场景

语句

说明

块语句(BLOCK)

用于组织一组原子性操作,可包含空语句或执行多个子语句。

条件语句

用于判断参数或者语句是否满足自定义的条件,根据判定结果执行相应的操作的语句。

LOOP语句

用于反复执行指定操作的语句。

WHILE语句

用于在指定条件下,循环执行指定操作的语句。

FOR_LOOP(INT变量)语句

用于按照指定的次数执行循环,在循环内部可以执行重复的查询操作的语句。

FOR_LOOP(CURSOR变量)语句

用于循环游标的执行结果的语句。

FOR_LOOP(SELECT)语句

用于循环SELECT语句的查询结果的语句。

退出/继续语句(EXIT/CONTINUE)

用于控制调整循环执行流程的语句,EXIT表示立即终止当前循环,CONTINUE表示继续执行下一次循环。

返回语句(仅RETURN,不支持RETURN QUERY/NEXT)

用于将存储过程或函数返回结果赋值给调用者的语句。

赋值语句

用于为变量赋值的语句。

执行 SQL 语句(仅支持简单表达式语句,其他场景支持部分退化为非字节码执行)

用于执行SQL操作的语句。

调用语句

用于在存储过程中调用存储过程的语句。

分支语句

用于允许程序根据特定条件执行不同的语句。

空语句

用于说明“不用进行任何操作”的场景的语句,相当于一个占位符。

FORALL批量查询语句(不带SAVE EXCEPTIONS场景)

用于在数据集上执行并行操作的语句,是一种并行化的循环操作。

GET DIAGNOSTICS语句

用于获取最后一次SQL操作的状态信息、影响行数、错误信息等诊断数据的语句。

块语句(BLOCK)

用于组织一组原子性操作,可包含空语句或执行多个子语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_block AS
BEGIN
  NULL;
  EXCEPTION WHEN others THEN 
    RAISE INFO '%', 'exception';
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_block();
 bc_block 
----------

(1 row)

gaussdb=# DROP PROCEDURE bc_block();
DROP PROCEDURE
返回语句的错误会被EXCEPTION子句捕获。
gaussdb=# CREATE OR REPLACE FUNCTION func RETURN INT AS
BEGIN
	RETURN 'abc';
	EXCEPTION WHEN OTHERS THEN
	RETURN 123;
END;
/
CREATE FUNCTION
gaussdb=# SELECT func();
 func 
------
  123
(1 row)

gaussdb=# DROP FUNCTION IF EXISTS func;
DROP FUNCTION

条件语句

用于判断参数或者语句是否满足自定义的条件,根据判定结果执行相应的操作的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_if(i int, j int) AS
BEGIN
  IF i>j THEN 
     DBE_OUTPUT.PRINT_LINE('i is bigger');
  ELSE 
     DBE_OUTPUT.PRINT_LINE('j is bigger');
  END IF;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_if(1,2);
j is bigger
 bc_if 
-------

(1 row)

gaussdb=# DROP PROCEDURE bc_if();
DROP PROCEDURE

LOOP语句

用于反复执行指定操作的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_loop(i int, count int) AS
BEGIN
  LOOP
    IF count > i THEN
      RAISE INFO 'count is %',count;
      EXIT;
    END IF;
  END LOOP;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_loop(1,2);
INFO:  count is 2
 bc_loop 
---------

(1 row)

gaussdb=# DROP PROCEDURE bc_loop();
DROP PROCEDURE

WHILE语句

用于在指定条件下,循环执行指定操作的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_while_loop(maxval integer) 
AS 
  i int := 1;
BEGIN
  WHILE i < maxval LOOP
     RAISE INFO '%', i;
     i := i + 1;
  END LOOP;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_while_loop(2);
INFO:  1
 bc_while_loop 
---------------

(1 row)

gaussdb=# DROP PROCEDURE bc_while_loop();
DROP PROCEDURE

FOR_LOOP(INT变量)语句

用于按照指定的次数执行循环,在循环内部可以执行重复的查询操作的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_fori AS
BEGIN
  FOR i in 0..2 LOOP
    RAISE INFO '%', i;
  END LOOP;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_fori();
INFO:  0
INFO:  1
INFO:  2
 bc_fori 
---------

(1 row)

gaussdb=# DROP PROCEDURE bc_fori();
DROP PROCEDURE

FOR_LOOP(CURSOR变量)语句

用于循环游标的执行结果的语句。

gaussdb=# CREATE TABLE t1(a int);
CREATE TABLE
gaussdb=# INSERT INTO t1 VALUES(10);
INSERT 0 1
gaussdb=# CREATE OR REPLACE PROCEDURE bc_forc AS
  CURSOR cur FOR select * from t1;
BEGIN
  FOR i IN cur LOOP
   RAISE INFO '%', i;
  END LOOP;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_forc();
INFO:  (10)
 bc_forc 
---------

(1 row)

gaussdb=# DROP TABLE t1;
DROP TABLE
gaussdb=# DROP PROCEDURE bc_forc();
DROP PROCEDURE

FOR_LOOP(SELECT)语句

用于循环SELECT语句的查询结果的语句。

gaussdb=# CREATE TABLE t1(a int);
CREATE TABLE
gaussdb=# INSERT INTO t1 VALUES(1),(10);
INSERT 0 2
gaussdb=# CREATE OR REPLACE PROCEDURE bc_fors AS
   record varchar(20);
BEGIN
     FOR record IN SELECT a FROM t1 LOOP
        RAISE INFO '%', record;
     END LOOP;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_fors();
INFO:  1
INFO:  10
 bc_fors 
---------

(1 row)

gaussdb=# DROP TABLE t1;
DROP TABLE
gaussdb=# DROP PROCEDURE bc_fors();
DROP PROCEDURE

退出/继续语句(EXIT/CONTINUE)

用于控制调整循环执行流程的语句,EXIT表示立即终止当前循环,CONTINUE表示继续执行下一次循环。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_loop(i int) AS
DECLARE
count int := 1;
BEGIN
  LOOP
    IF count = i THEN
      
      count := i + 1;
      CONTINUE;
    END IF;
    IF count > i THEN
      RAISE INFO 'count is %',count;
      EXIT;
    END IF;
  END LOOP;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_loop(1);
INFO:  count is 2
 bc_loop 
---------

(1 row)
gaussdb=# DROP PROCEDURE bc_loop();
DROP PROCEDURE

返回语句(仅RETURN,不支持RETURN QUERY/NEXT)

用于将存储过程或函数返回结果赋值给调用者的语句。

gaussdb=# CREATE OR REPLACE FUNCTION bc_return() RETURN VOID
IS
BEGIN
  NULL;
END;
/
CREATE FUNCTION
gaussdb=# SELECT bc_return();
 bc_return 
-----------

(1 row)

gaussdb=# DROP PROCEDURE bc_return();
DROP PROCEDURE

赋值语句

用于为变量赋值的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_assign AS
  a int;
BEGIN
  a := 1;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_assign();
 bc_assign 
-----------

(1 row)

gaussdb=# DROP PROCEDURE bc_assign();
DROP PROCEDURE

执行 SQL 语句(仅支持简单表达式语句,其他场景支持部分退化为非字节码执行)

用于执行SQL操作的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_execsql AS
   b int;
BEGIN
  select 1 into b;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_execsql();
 bc_execsql 
------------

(1 row)

gaussdb=# DROP PROCEDURE bc_execsql();
DROP PROCEDURE

调用语句

用于在存储过程中调用存储过程的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_perform1 AS
BEGIN
  NULL;
END;
/
CREATE PROCEDURE
gaussdb=# CREATE OR REPLACE PROCEDURE bc_perform2 AS
BEGIN
  bc_perform1();
END;
/
gaussdb=#  CALL bc_perform2();
 bc_perform2
-------------

(1 row)

gaussdb=# DROP PROCEDURE bc_perform1();
DROP PROCEDURE
gaussdb=# DROP PROCEDURE bc_perform2();
DROP PROCEDURE

分支语句

用于允许程序根据特定条件执行不同的语句。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_case(pi_result int, pi_return out int) AS
BEGIN
  CASE pi_result
    WHEN 1 THEN
      pi_return := 111;
    WHEN 2 THEN 
      pi_return := 222;
    ELSE  
      pi_return := 999;
   END CASE;
   RAISE INFO '%', pi_return;  
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_case(3,3);
INFO:  999
 pi_return 
-----------
       999
(1 row)

gaussdb=# DROP PROCEDURE bc_case();
DROP PROCEDURE

空语句

用于说明“不用进行任何操作”的场景的语句,相当于一个占位符。

gaussdb=# CREATE OR REPLACE PROCEDURE bc_null AS
BEGIN
  NULL;
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_null();
 bc_null 
---------

(1 row)

gaussdb=# DROP PROCEDURE bc_null();
DROP PROCEDURE

FORALL批量查询语句(不带SAVE EXCEPTIONS场景)

用于在数据集上执行并行操作的语句,是一种并行化的循环操作。

gaussdb=# CREATE TABLE t1(a int);
CREATE TABLE
gaussdb=# CREATE OR REPLACE PROCEDURE bc_forall AS
BEGIN
  FORALL i IN 1..2
    INSERT INTO t1 VALUES (1);
END;
/
CREATE PROCEDURE
gaussdb=# CALL bc_forall();
 bc_forall 
-----------

(1 row)

gaussdb=# DROP TABLE t1;
DROP TABLE
gaussdb=# DROP PROCEDURE bc_forall();
DROP PROCEDURE

GET DIAGNOSTICS语句

用于获取最后一次SQL操作的状态信息、影响行数、错误信息等诊断数据的语句。

gaussdb=# CREATE TABLE diag_table(int_col int, str_col varchar2);
CREATE TABLE
gaussdb=# CREATE OR REPLACE PROCEDURE get_diag_proc() AS
DECLARE
    nrows INT;
    result_oid oid;
    sql_state text;
    message_text text;
    pg_exception_detail text;
    pg_exception_hint text;
    pg_exception_context text;
BEGIN
    UPDATE diag_table SET int_col = 'aaa';
    exception when others then
        get current diagnostics nrows = row_count;
        get current diagnostics result_oid = result_oid;
        get stacked diagnostics sql_state = returned_sqlstate;
        get stacked diagnostics message_text = message_text;
        get stacked diagnostics pg_exception_detail = pg_exception_detail;
        get stacked diagnostics pg_exception_hint = pg_exception_hint;
        get stacked diagnostics pg_exception_context = pg_exception_context;
END;
/
CREATE PROCEDURE
gaussdb=# CALL get_diag_proc();
 get_diag_proc
---------------

(1 row)
gaussdb=# DROP TABLE diag_table;
DROP TABLE
gaussdb=# DROP PROCEDURE get_diag_proc();
DROP PROCEDURE

相关文档