平台和客户端兼容性

enable_set_variables

set语法增强控制开关。

• 不设置此配置时，不支持set自定义变量、set [global | session]语法。
• 设置此配置时，支持B兼容模式下使用上述语法，比如 set @v1 = 1；。

set_session_transaction

set session transaction控制开关。

• 不设置此配置时，set session transaction等效于set local transaction。
• 设置此配置时，支持B兼容模式下使用上述语法，修改当前会话事务特性。

enable_modify_column

ALTER TABLE MODIFY语义控制开关。

• 不设置此配置时，“ALTER TABLE table_name MODIFY column_name data_type;”只修改列的数据类型。
• 设置此配置时，“ALTER TABLE table_name MODIFY column_name data_type;”修改整个列定义。

default_collation

默认字符序前向兼容开关。

• 不设置此配置时，在未显式指定字符类型字段的字符集或字符序且表级字符序也为空时，字段为default字符序。
• 设置此配置时，字符类型字段的字符序当表级字符序不为空时继承表级字符序，为空时设置为数据库编码对应的默认字符序。

fetch

FETCH语句结尾报错兼容开关。

• 不设置此配置时，FETCH抓取完了所有可用行，它就停在最后一行后面，或者在反向抓取的情况下是停在第一行前面。
• 设置此配置时，FETCH抓取完了所有可用行后报错。

enable_multi_charset

多字符集功能的控制开关。

• 不设置此配置时，不允许不同于数据库字符集的数据，不处理不同于数据库字符集的表达式。
• 设置此配置时，允许数据库中含有不同于数据库字符集的数据，合并不同字符集的表达式。不同字符集的表达式运算规则详见：字符集与字符序。

diagnostics

GET DIAGNOSTICS兼容开关。

• 不设置此配置时，GET DIAGNOSTIC语法按原有实现。
• 设置此配置时，GET DIAGNOSTIC语法按MySQL兼容语法实现。

display_leading_zero

浮点数显示配置项。控制数值类型中浮点类型、任意精度类型的小数点前零显示。并且length计算数字长度同步显示。

• 不设置此配置项时，对于-1~0和0~1之间的小数，不显示小数点前的0。比如：

  openGauss=# select 0.1231243 as a, 0.1231243::numeric as b,0.1231243::integer(10,3) as c, length(0.1242343) as d;
      a     |    b     |  c   | d
  ----------+----------+------+---
   .1231243 | .1231243 | .123 | 8
  (1 row)

• 设置此配置项时，对于-1~0和0~1之间的小数，显示小数点前的0。比如：

  openGauss=# select 0.1231243 as a, 0.1231243::numeric as b,0.1231243::integer(10,3) as c, length(0.1242343) as d;
       a     |     b     |   c   | d
  -----------+-----------+-------+---
   0.1231243 | 0.1231243 | 0.123 | 9
  (1 row)

end_month_calculate

add_months函数计算逻辑配置项。

假定函数add_months的两个参数分别为param1和param2，param1的月份和param2的和为月份result。

• 不设置此配置项时，如果param1的日期（Day字段）为月末，并且param1的日期（Day字段）比result月份的月末日期小，计算结果中的日期字段（Day字段）和param1的日期字段保持一致。比如，

openGauss=# select add_months('2018-02-28',3) from sys_dummy;
add_months
\---------------------\
2018-05-28 00:00:00
(1 row)

• 设置此配置项时，如果param1的日期（Day字段）为月末，并且param1的日期（Day字段）比result月份的月末日期比小，计算结果中的日期字段（Day字段）和result的月末日期保持一致。比如，

openGauss=# select add_months('2018-02-28',3) from sys_dummy;
add_months
\---------------------\
2018-05-31 00:00:00
(1 row)

compat_analyze_sample

analyze采样行为配置项。

设置此配置项时，会优化analyze的采样行为，主要体现在analyze时全局采样会更精确的控制在3万条左右，更好的控制analyze时DBnode端的内存消耗，保证analyze性能的稳定性。

bind_schema_tablespace

绑定模式与同名表空间配置项。

如果存在与模式名sche_name相同的表空间名，那么如果设置search_path为sche_name， default_tablespace也会同步切换到sche_name。

bind_procedure_searchpath

未指定模式名的数据库对象的搜索路径配置项。

在存储过程中如果不显示指定模式名，会优先在存储过程所属的模式下搜索。

如果找不到，则有两种情况：

• 若不设置此参数，报错退出。
• 若设置此参数，按照search_path中指定的顺序继续搜索。如果还是找不到，报错退出。

correct_to_number

控制to_number()结果兼容性的配置项。

若设置此配置项，则to_number()函数结果与pg11保持一致，否则默认与O db保持一致。

unbind_divide_bound

控制对整数除法的结果进行范围校验。

若设置此配置项，则不需要对除法结果做范围校验，例如，INT_MIN/(-1)可以得到输出结果为INT_MAX+1，反之，则会因为超过结果大于INT_MAX而报越界错误。

return_null_string

控制函数lpad()和rpad()结果为空字符串''的显示配置项。

• 不设置此配置项时，空字符串显示为NULL。

postgres=# select length(lpad('123',0,'*')) from sys_dummy;
length
\--------\
(1 row)

• 设置此配置项时，空字符串显示为''。

postgres=# select length(lpad('123',0,'*')) from sys_dummy;
length
\--------\
0
(1 row)

compat_concat_variadic

控制函数concat()和concat_ws()对variadic类型结果兼容性的配置项。

若设置此配置项，当concat函数参数为variadic类型时，保留a db和Teradata兼容模式下不同的结果形式；否则默认a db和Teradata兼容模式下结果相同，且与a db保持一致。由于MY无variadic类型，所以该选项对MY无影响。

merge_update_multi

控制在使用MERGE INTO ... WHEN MATCHED THEN UPDATE（参考MERGE INTO）和INSERT ... ON DUPLICATE KEY UPDATE（参考INSERT）时，当目标表中一条目标数据与多条源数据冲突时UPDATE行为。

若设置此配置项，当存在上述场景时，该冲突行将会多次执行UPDATE；否则（默认）报错，即MERGE或INSERT操作失败。

plstmt_implicit_savepoint

控制存储过程中更新语句的执行是否拥有独立的子事务。

若设置此配置项，存储过程中每条更新语句前开启隐式保存点，EXCEPTION块中默认回退到最近的保存点，从而保证只回退失败语句的修改。该选项是为了兼容O数据库的EXCEPTION行为。

hide_tailing_zero

numeric显示配置项。不设置此项时，numeric按照指定精度显示。设置此项时，所有输出numeric的场景均隐藏小数点后的末尾0，包括显示指定format精度情况。

openGauss=# set behavior_compat_options='hide_tailing_zero';
openGauss=# select cast(123.123 as numeric(15,10)) as a, to_char(cast(123.123 as numeric(15,10)), '999D999999');
    a    | to_char
---------+----------
 123.123 |  123.123
(1 row)
openGauss=# set behavior_compat_options='';
openGauss=# select cast(123.123 as numeric(15,10)) as a, to_char(cast(123.123 as numeric(15,10)), '999D999999');
       a        |   to_char
----------------+-------------
 123.1230000000 |  123.123000
(1 row)

rownum_type_compat

控制ROWNUM的类型，ROWNUM默认类型为INT8，设置此参数后，ROWNUM类型变更为NUMERIC类型。

aformat_null_test

控制rowtype类型判空逻辑,设置此项时，对于rowtype is not null判断，当一行数据有一列不为空的时候返回ture。

否则，对于rowtype is not null判断，当一行数据所有列不为空的时候返回ture.

aformat_regexp_match

控制正则表达式函数的匹配行为。

否则，正则表达式的 flags 参数支持的选项含义：

1. . 默认能匹配 '\n' 字符。
2. flags 中的 n 选项表示按照多行模式匹配。
3. regexp_replace(source, pattern replacement) 函数仅替换第一个匹配到的子串。
4. regexp_replace(source, pattern, replacement, flags) 在 flags值为'' 或者null时，返回值为替换后的字符串。

compat_cursor

控制隐式游标状态兼容行为。设置此项，且兼容O，隐式游标状态（SQL%FOUND、SQL%NOTFOUND、SQL%ISOPNE、SQL%ROWCOUNT）由原先的仅在当前执行的函数有效，拓展到包括本函数调用的子函数有效。

proc_outparam_override

控制存储过程出参的重载行为，打开该参数后，对于存储过程只有out出参部分不同的情况下，也可以正常调用。

proc_implicit_for_loop_variable

控制存储过程中FOR_LOOP查询语句行为设置此项时，在FOR rec IN query LOOP语句中，若rec已经定义，不会复用已经定义的rec变量，而且重新建立一个新的变量。否则，会复用已经定义的rec变量，不会建立新的变量。

allow_procedure_compile_check

控制存储过程中select语句和open cursor语句的编译检查设置此项时，在存储过程中执行select语句、open cursor for语句、cursor%rowtype语句、for rec in语句时，若查询的表不存在，则无法创建创建存储过程，不支持trigger函数的编译检查，若查询的表存在，则成功创建存储过程。

char_coerce_compat

控制char(n)类型向其它变长字符串类型转换时的行为，以及char(n)和varchar操作时的行为。默认情况下char(n)类型转换其它变长字符串类型时会省略尾部的空格，开启该参数后，转换时不再省略尾部的空格，并且在转换时如果char(n)类型的长度超过其它变长字符串类型时将会报错；开启该参数后，char(n)和varchar操作时，例如比较操作符，首先各自转换为text类型再进行操作，具体表现为在操作时不会忽略尾部空格，如' '::char(5)和' '::varchar(5)不相等。该参数仅在sql_compatibility参数的值为A时生效。

truncate_numeric_tail_zero

numeric显示配置项。不设置此项时，numeric按照默认精度显示。设置此项时，除去to_char(numeric, format)这种显示设置精度的情况，所有输出numeric的场景均会隐藏小数点后的末尾0。例如：

openGauss=# set behavior_compat_options='truncate_numeric_tail_zero';
openGauss=# select cast(123.123 as numeric(15,10)) as a, to_char(cast(123.123 as numeric(15,10)), '999D999999');
    a    |   to_char
---------+-------------
 123.123 |  123.123000
(1 row)
openGauss=# set behavior_compat_options='';
openGauss=# select cast(123.123 as numeric(15,10)) as a, to_char(cast(123.123 as numeric(15,10)), '999D999999');
       a        |   to_char
----------------+-------------
 123.1230000000 |  123.123000
(1 row)

pgformat_substr

控制substr(str, from, for)在不同场景下的表现。默认情况下，当from小于0时，substr将从字符串尾部开始计数；当for小于1时，substr将返回NULL。开启该参数后，当from小于0时，将从字符串的第一位的前(-from + 1)位开始计数；当for小于0时，substr将报错。该参数仅在sql_compatibility参数的值为PG时生效。

plpgsql_dependency

开启此参数后，创建函数，存储过程，包支持未定义的对象。可以新建成功。可以在GS_DEPENDENCIES和GS_DEPENDENCIES_OBJ查询对应的依赖关系。

开启此参数后，创建PLSQL对象时，会主动维护依赖于该PLSQL对象的OID，不再需要用户手动更新。

注意: 1.在并发创建PLSQL对象时，如果需要维护的对象间存在竞争关系，可能会造成死锁。 2.在调用失效的PLSQL对象时，自动执行一个自治事务对PLSQL对象重编译，重编译有效时会修改pg_object表的valid字段为true，回滚调用PLSQL对象的事务不会回滚自治事务中的重编译语句，包括对pg_object表的valid字段的修改。 3.当修改对象在gs_dependencies和gs_dependencies_obj中存在时，不允许进行rename操作。

注意：该参数只支持distinct，不支持distinct on，且当 DOLPHIN 插件存在时不生效，转由 dolphin.sql_mode 参数控制。dolphin.sql_mode 未设置 sql_mode_full_group 选项时相当于打开此选项。

accept_empty_str

在A兼容模式下，关闭此参数后，openGauss处理空字符串时会当做NULL处理；反之则正常接受空字符串。例如：

openGauss=# set behavior_compat_options='accept_empty_str';
openGauss=# select '' is null;
 ?column? 
----------
 f
(1 row)
openGauss=# set behavior_compat_options='';
openGauss=# select '' is null;
 ?column? 
----------
 t
(1 row)

openGauss=# create table test1(c1 int, c2 varchar);
openGauss=# insert into test1 values(2, '1.1');
openGauss=# set behavior_compat_options = '';
openGauss=# select * from test1 where c2 > 1;
ERROR:  invalid input syntax for type bigint: "1.1"
openGauss=# set behavior_compat_options = 'convert_string_digit_to_numeric';
openGauss=# select * test1 from where c2 > 1;
 c1 | c2  
----+-----
  2 | 1.1
(1 row)

openGauss=# create table t1(father int, son int);
CREATE TABLE
openGauss=# insert into t1 values(0,1),(1, 2), (2, 3);
INSERT 0 3
openGauss=# create or replace function prior(id int) returns int
openGauss-#         LANGUAGE plpgsql AS $$
openGauss$#         begin
openGauss$#         raise info 'invoke prior function';
openGauss$#         return id*3;
openGauss$#         end;
openGauss$#         $$;
CREATE FUNCTION
openGauss=# select prior son as father, son from t1 where prior(son) = 6 start with son = 1 connect by prior son = father;
 father | son
--------+-----
(0 rows)
openGauss=# set behavior_compat_options = 'prior_function_first';
SET
openGauss=# select prior son as father, son from t1 where prior(son) = 6 start with son = 1 connect by prior son = father;
INFO:  invoke prior function
INFO:  invoke prior function
INFO:  invoke prior function
father | son
——--+—--
1 |   2
(1 row)

disable_record_type_in_dml

禁止虚拟列插入配置项。开启此项后禁止在insert语句中使用record类型变量作为插入值。

create table t1(col1 varchar(10),col varchar(10));
create table t2(col1 varchar(10),col varchar(10));
set behavior_compat_options='disable_record_type_in_dml';
insert into t1 values('one','two');
declare
  cursor cur1 is select * from t1;
  source cur1%rowtype:=('ten','wtu');
begin
  for source in cur1
  loop
    raise notice '%',source;
    insert into t2 values(source);
  end loop; 
end;
/
ERROR:  The record type variable cannot be used as an insertion value.
CONTEXT:  SQL statement "insert into t2 values(source)"
PL/pgSQL function inline_code_block line 7 at SQL statement
set behavior_compat_options='';
insert into t1 values('one','two');
declare
cursor cur1 is select * from t1;
source cur1%rowtype:=('ten','wtu');
begin
for source in cur1
loop
raise notice '%',source;
insert into t2 values(source);
end loop;
end;
/
NOTICE:  (one,two)
NOTICE:  (one,two)

openGauss=# create table t1(c1 int);
CREATE TABLE
openGauss=#
openGauss=# insert into t1 values ('1.5');
ERROR:  invalid input syntax for integer: "1.5"
LINE 1: insert into t1 values ('1.5');
                               ^
CONTEXT:  referenced column: c1
openGauss=#
openGauss=# set behavior_compat_options ='accept_float_str_as_int';
SET
openGauss=# insert into t1 values ('1.5');
INSERT 0 1