兼容性功能

由于数据库的兼容性差异，在不同兼容性设置或GUC参数下，存储过程的行为可能不一致。用户在使用这些兼容性功能时，应谨慎操作。例如：

• 由于不同兼容性的原因，带出参的FUNCTION在某些情况下可能忽略出参值。开启GUC参数 behavior_compat_options='proc_outparam_override' 后，部分场景可以确保出参值和返回值的正确返回。然而，由于此功能在不同兼容性设置下的行为存在差异，建议避免使用带出参的FUNCTION，改用带出参的PROCEDURE。

  gaussdb=# create schema best_practices_for_procedure;
  CREATE SCHEMA
  --创建带出参的function。
  gaussdb=# create or replace function best_practices_for_procedure.func (a out int, b out int) return int as --仅做示例，不推荐使用。
  c int;
  begin
  a := 1;
  b := 2;
  c := 3;
  return c;
  end;
  /
  CREATE FUNCTION
  --调用带出参的function，发现参数a，b并未赋值。
  gaussdb=# declare
  a int;
  b int;
  c int;
  begin
  c := best_practices_for_procedure.func(a, b);
  dbe_output.print_line('a := ' || a || ' b := ' || b || ' c := ' || c);
  end;
  /
  a :=  b :=  c := 3
  ANONYMOUS BLOCK EXECUTE
  --设置GUC参数。
  gaussdb=# set behavior_compat_options='proc_outparam_override';
  SET
  --再次调用带出参的function，参数a，b，c均被赋值。
  gaussdb=# declare
  a int;
  b int;
  c int;
  begin
  c := best_practices_for_procedure.func(a, b);
  dbe_output.print_line('a := ' || a || ' b := ' || b || ' c := ' || c);
  end;
  /
  a := 1 b := 2 c := 3
  ANONYMOUS BLOCK EXECUTE
  --推荐使用带出参的存储过程来替代带出参的函数，可将上述函数改写为下面的存储过程。
  gaussdb=# reset behavior_compat_options;
  gaussdb=# create or replace procedure best_practices_for_procedure.proc (a out int, b out int, c out int) as
  begin
  a := 1;
  b := 2;
  c := 3;
  end;
  /
  CREATE PROCEDURE
  gaussdb=# declare
  a int;
  b int;
  c int;
  begin
  best_practices_for_procedure.proc(a, b, c);
  dbe_output.print_line('a := ' || a || ' b := ' || b || ' c := ' || c);
  end;
  /
  a := 1 b := 2 c := 3
  ANONYMOUS BLOCK EXECUTE
  gaussdb=# drop schema best_practices_for_procedure cascade;
  NOTICE:  drop cascades to 2 other objects
  DETAIL:  drop cascades to function best_practices_for_procedure.func()
  drop cascades to function best_practices_for_procedure.proc()
  DROP SCHEMA

• 在动态语句中，如果占位符名称重复，不同数据库的兼容性设置可能导致其绑定到不同的变量，从而影响预期行为。开启GUC参数 behavior_compat_options='dynamic_sql_compat' 后，可以使用同名占位符绑定不同变量。然而，由于此功能在不同兼容性设置下的行为存在差异，建议避免使用同名占位符。

  gaussdb=# create schema best_practices_for_procedure;
  CREATE SCHEMA
  gaussdb=# create table best_practices_for_procedure.tb1 (a int, b int);
  CREATE TABLE
  --创建使用动态语句的存储过程，使用相同占位符绑定相同变量。
  gaussdb=# create or replace procedure best_practices_for_procedure.pro_dynexecute() as
  a int := 1;
  b int := 2;
  begin
  execute immediate 'insert into best_practices_for_procedure.tb1 values(:1, :1),(:2, :2);' using in a, in b;
  end;
  /
  CREATE PROCEDURE
  gaussdb=# call best_practices_for_procedure.pro_dynexecute();
   pro_dynexecute
  ----------------
  
  (1 row)
  
  --查看表发现相同占位符绑定的是相同的变量。
  gaussdb=# select *from best_practices_for_procedure.tb1;
   a | b
  ---+---
   1 | 1
   2 | 2
  (2 rows)
  
  --设置GUC参数。
  gaussdb=# set behavior_compat_options='dynamic_sql_compat';
  SET
  gaussdb=# truncate table best_practices_for_procedure.tb1;
  TRUNCATE TABLE
  --创建使用动态语句的存储过程，使用相同占位符绑定不同变量。
  gaussdb=# create or replace procedure best_practices_for_procedure.pro_dynexecute() as
  a int := 1;
  b int := 2;
  c int := 3;
  d int := 4;
  begin
  execute immediate 'insert into best_practices_for_procedure.tb1 values(:1, :1),(:2, :2);' using in a, in b, in c, in d;
  end;
  /
  CREATE PROCEDURE
  gaussdb=# call best_practices_for_procedure.pro_dynexecute();
   pro_dynexecute
  ----------------
  
  (1 row)
  
  --设置guc参数后调用函数，相同占位符可以绑定不同变量。
  gaussdb=# select * from best_practices_for_procedure.tb1;
   a | b
  ---+---
   1 | 2
   3 | 4
  (2 rows)
  
  gaussdb=# reset behavior_compat_options;
  RESET
  gaussdb=# drop schema best_practices_for_procedure cascade;
  NOTICE:  drop cascades to 2 other objects
  DETAIL:  drop cascades to table best_practices_for_procedure.tb1
  drop cascades to function best_practices_for_procedure.pro_dynexecute()
  DROP SCHEMA