语句
- 执行语句之前,请分别设置以下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所示。
| 语句 | 说明 |
|---|---|
| 用于组织一组原子性操作,可包含空语句或执行多个子语句。 | |
| 用于判断参数或者语句是否满足自定义的条件,根据判定结果执行相应的操作的语句。 | |
| 用于反复执行指定操作的语句。 | |
| 用于在指定条件下,循环执行指定操作的语句。 | |
| 用于按照指定的次数执行循环,在循环内部可以执行重复的查询操作的语句。 | |
| 用于循环游标的执行结果的语句。 | |
| 用于循环SELECT语句的查询结果的语句。 | |
| 用于控制调整循环执行流程的语句,EXIT表示立即终止当前循环,CONTINUE表示继续执行下一次循环。 | |
| 用于将存储过程或函数返回结果赋值给调用者的语句。 | |
| 用于为变量赋值的语句。 | |
| 用于执行SQL操作的语句。 | |
| 用于在存储过程中调用存储过程的语句。 | |
| 用于允许程序根据特定条件执行不同的语句。 | |
| 用于说明“不用进行任何操作”的场景的语句,相当于一个占位符。 | |
| 用于在数据集上执行并行操作的语句,是一种并行化的循环操作。 | |
| 用于获取最后一次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
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