平台和客户端兼容性

default_collation

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

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

all

打开所有语法控制开关。

all不能同时和其他配置项一起指定。表格中除all外所有配置项逗号隔开的含义和取值为all含义相同。

grant_database_nomapping

M-Compatibility模式数据库下GRANT | REVOKE ON DATABASE语法行为配置项。

• 不设置此配置项时：GRANT | REVOKE ON DATABASE语法映射成GRANT | REVOKE ON SCHEMA行为，赋予或回收指定的用户或角色对模式层级对象的访问权限。
• 设置此配置项时：GRANT | REVOKE ON DATABASE语法保留非M-Compatibility模式数据库（即GaussDB原有）默认兼容性库中GRANT | REVOKE ON DATABASE语法的行为，赋予或回收指定的用户或角色对数据库层级对象的访问权限。

  -- 创建用户和数据库。
  \c postgres
  DROP USER IF EXISTS testUser cascade; 
  DROP DATABASE IF EXISTS m_db;
  CREATE USER testUser WITH PASSWORD '********';
  CREATE DATABASE m_db DBCOMPATIBILITY='M';
  \c m_db
  
  -- 未打开选项，映射成GRANT SCHEMA，提示找不到Schema。
  m_db=# SET m_format_behavior_compat_options='';
  SET
  m_db=# GRANT CREATE ON DATABASE m_db TO testUser;
  ERROR:  schema "m_db" does not exist
  m_db=# SET SESSION AUTHORIZATION testUser PASSWORD '********';
  SET
  m_db=> CREATE SCHEMA s1;
  ERROR:  Permission denied for database m_db.
  DETAIL:  N/A.
  m_db=> \c -
  
  -- 打开选项，成功授予CREATE SCHEMA权限。
  m_db=# SET m_format_behavior_compat_options='grant_database_nomapping';
  SET
  m_db=# GRANT CREATE ON DATABASE m_db TO testUser;
  GRANT
  m_db=# SET SESSION AUTHORIZATION testUser PASSWORD '********';
  SET
  m_db=> CREATE SCHEMA s1;
  CREATE SCHEMA
  m_db=> \c -
  
  -- 清理。
  \c postgres
  DROP USER IF EXISTS testUser cascade; 
  DROP DATABASE IF EXISTS m_db;

get_hash_value_fix

dbe_utility.get_hash_value前向兼容开关。

• 若不设置此配置项，对于用户输入的字符串会忽略后4个字节，导致小于4个字节的字符串的hash值一致。
• 若设置此配置项，修复该问题，保证hash值的正确性。

gaussdb=# SET system_function_version = '';
gaussdb=# SELECT dbe_utility.get_hash_value(1, 1024, 1024);
get_hash_value
----------------
1444
(1 row)

gaussdb=# SELECT dbe_utility.get_hash_value(2, 1024, 1024);
get_hash_value
----------------
1444
(1 row)

gaussdb=# SET system_function_version = 'get_hash_value_fix';
gaussdb=# SELECT dbe_utility.get_hash_value(1, 1024, 1024);
get_hash_value
----------------
1785
(1 row)

gaussdb=# SELECT dbe_utility.get_hash_value(2, 1024, 1024);
get_hash_value
----------------
1538
(1 row)

pbe_trunc_fix

pbe场景时lpad/rpad/chr/round/trunc/add_months/instrb函数前向兼容开关。

• 若不设置此配置项，在pbe场景时上述函数的入参小数点会按照四舍五入转换整型。
• 若设置此配置项，在pbe场景时上述函数的入参小数点会按照整数截断转换整型，保证与ORA结果一致。

gaussdb=# SET a_format_version='10c';
gaussdb=# SET a_format_dev_version='s1';
gaussdb=# PREPARE pround1 AS SELECT round(123.456,$1);
gaussdb=# EXECUTE pround1('2.6');
round
---------
123.456
(1 row)

gaussdb=# SET system_function_version = 'pbe_trunc_fix';
gaussdb=# PREPARE pround1 AS SELECT round(123.456,$1);
gaussdb=# EXECUTE pround1('2.6');
round
---------
123.46
(1 row)

empty_array_fix

控制空数组的前向兼容开关。

• 若不设置此配置项，类似array_positions函数等操作构建的空数组与'{}'::int[]构建的空数组不相等。
• 若设置此配置项，类似array_positions函数等操作构建的空数组与'{}'::int[]构建的空数组相等。

gaussdb=# SET system_function_version = 'empty_array_fix';
SET
gaussdb=# SELECT array_eq(array_positions(array[1, 1, 1], 3), '{}'::int[]);
array_eq
----------
t
(1 row)

gaussdb=# SET system_function_version = '';
SET
gaussdb=# SELECT array_eq(array_positions(array[1, 1, 1], 3), '{}'::int[]);
array_eq
----------
f
(1 row)

regex_like_m_fix

控制regex_like_m函数行为的前向兼容开关。（regexp_like函数的实现中调用了regex_like_m，所以也受影响。）

• 若不设置此配置项，在多行匹配且正则规则中有‘|’时，匹配结果错误。
• 若设置此配置项，在多行匹配且正则规则中有‘|’时，匹配结果正确。

gaussdb=# SET system_function_version = 'regex_like_m_fix';
SET
gaussdb=# SELECT 'abc' FROM dual WHERE regex_like_m('111
2 222','^1+$|^2+$');
 ?column?
----------
 abc
(1 row)

gaussdb=# SET system_function_version = '';
SET
gaussdb=# SELECT 'abc' FROM dual WHERE regex_like_m('111
2 222','^1+$|^2+$');
 ?column?
----------
(0 row)

parse_phrase_fix

tsquery中控制是否解析词组操作符的开关。

• 若不设置此配置项，to_tsquery等涉及解析tsquery的操作不会解析词组操作符。
• 若设置此配置项，to_tsquery等涉及解析tsquery的操作将解析词组操作符。

gaussdb=# SET system_function_version = 'parse_phrase_fix';
SET
gaussdb=# SELECT to_tsquery('hello <-> world');
     to_tsquery      
---------------------
 'hello' <-> 'world'
(1 row)

gaussdb=# SET system_function_version = '';
SET
gaussdb=# SELECT to_tsquery('hello <-> world');
ERROR:  syntax error in tsquery: "hello <-> world"
CONTEXT:  referenced column: to_tsquery

display_leading_zero

浮点数显示配置项。控制数值类型中char、character、nchar、varchar、character varying、varchar2、nvarchar2、text、clob等所有字符串类型和float4、float8、numeric等任意精度类型的小数点前0的显示，length计算数字长度时是否包含小数点前的0。

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

  1 2 3 4 5

  gaussdb=# 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。比如：

  1 2 3 4 5

  gaussdb=# 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函数计算逻辑配置项。

此参数在M-Compatibility模式数据库下不生效。

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

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

  1 2 3 4 5

  gaussdb=# 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的月末日期保持一致。比如：

  1 2 3 4 5

  gaussdb=# 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时全局采样会更精确的控制在三万条左右，更好地控制analyze时Coordinator端的内存消耗，保证analyze性能的稳定性。

bind_schema_tablespace

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

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

bind_procedure_searchpath

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

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

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

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

skip_insert_gs_source

开启此参数后，创建PL/SQL对象时不再插入dbe_pldeveloper.gs_source表中。

a_hash_bpchar

开启此参数后，hashbpchar函数会保留字符串末尾空格来计算哈希值。

correct_to_number

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

• 若不设置此配置项，则to_number()函数结果默认与ORA数据库保持一致。

  1 2 3

  gaussdb=# select '' AS to_number_14, to_number('34,50','999,99'); ERROR: invalid data. CONTEXT: referenced column: to_number

• 若设置此配置项，则to_number()函数结果与pg11保持一致。

  1 2 3 4 5

  gaussdb=# select '' AS to_number_14, to_number('34,50','999,99'); to_number_14 | to_number --------------+----------- | 3450 (1 row)

unbind_divide_bound

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

此参数在M-Compatibility模式数据库下不生效。

• 若不设置此配置项，则会对除法结果做范围校验，例如，INT_MIN/(-1)会因为输出结果大于INT_MAX而报越界错误。

  1 2	gaussdb=# select (-2147483648)::int4 / (-1)::int4; ERROR: integer out of range

• 若设置此配置项，则不需要对除法结果做范围校验，例如，INT_MIN/(-1)可以得到输出结果为INT_MAX+1。

  1 2 3 4 5

  gaussdb=# select (-2147483648)::int4 / (-1)::int4; ?column? ------------ 2147483648 (1 row)

convert_string_digit_to_numeric

控制当表中以字符串形式表示的numeric常量和数字类型做比较时，是否都统一转换为numeric类型再进行比较。

此参数在M-Compatibility模式数据库下不生效。

• 若不设置此配置项，不会将以字符串形式表示的numeric常量转换为numeric类型。
• 若设置此配置项，会将以字符串形式表示的numeric常量转换为numeric类型。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

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

gaussdb=# set behavior_compat_options='convert_string_digit_to_numeric';
gaussdb=# select * from test1 where c2 > 1;
 c1 | c2  
----+-----
  2 | 1.1 
(1 row)

gaussdb=# drop table test1;

return_null_string

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

此参数在M-Compatibility模式数据库下不生效。

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

  1 2 3 4 5

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

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

  1 2 3 4 5

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

compat_concat_variadic

控制函数concat()和concat_ws()对variadic类型结果兼容性的配置项。由于MYSQL数据库无variadic类型，所以该选项对MYSQL数据库无影响。

• 若不设置此配置项，当concat函数参数为variadic类型时，默认ORA数据库和TD数据库兼容模式下结果相同，且与ORA数据库保持一致。

  1 2 3 4 5

  gaussdb=# select concat(variadic NULL::int[]) is null; ?column? ---------- t (1 row)

• 若设置此配置项，当concat函数参数为variadic类型时，保留ORA数据库和TD数据库兼容模式下不同的结果形式。

  1 2 3 4 5 6 7 8 9 10 11 12

  --ORA数据库下： gaussdb=# select concat(variadic NULL::int[]) is null; ?column? ---------- t (1 row) --TD数据库下： gaussdb=# select concat(variadic NULL::int[]) is null; ?column? ---------- f (1 row)

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块中默认回退到最近的保存点，从而保证只回退失败语句的修改。该选项是为了兼容ORA数据库的EXCEPTION行为。

hide_tailing_zero

numeric显示配置项。

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

例如：

gaussdb=# set behavior_compat_options='hide_tailing_zero';
gaussdb=# 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)
gaussdb=# set behavior_compat_options='';
gaussdb=# 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)

truncate_numeric_tail_zero

numeric显示配置项。

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

例如：

gaussdb=# set behavior_compat_options='truncate_numeric_tail_zero';
gaussdb=# 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)
gaussdb=# set behavior_compat_options='';
gaussdb=# 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)

char_coerce_compat

控制char(n)类型向其它变长字符串类型转换时的行为。该参数仅在sql_compatibility参数的值为ORA时生效，并且开启该参数后无论是隐式转换、显式转换还是通过调用text(bpchar)函数转换类型都不再省略尾部空格。

• 若设置此配置项，转换时不再省略尾部的空格，并且如果char(n)类型的长度超过其它变长字符串类型，将会报错。
• 若不设置此配置项，char(n)类型转换其它变长字符串类型时，会省略尾部的空格。

gaussdb=# set behavior_compat_options='';
gaussdb=# create table tab_1(col1 varchar(3));
gaussdb=# create table tab_2(col2 char(3));
gaussdb=# insert into tab_2 values('   ');
gaussdb=# insert into tab_1 select col2 from tab_2;
gaussdb=# select * from tab_1 where col1 is null;
 col1 
------
 
(1 row)
gaussdb=# select * from tab_1 where col1='   ';
 col1 
------
(0 rows)
gaussdb=# delete from tab_1;
gaussdb=# set behavior_compat_options = 'char_coerce_compat';
gaussdb=# insert into tab_1 select col2 from tab_2;
gaussdb=# select * from tab_1 where col1 is null;
 col1 
------
(0 rows)
gaussdb=# select * from tab_1 where col1='   ';
 col1 
------
    
(1 row)

gaussdb=# drop table tab_1;
gaussdb=# drop table tab_2;

aformat_regexp_match

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

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

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

disable_emptystr2null

ORA兼容模式绑参场景中，开启此参数后，关闭默认将字符类型传参的值从空串转换为null功能。包括text、clob、blob、raw、bytea、varchar、nvarchar2、bpchar、char、name、byteawithoutorderwithqualcol、byteawithoutordercol类型。该参数为逃生参数，非必要用户不要自行设置。

select_into_return_null

PG兼容模式下，开启此参数后，存储过程语句SELECT select_expressions INTO [STRICT] target FROM ... 允许在不指定STRICT并且查询结果为空时给变量赋NULL值。

开启此参数后，对于返回结果集为空的场景，对变量赋NULL值。比如：

gaussdb=# SET behavior_compat_options = 'select_into_return_null';
SET
gaussdb=# CREATE TABLE t1 (a int, b int) DISTRIBUTE BY hash(a);
CREATE TABLE
gaussdb=# DECLARE
gaussdb-# var int;
gaussdb-# BEGIN
gaussdb$# SELECT b INTO var FROM t1;
gaussdb$# RAISE INFO '%', var;
gaussdb$# END;
gaussdb$# /
INFO:  <NULL>
ANONYMOUS BLOCK EXECUTE
gaussdb=# DROP TABLE t1;
DROP TABLE

plsql_security_definer

• 开启此参数后，创建存储过程时默认为定义者权限。
• package默认为SECURITY INVOKER权限，如果想将默认行为改为SECURITY DEFINER权限，需要设置此参数。

proc_outparam_override

• 控制存储过程出参的重载行为，打开该参数后，对于存储过程只有out出参部分不同的情况，也可以正常创建和调用。目前只有gsql与jdbc连接数据库时可以使用该参数，对于其他工具打开该参数连接数据库时无法正常调用带有out的存储过程。
• 支持带有out出参的函数返回record类型，且out出参正常赋值。
• behavior_compat_options='proc_outparam_override' 重载参数仅在ORA兼容模式可用。

proc_uncheck_default_param

函数调用时不检查默认参数省略情况配置项。

• 若不设置此配置项，调用带有默认参数的函数时，入参从左往右排入函数，如果有非默认参数的入参缺失则会报错。比如：

  gaussdb=# create or replace function test(f1 int, f2 int default 20, f3 int, f4 int default 40, f5 int default 50) return int
  gaussdb-# as
  gaussdb$# begin
  gaussdb$# raise info 'f1:%',f1;
  gaussdb$# raise info 'f2:%',f2;
  gaussdb$# raise info 'f3:%',f3;
  gaussdb$# raise info 'f4:%',f4;
  gaussdb$# raise info 'f5:%',f5;
  gaussdb$# return 1;
  gaussdb$# end;
  gaussdb$# /
  CREATE FUNCTION
  gaussdb=# select test(1,2);
  ERROR:  function test(integer, integer) does not exist
  LINE 1: select test(1,2);
                 ^
  HINT:  No function matches the given name and argument types. You might need to add explicit type casts.
  CONTEXT:  referenced column: test
  
  gaussdb=# drop function test;

• 若设置此配置项，调用带有默认参数的函数时，入参从左往右排入函数，允许缺省默认参数的入参，如果有非默认参数的入参缺失，则会用错位的默认值填充该参数。比如：

  gaussdb=# create or replace function test(f1 int, f2 int default 20, f3 int, f4 int default 40, f5 int default 50) return int
  gaussdb-# as
  gaussdb$# begin
  gaussdb$# raise info 'f1:%',f1;
  gaussdb$# raise info 'f2:%',f2;
  gaussdb$# raise info 'f3:%',f3;
  gaussdb$# raise info 'f4:%',f4;
  gaussdb$# raise info 'f5:%',f5;
  gaussdb$# return 1;
  gaussdb$# end;
  gaussdb$# /
  CREATE FUNCTION
  gaussdb=# select test(1,2);
  INFO:  f1:1
  CONTEXT:  referenced column: test
  INFO:  f2:2
  CONTEXT:  referenced column: test
  INFO:  f3:20
  CONTEXT:  referenced column: test
  INFO:  f4:40
  CONTEXT:  referenced column: test
  INFO:  f5:50
  CONTEXT:  referenced column: test
   test 
  ------
      1
  (1 row)
  
  gaussdb=# drop function test;

  如上，f3被错误的默认值填充。

  说明：

  该场景下，非默认参数会被错位的默认值填充。

dynamic_sql_compat

开启此参数后：

• 动态语句不会将模板SQL中的同名模板参数视为同一个变量，而是按照顺序依次匹配using子句中的变量值。
• 动态语句执行语句时调用存储过程的场景，会对存储过程中参数的IN/OUT属性和using子句中的IN/OUT属性进行检查。
• 应用场景：Execute immediate、open cursor for、return query、for var in execute sql绑定参数场景。

dynamic_sql_check

开启此参数后，动态语句模板SQL中的不同模板参数个数与using子句中的变量个数不同时，将会在动态语句执行期间报错。

应用场景：Execute immediate、open cursor for、return query、for var in execute sql绑定参数场景。

enable_funcname_with_argsname

开启参数后，使用select调用函数时投影别名显示完整函数。

• 若不设置此配置项，使用select调用函数时投影别名仅显示函数名。比如：

  gaussdb=# select power(2,3);
   power 
  -------
       8
  (1 row)
  
  gaussdb=# select count(*) from db_ind_columns;
   count 
  -------
     611
  (1 row)
  
  gaussdb=# select count(index_name) from db_ind_columns;
   count 
  -------
     611
  (1 row)
  
  gaussdb=# select left('abcde', 2);
   left 
  ------
   ab
  (1 row)
  
  gaussdb=# select pg_client_encoding();
   pg_client_encoding 
  --------------------
   UTF8
  (1 row)

• 若设置此配置项，使用select调用函数时投影别名显示完整函数。比如：

  gaussdb=# set behavior_compat_options = 'enable_funcname_with_argsname';
  SET
  gaussdb=# select power(2,3);
   power(2,3) 
  ------------
            8
  (1 row)
  
  gaussdb=# select count(*) from db_ind_columns;
   count(*) 
  ----------
        611
  (1 row)
  
  gaussdb=# select count(index_name) from db_ind_columns;
   count(index_name) 
  -------------------
                 611
  (1 row)
  
  gaussdb=# select left('abcde', 2);
   left('abcde',2) 
  -----------------
   ab
  (1 row)
  
  gaussdb=# select pg_client_encoding();
   pg_client_encoding() 
  ----------------------
   UTF8
  (1 row)

• 目前仅支持func_name(args_list)、func_name()、func_name(*)三种形式投影别名显示完整函数，且参数args类型仅支持字符型常量、数值型常量、列名、函数。列名支持带有表名，但是func_name(*)不支持*前面带有表名。函数名支持带有schema、包名。不支持参数为表达式、仅支持参数带有DISTINCT关键字，不支持带有其他关键字时显示完整函数。
• 函数入参为以下场景时，投影别名不支持显示完整函数。

  -- 创建ORA兼容模式数据库。
  gaussdb=# CREATE DATABASE ora_db DBCOMPATIBILITY = 'ORA' ENCODING = 'UTF8';
  CREATE DATABASE
  gaussdb=# \c ora_db
  ora_db=# SET behavior_compat_options = 'enable_funcname_with_argsname';
  SET
  -- 函数入参为null值或者ORA兼容性下的空字符串。
  ora_db=# SELECT length(null);
   length 
  --------
  
  (1 row)
  
  ora_db=# SHOW sql_compatibility;
   sql_compatibility 
  -------------------
   ORA
  (1 row)
  
  ora_db=# SELECT length('');
   length 
  --------
  
  (1 row)
  
  -- 函数入参为带双冒号的类型强制转换。
  ora_db=# SELECT length('abc'::text);
   length 
  --------
        3
  (1 row)
  
  -- 函数入参为指定类型转换。
  ora_db=# SELECT length(text'abc');
   length 
  --------
        3
  (1 row)
  
  -- 函数入参为pbe占位符。
  ora_db=# PREPARE p1 AS SELECT length($1);
  PREPARE
  ora_db=# EXECUTE p1('abc');
   length 
  --------
        3
  (1 row)
  
  ora_db=# DEALLOCATE p1;
  DEALLOCATE
  
  -- 函数入参为数组构造器。
  ora_db=# SELECT array_ndims(ARRAY[1, 2, 3]);
   array_ndims 
  -------------
             1
  (1 row)

• 函数带不同子句时，投影别名的差异如下：
  • 函数入参带有其他子句（如ORDER BY子句）时，投影别名仅支持显示函数名。
  • 函数后接OVER、WITHIN子句时，投影别名支持显示函数名和入参，不支持显示OVER、WITHIN子句。
  • 函数后接KEEP子句时，投影别名支持显示函数名，不支持显示入参和KEEP子句。

    gaussdb=# \c ora_db
    ora_db=# SET behavior_compat_options = 'enable_funcname_with_argsname';
    SET
    ora_db=# DROP TABLE IF EXISTS tbl;
    ora_db=# CREATE TABLE tbl (id int, lower_col text, col1 int, col2 numeric);
    ora_db=# INSERT INTO tbl VALUES (1, 'hello', 42, 3.14);
    
    -- 入参带ORDER BY子句
    ora_db=# SELECT string_agg(lower_col, '1' ORDER BY id) FROM tbl;
     string_agg 
    ------------
     hello
    (1 row)
    
    -- OVER子句
    ora_db=# SELECT min(col1) OVER(PARTITION BY id ORDER BY col2) FROM tbl;
     min(col1) 
    -----------
            42
    (1 row)
    
    -- WITHIN子句
    ora_db=# SELECT listagg(lower_col, ',') WITHIN GROUP(ORDER BY id) FROM tbl;
     listagg(lower_col,',') 
    ------------------------
     hello,world,test
    (1 row)
    
    -- KEEP子句
    ora_db=# SELECT min(col1) KEEP (DENSE_RANK FIRST ORDER BY col2) FROM tbl;
     min 
    -----
      42
    (1 row)
    
    ora_db=# DROP TABLE IF EXISTS tbl;

• 部分函数既支持语法函数调用形式，又支持系统函数调用形式，不同调用方式会导致投影别名显示差异，函数列表参见表1。
  • 仅使用函数名称调用时，投影别名不显示完整函数。
  • 使用pg_catalog前缀或者双引号包裹调用函数时，投影别名显示完整函数。
• 投影列包含纯语法函数时，不支持完整投影别名显示，函数列表参见表1。纯语法函数的投影列名不一定显示函数名本身，而是显示该函数在语法解析阶段推导出的输出标识。
  • 当最外层函数为纯语法函数时，投影列名仅显示该函数的名称。
  • 若外层函数支持投影别名显示，但其参数中嵌套了纯语法函数，则仅显示外层函数名，而不显示纯语法函数名。
• 一些安全加解密函数、脱敏函数，投影别名显示完整函数可能存在安全问题，在这里就还是仅显示函数名。包括函数：gs_encrypt_aes128、gs_decrypt_aes128、gs_encrypt、gs_decrypt、gs_encrypt_bytea、gs_decrypt_bytea、aes_encrypt、aes_decrypt、pg_create_physical_replication_slot_extern、creditcardmasking、basicemailmasking、fullemailmasking、alldigitsmasking、shufflemasking、randommasking、regexpmasking、gs_digest、desencrypt、desdecrypt、des3encrypt、des3decrypt。
• 不支持=>传参方式调用函数时投影别名显示完整函数，不支持投影别名显示""，如：select "power"(2,3)。
• 为了让投影别名显示完整函数，本功能不受去除末尾0等参数影响。
• 投影别名超过63个字节时，会截断后面部分。
• 参数args为数值型常量时，不支持投影别名显示前导0。

  gaussdb=# SET behavior_compat_options = 'enable_funcname_with_argsname';
  SET
  gaussdb=# SELECT abs(0010);
   abs(10) 
  ---------
        10
  (1 row)
  

• 在如下特殊场景中，投影别名有所差异：
  • 场景一：部分函数既是语法函数又是系统函数，函数列表参见表1，在支持不带括号调用的场景下，使用pg_catalog前缀调用时，不会显示pg_catalog前缀。
  • 场景二：xmltype在带pg_catalog前缀或者双引号包裹调用时，会被当作系统函数调用，投影别名支持显示完整函数；仅使用xmltype调用时，会被当作语法函数调用，投影别名不支持显示完整函数。

  gaussdb=# \c ora_db
  ora_db=# SET behavior_compat_options = 'enable_funcname_with_argsname';
  SET
  -- 场景一（当前用户为omm）：
  ora_db=# SELECT pg_catalog.current_user;
   current_user 
  --------------
   omm
  (1 row)
  
  -- 场景二：
  ora_db=# SELECT pg_catalog.xmltype('<a>1</a>');
   pg_catalog.xmltype('<a>1</a>') 
  --------------------------------
   <a>1</a>
  (1 row)
  
  ora_db=# SELECT "xmltype"('<a>1</a>');
   xmltype('<a>1</a>') 
  ---------------------
   <a>1</a>
  (1 row)
  
  ora_db=# SELECT xmltype('<a>1</a>');
   xmltype  
  ----------
   <a>1</a>
  (1 row)
  
  ora_db=# \c postgres
  gaussdb=# DROP DATABASE ora_db;

proc_outparam_transfer_length

开启此参数后，存储过程和函数支持out出参长度传递，会在内层存储过程或者函数中报错。例如：

gaussdb=# SET behavior_compat_options='proc_outparam_override,proc_outparam_transfer_length';
SET
gaussdb=# CREATE OR REPLACE PROCEDURE out_param_test1(m in int, v inout varchar2,v1 inout varchar2) is
gaussdb$# begin
gaussdb$#     v := 'aaaddd';
gaussdb$# v1 := 'aaaddd';
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# CREATE OR REPLACE PROCEDURE call_out_param_test1 is
gaussdb$#     v varchar2(5) := 'aabbb';
gaussdb$# v1 varchar2(6) := 'aabb';
gaussdb$# begin
gaussdb$#     out_param_test1(5,v,v1);
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# CALL call_out_param_test1();
ERROR:  value too long for type character varying(5)
CONTEXT:  PL/SQL function out_param_test1(integer,character varying,character varying) line 3 at assignment
PL/SQL function call_out_param_test1() line 4 at SQL statement

gaussdb=# DROP PROCEDURE call_out_param_test1;
gaussdb=# DROP PROCEDURE out_param_test1;

compat_cursor

控制错误码变量兼容行为。设置此项，且兼容ORA，错误码变量（SQLCODE、SQLSTATE）由原先的仅在当前执行的函数有效，拓展到包括本函数调用的子函数有效。

tableof_elem_constraints

开启此参数后：

1. 集合类型会对元素合法性进行校验。
2. 索引为varchar的集合类型，索引长度也会进行合法性校验。

行为差异详情和示例具体可参考集合。

元素合法性校验示例：

未开启此参数时调用如下存储过程，元素不校验。

gaussdb=# CREATE OR REPLACE procedure p1 is
gaussdb$#     type t1 is table of varchar(5);
gaussdb$#     v t1 := t1();
gaussdb$# begin
gaussdb$#     v.extend();
gaussdb$#     v(1) := '123456';
gaussdb$#     raise info '%', v;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# CALL p1();
INFO:  {123456}
 p1 
----

(1 row)

gaussdb=# DROP procedure p1;

开启此参数后调用如下存储过程，元素校验会报错。

gaussdb=# SET behavior_compat_options = 'tableof_elem_constraints';
SET
gaussdb=# CREATE OR REPLACE procedure p1 is
gaussdb$#     type t1 is table of varchar(5);
gaussdb$#     v t1 := t1();
gaussdb$# begin
gaussdb$#     v.extend();
gaussdb$#     v(1) := '123456';
gaussdb$#     raise info '%', v;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# CALL p1();
ERROR:  value too long for type character varying(5)
CONTEXT:  PL/SQL function p1() line 5 at assignment

索引值合法性校验示例：

未开启该参数时，索引值超过定义长度不报错。

gaussdb=# CREATE OR REPLACE procedure p1 is
gaussdb$#     type t1 is table of int index by varchar(5);
gaussdb$#     v t1;
gaussdb$# begin
gaussdb$#     v('123456') := 1;
gaussdb$#     raise info '%', v;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# CALL p1();
INFO:  {indexbyType:varchar,"123456"=>1}
 p1 
----

(1 row)

gaussdb=# DROP procedure p1;

开启该参数后，索引值超过定义长度报错。

gaussdb=# SET behavior_compat_options = 'tableof_elem_constraints';
SET
gaussdb=# CREATE OR REPLACE procedure p1 is
gaussdb$#     type t1 is table of int index by varchar(5);
gaussdb$#     v t1;
gaussdb$# begin
gaussdb$#     v('123456') := 1;
gaussdb$#     raise info '%', v;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# CALL p1();
ERROR:  value too long for type character varying(5)
CONTEXT:  PL/SQL function p1() line 4 at assignment

allow_rownum_alias

开启此参数后，将允许ROWNUM在SQL语句中通过AS语法用作列的别名，ROWNUM将作为普通标识符使用，不再能够作为伪列使用。

此参数在M-Compatibility模式数据库下不生效。

current_sysdate

开启此参数后，执行sysdate时，会获取当前操作系统时间。关闭参数后，sysdate返回当前本条SQL执行时刻的系统日期和时间。

gaussdb=# set behavior_compat_options='current_sysdate';
SET
gaussdb=# select sysdate;
current_sysdate
---------------------
2023-06-20 20:15:27
(1 row)

开启GUC参数mapping_date_to_datea后，ORA兼容性下，sysdate会默认返回datea类型，获取当前操作系统时间，current_sysdate不再生效。

gaussdb=# set behavior_compat_options='';
SET
gaussdb=# show mapping_date_to_datea;
 mapping_date_to_datea
-----------------------
 on
(1 row)
gaussdb=# set NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';
SET
gaussdb=#  begin
gaussdb$#     dbe_output.print_line('time1:' || sysdate);
gaussdb$#     pg_sleep(2);
gaussdb$#     dbe_output.print_line('time2:' || sysdate);
gaussdb$# end;
gaussdb$# /
time1:2025-02-27 10:45:57
time2:2025-02-27 10:45:59

allow_function_procedure_replace

默认场景下，对于ORA和PG兼容模式，当有一个包外的存储过程（或函数）时，创建一个同名的函数（或存储过程），与已有对象类型不同，不支持创建并报错。开启此参数后，通过create or replace的方式可以实现包外同名的存储过程和函数对象之间的类型替换。

gaussdb=# create or replace function proc_test return varchar2 as
gaussdb$# begin
gaussdb$# return '1';
gaussdb$# end;
gaussdb$# /
CREATE FUNCTION
gaussdb=# create or replace procedure proc_test as
gaussdb$# begin
gaussdb$# null;
gaussdb$# end;
gaussdb$# /
ERROR:  cannot change routine kind
DETAIL:  "proc_test" is a function.
gaussdb=# \df+ proc_test
                                                                             List of functions
 Schema |   Name    | Result data type  | Argument data types |  Type  | Volatility |   Owner   | Language | Source code | Description | fencedmode | propackage | prokind
--------+-----------+-------------------+---------------------+--------+------------+-----------+----------+-------------+-------------+------------+------------+---------
 public | proc_test | character varying |                     | normal | volatile   | wangxinyu | plpgsql  |  DECLARE   +|             | f          | f          | f
        |           |                   |                     |        |            |           |          | begin      +|             |            |            |
        |           |                   |                     |        |            |           |          | return '1';+|             |            |            |
        |           |                   |                     |        |            |           |          | end         |             |            |            |
(1 row)

-- 设置参数后允许替换类型
gaussdb=# set behavior_compat_options='allow_function_procedure_replace';
SET
gaussdb=# create or replace procedure proc_test as
gaussdb$# begin
gaussdb$# null;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# \df+ proc_test
                                                                            List of functions
 Schema |   Name    | Result data type | Argument data types |  Type  | Volatility |   Owner   | Language | Source code | Description | fencedmode | propackage | prokind
--------+-----------+------------------+---------------------+--------+------------+-----------+----------+-------------+-------------+------------+------------+---------
 public | proc_test | void             |                     | normal | volatile   | wangxinyu | plpgsql  |  DECLARE   +|             | f          | f          | p
        |           |                  |                     |        |            |           |          | begin      +|             |            |            |
        |           |                  |                     |        |            |           |          | null;      +|             |            |            |
        |           |                  |                     |        |            |           |          | end         |             |            |            |
(1 row)

gaussdb=# drop procedure proc_test;

collection_exception_backcompat

控制在PL/SQL中集合类型相关报错抛出的异常值，当前控制三种异常值，对应关系如下：

未开启该参数 开启该参数

collection_is_null program_limit_exceeded

subscript_beyond_count program_limit_exceeded

subscript_outside_limit program_limit_exceeded

用例：

gaussdb=# create or replace procedure p1 is
gaussdb$#     type t1 is table of int;
gaussdb$#     v t1;
gaussdb$#     v_int int;
gaussdb$# begin
gaussdb$#     v_int := v.count();
gaussdb$# exception when collection_is_null then
gaussdb$#     raise info '%', sqlerrm;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# call p1();
INFO:  Reference to uninitialized collection
 p1 
----

(1 row)

gaussdb=# create or replace procedure p1 is
gaussdb$#     type t1 is table of int;
gaussdb$#     v t1 := t1(1, 2, 3);
gaussdb$#     v_int int;
gaussdb$# begin
gaussdb$#     v_int := v(4);
gaussdb$# exception when subscript_beyond_count then
gaussdb$#     raise info '%', sqlerrm;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# call p1();
INFO:  Subscript beyond count
 p1 
----

(1 row)

gaussdb=# create or replace procedure p1 is
gaussdb$#     type t1 is table of int;
gaussdb$#     v t1 := t1(1, 2, 3);
gaussdb$#     v_int int;
gaussdb$# begin
gaussdb$#     v_int := v(-1);
gaussdb$# exception when subscript_outside_limit then
gaussdb$#     raise info '%', sqlerrm;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# call p1();
INFO:  Subscript outside of limit
 p1 
----

(1 row)

gaussdb=# set behavior_compat_options = 'collection_exception_backcompat';
SET
gaussdb=# create or replace procedure p1 is
gaussdb$#     type t1 is table of int;
gaussdb$#     v t1;
gaussdb$#     v_int int;
gaussdb$# begin
gaussdb$#     v_int := v.count();
gaussdb$# exception when program_limit_exceeded then
gaussdb$#     raise info '%', sqlerrm;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# call p1();
INFO:  Reference to uninitialized collection
 p1 
----

(1 row)

gaussdb=# create or replace procedure p1 is
gaussdb$#     type t1 is table of int;
gaussdb$#     v t1 := t1(1, 2, 3);
gaussdb$#     v_int int;
gaussdb$# begin
gaussdb$#     v_int := v(4);
gaussdb$# exception when program_limit_exceeded then
gaussdb$#     raise info '%', sqlerrm;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# call p1();
INFO:  Subscript beyond count
 p1 
----

(1 row)

gaussdb=# create or replace procedure p1 is
gaussdb$#     type t1 is table of int;
gaussdb$#     v t1 := t1(1, 2, 3);
gaussdb$#     v_int int;
gaussdb$# begin
gaussdb$#     v_int := v(-1);
gaussdb$# exception when program_limit_exceeded then
gaussdb$#     raise info '%', sqlerrm;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# call p1();
INFO:  Subscript outside of limit
 p1 
----

(1 row)

gaussdb=# drop procedure p1;

enable_case_when_alias

开启该参数后，case when和decode语法的别名为以__unnamed_开头的字符串。

用例：

gaussdb=# set behavior_compat_options='enable_case_when_alias';
SET
gaussdb=# create table test(c1 varchar2);
CREATE TABLE
gaussdb=# insert into test values('x');
INSERT 0 1
gaussdb=# select decode(c1,'x','0','default') from test;
 __unnamed_decode__ 
--------------------
 0
(1 row)

gaussdb=# select (case c1 when 'x' then '0' else 'default' end) from test;
 __unnamed_case_when__ 
-----------------------
 0
(1 row)

gaussdb=# drop table test;

plsql_rollback_keep_user

控制在PL/SQL中rollback和rollback to savepoint是否修改当前用户，以及rollback to定义者权限函数内的savepoint是否修改当前用户。当开启此参数时，rollback将不会修改当前用户。

用例：

gaussdb=# create user plsql_rollback1 password '********';
gaussdb=# create user plsql_rollback2 password '********';
gaussdb=# grant plsql_rollback1 to plsql_rollback2;
gaussdb=# create or replace procedure plsql_rollback1.p1 () authid definer
gaussdb-# as
gaussdb$# va int;
gaussdb$# begin
gaussdb$# raise info 'current usr:%', current_user;
gaussdb$# rollback;
gaussdb$# raise info 'current usr:%', current_user;
gaussdb$# end;
gaussdb$# /
CREATE PROCEDURE
gaussdb=# set session AUTHORIZATION plsql_rollback2 PASSWORD '********';
SET
gaussdb=> set behavior_compat_options = 'plsql_rollback_keep_user';
SET
gaussdb=> call plsql_rollback1.p1 ();
INFO:  current usr:plsql_rollback1
INFO:  current usr:plsql_rollback1
p1
----

(1 row)

enable_bpcharlikebpchar_compare

启用/关闭bpcharlikebpchar和bpcharnlikebpchar操作符。

• 新安装的数据库默认开启该参数。
• 505.1.0版本之前的数据库通过升级操作后，该参数默认关闭。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

gaussdb=# SELECT bpcharlikebpchar('455'::BPCHAR(10), '455  '::BPCHAR);
 bpcharlikebpchar 
------------------
 f
(1 row)
gaussdb=# SELECT bpcharlikebpchar('455 '::BPCHAR(10), '455 '::BPCHAR(10));
 bpcharlikebpchar 
------------------
 t
(1 row)
gaussdb=# SELECT bpcharlikebpchar('455 '::BPCHAR(10), '455'::BPCHAR(10));
 bpcharlikebpchar 
------------------
 t
(1 row)
gaussdb=# SELECT bpcharlikebpchar('455 '::BPCHAR(10), '455'::BPCHAR(11));
 bpcharlikebpchar 
------------------
 f
(1 row)
gaussdb=# CREATE TABLE op_test (
  col BPCHAR(2) DEFAULT NULL
 );
CREATE TABLE
gaussdb=# CREATE INDEX op_index ON op_test(col);
CREATE INDEX
gaussdb=# INSERT INTO op_test VALUES ('a');
INSERT 0 1
gaussdb=# INSERT INTO op_test VALUES ('1');
INSERT 0 1
gaussdb=# INSERT INTO op_test VALUES ('11');
INSERT 0 1
gaussdb=# INSERT INTO op_test VALUES ('12');
INSERT 0 1
gaussdb=# INSERT INTO op_test VALUES ('sd');
INSERT 0 1
gaussdb=# INSERT INTO op_test VALUES ('aa');
INSERT 0 1
gaussdb=# SHOW behavior_compat_options;
 behavior_compat_options 
-------------------------
(1 row)
--当behavior_compat_options不包含enable_bpcharlikebpchar_compare时，则未启用最新bpcharlikebpchar操作符，其bpchar匹配bpchar返回结果集非预期（正常应返回全部数据）。
gaussdb=# EXPLAIN (COSTS OFF) SELECT * FROM op_test WHERE col LIKE col::BPCHAR ORDER BY col;
              QUERY PLAN              
--------------------------------------
 Sort
   Sort Key: col
   ->  Seq Scan on op_test
         Filter: (col ~~ (col)::text)
(4 rows)
gaussdb=# SELECT * FROM op_test WHERE col LIKE col::BPCHAR ORDER BY col;
 col 
-----
 11
 12
 aa
 sd
(4 rows)
gaussdb=# SET behavior_compat_options = 'enable_bpcharlikebpchar_compare';
SET
gaussdb=# SHOW behavior_compat_options;
     behavior_compat_options     
---------------------------------
 enable_bpcharlikebpchar_compare
(1 row)
--开启参数后，将启用最新bpcharlikebpchar操作符，其匹配时返回行为符合预期行为。
gaussdb=# EXPLAIN (COSTS OFF) SELECT * FROM op_test WHERE col LIKE col::BPCHAR ORDER BY col;
          QUERY PLAN          
------------------------------
 Sort
   Sort Key: col
   ->  Seq Scan on op_test
         Filter: (col ~~ col)
(4 rows)
gaussdb=# SELECT * FROM op_test WHERE col LIKE col::BPCHAR ORDER BY col;
 col 
-----
 1 
 11
 12
 a 
 aa
 sd
(6 rows)
gaussdb=# DROP TABLE op_test;
DROP TABLE

cursor_asensitive

打开该参数后，游标数据敏感行为兼容505.1之前版本。默认关闭该参数，数据库实现数据非敏感游标。

• 若设置此配置项，游标数据敏感行为兼容505.1之前版本，某些游标可以看到OPEN后的修改。

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

  gaussdb=# set behavior_compat_options='cursor_asensitive'; SET gaussdb=# create table t1(c1 int, c2 varchar,c3 varchar) distribute by hash(c1); CREATE TABLE gaussdb=# insert into t1 values(1,'Tom','Jones'); INSERT 0 1 gaussdb=# create or replace function func1() returns sys_refcursor gaussdb-# as $$ gaussdb$# declare gaussdb$# x sys_refcursor; gaussdb$# cursor cur1 for select count(1) from t1 where c2 = 'Joe'; gaussdb$# begin gaussdb$# open cur1; gaussdb$# update t1 set c2='Joe' where c3='Jones'; gaussdb$# fetch cur1 into x; gaussdb$# close cur1; gaussdb$# return x; gaussdb$# end;$$ gaussdb-# LANGUAGE plpgsql; CREATE FUNCTION gaussdb=# call func1(); func1 ------- 1 (1 row) gaussdb=# drop function func1; gaussdb=# drop table t1;

• 若不设置此配置项，游标OPEN确定游标的结果集，看不到OPEN后的修改。

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

  gaussdb=# show behavior_compat_options; behavior_compat_options ------------------------- (1 row) gaussdb=# create table t1(c1 int, c2 varchar,c3 varchar) distribute by hash(c1); CREATE TABLE gaussdb=# insert into t1 values(1,'Tom','Jones'); INSERT 0 1 gaussdb=# create or replace function func1() returns sys_refcursor gaussdb-# as $$ gaussdb$# declare gaussdb$# x sys_refcursor; gaussdb$# cursor cur1 for select count(1) from t1 where c2 = 'Joe'; gaussdb$# begin gaussdb$# open cur1; gaussdb$# update t1 set c2='Joe' where c3='Jones'; gaussdb$# fetch cur1 into x; gaussdb$# close cur1; gaussdb$# return x; gaussdb$# end;$$ gaussdb-# LANGUAGE plpgsql; CREATE FUNCTION gaussdb=# call func1(); func1 ------- 0 (1 row) gaussdb=# drop function func1; gaussdb=# drop table t1;

enable_crosstype_integer_operator

启用/关闭跨类型整型操作符。

• 全新安装的数据库默认开启该参数。
• 505.1.0版本之前的数据库通过升级操作后，该参数默认关闭。
• 涉及操作符范围=、<>、<、>、<=、>=。
• 开启该参数后，涉及的跨类型整型比较，不再需要隐式转换，可直接进行比较。如下以(int1 op int2)举例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

ora_db=# SET max_datanode_for_plan=1;
SET
ora_db=# DROP TABLE IF EXISTS implicit_index;
DROP TABLE
ora_db=# CREATE TABLE implicit_index(c1 int1);
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'c1' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
ora_db=# SET behavior_compat_options='enable_crosstype_integer_operator';
SET
ora_db=# EXPLAIN (COSTS OFF) SELECT * FROM implicit_index WHERE c1 > 1::int2;
                               QUERY PLAN                                
-------------------------------------------------------------------------
 Data Node Scan
   Node/s: All datanodes

 Remote SQL: SELECT c1 FROM public.implicit_index WHERE c1 > 1::smallint
 Datanode Name: datanode1--该节点信息为当前测试示例执行计划节点信息，可能与用户实际存在差异，具体实际执行展示信息以实际信息为准。
   Seq Scan on implicit_index
     Filter: (c1 > 1::smallint)

(8 rows)

ora_db=# SET behavior_compat_options='';
SET
ora_db=# EXPLAIN (COSTS OFF) SELECT * FROM implicit_index WHERE c1 > 1::int2;
                                   QUERY PLAN                                    
---------------------------------------------------------------------------------
 Data Node Scan
   Node/s: All datanodes

 Remote SQL: SELECT c1 FROM public.implicit_index WHERE c1::bigint > 1::smallint
 Datanode Name: datanode1--该节点信息为当前测试示例执行计划节点信息，可能与用户实际存在差异，具体实际执行展示信息以实际信息为准。
   Seq Scan on implicit_index
     Filter: ((c1)::bigint > 1::smallint)

(8 rows)

ora_db=# DROP TABLE implicit_index;
DROP TABLE

forbid_package_function_with_prefix

打开该参数后，创建package内的函数时，如果函数有前缀，则会报错。

例如：

gaussdb=# SET behavior_compat_options='forbid_package_function_with_prefix';
SET
gaussdb=# CREATE SCHEMA schema1;
gaussdb=# CREATE OR REPLACE package pck1
    IS
    procedure schema1.proc1();
    END pck1;
    /
ERROR:  not support procedure name use *.* format in package at or near ";"
CONTEXT:  compilation of PL/pgSQL package "pck1" near line 2

gaussdb=# DROP SCHEMA schema1;

time_constexpr_compact

打开该参数后，执行时间表达式场景，会根据常量是否含有时区，自动返回with timezone类型或without timezone类型。

目前支持timestamp类型、time类型。

--执行不带时区的时间戳表达式。
gaussdb=# SELECT timestamp '1999-03-15 8:00:00';
      timestamp      
---------------------
 1999-03-15 08:00:00
(1 row)
--执行带时区的时间戳表达式 返回timestamp with time zone类型。
gaussdb=# SELECT timestamp '1999-03-15 8:00:00 -8:00:00';
      timestamptz       
------------------------
 1999-03-16 00:00:00+08
(1 row)

enable_use_ora_timestamptz

开启后TIMESTAMP AT TIME ZONE语法得到的日期时间跟ORA数据库保持一致。由于GaussDB只能显示session时区，ORA可以显示输入的时区，当时区不一致时显示的结果不同，将日期时间转换到相同时区后是同一时间点。

--打开参数前
gaussdb=# SELECT timestamp '2024-03-20 01:30:00' at time zone 'Europe/Moscow' FROM dual;
       timezone
----------------------
2024-03-20 06:30:00+08
(1 row)

-- 打开参数后
gaussdb=# SET behavior_compat_options='enable_use_ora_timestamptz';
SET
gaussdb=# SELECT timestamp '2024-03-20 01:30:00' at time zone 'Europe/Moscow' FROM dual;
       timezone
----------------------
2024-03-20 01:30:00+08
(1 row)

forbid_skip_tableof_empty_str_elem

用于控制无索引的集合类型对于'{1,,3}'格式字符串的输入行为。

• 打开该参数后，无索引的集合型将不支持'{1,,3}'格式字符串的输入。

  gaussdb=# CREATE TYPE t1 IS TABLE OF int;
  CREATE TYPE
  gaussdb=# CREATE OR REPLACE PROCEDURE p1(v t1) IS
  gaussdb$# BEGIN
  gaussdb$#      FOR i IN 1..v.count LOOP
  gaussdb$#          dbe_output.print_line('v(' || i || ') is ' || v(i));
  gaussdb$#      END LOOP;
  gaussdb$# END;
  gaussdb$# /
  CREATE PROCEDURE
  gaussdb=# SET behavior_compat_options = 'forbid_skip_tableof_empty_str_elem';
  SET
  gaussdb=# CALL p1('{1,,3}');
  ERROR:  Malformed nesttable literal: "{1,,3}".
  LINE 1: call p1('{1,,3}');
                  ^
  gaussdb=# CALL p1('{1,}');
  ERROR:  Malformed nesttable literal: "{1, }".
  LINE 1: call p1('{1, }');
                  ^
  gaussdb=# CALL p1('{,3}');
  ERROR:  Malformed nesttable literal: "{ ,3}".
  LINE 1: call p1('{ ,3}');
                  ^
  gaussdb=# DROP PROCEDURE p1;
  DROP PROCEDURE
  gaussdb=# DROP TYPE t1;
  DROP TYPE

• 关闭该参数后，无索引的集合型将支持'{1,,3}'格式字符串的输入，在进行转换时会自动过滤空串。

  gaussdb=# CREATE TYPE t1 IS TABLE OF int;
  CREATE TYPE
  gaussdb=# CREATE OR REPLACE PROCEDURE p1(v t1) IS
  gaussdb$# BEGIN
  gaussdb$#      FOR i IN 1..v.count LOOP
  gaussdb$#          dbe_output.print_line('v(' || i || ') is ' || v(i));
  gaussdb$#      END LOOP;
  gaussdb$# END;
  gaussdb$# /
  CREATE PROCEDURE
  gaussdb=# SET behavior_compat_options = '';
  SET
  gaussdb=# CALL p1('{1,,3}');
  v(1) is 1
  v(2) is 3
   p1 
  ----
  
  (1 row)
  
  gaussdb=# CALL p1('{1,}');
  v(1) is 1
   p1 
  ----
  
  (1 row)
  
  gaussdb=# CALL p1('{,3}');
  v(1) is 3
   p1 
  ----
  
  (1 row)
  
  gaussdb=# DROP PROCEDURE p1;
  DROP PROCEDURE
  gaussdb=# DROP TYPE t1;
  DROP TYPE

sys_function_without_brackets

开启该参数后，对于ORA兼容模式下无入参系统函数，可以不带括号进行调用。

1
2
3
4
5
6

gaussdb=# SET behavior_compat_options='sys_function_without_brackets';
gaussdb=# SELECT systimestamp;
         systimestamp          
-------------------------------
 2024-04-16 15:55:21.614342+08
(1 row)

array_count_compat

用于决定变长数组类型的变量为NULL时，调用array_count函数的返回值为NULL值还是0值。

• 开启参数后，变长数组类型的变量为NULL时，array_count函数返回值为0值。

  gaussdb=# create type t1 as table of int;
  CREATE TYPE
  gaussdb=# set behavior_compat_options='array_count_compat';
  SET
  gaussdb=# 
  gaussdb=# declare
  gaussdb-# type typ is varray(5) of int;
  gaussdb-# va typ;
  gaussdb-# begin
  gaussdb$# raise info 'va count:%',va.count;
  gaussdb$# if 1 > va.count then
  gaussdb$# raise info ' 1 > null is true';
  gaussdb$# else
  gaussdb$# raise info ' 1 > null is false';
  gaussdb$# end if;
  gaussdb$# end;
  gaussdb$# /
  INFO:  va count:0
  INFO:   1 > null is true
  ANONYMOUS BLOCK EXECUTE
  

• 关闭参数后，变长数组类型的变量为NULL时，array_count函数返回值为NULL值。

  gaussdb=# set behavior_compat_options='';
  SET
  gaussdb=# create type t1 as table of int;
  CREATE TYPE
  gaussdb=# declare
  gaussdb-# type typ is varray(5) of int;
  gaussdb-# va typ;
  gaussdb-# begin
  gaussdb$# raise info 'va count:%',va.count;
  gaussdb$# if 1 > va.count then
  gaussdb$# raise info ' 1 > null is true';
  gaussdb$# else
  gaussdb$# raise info ' 1 > null is false';
  gaussdb$# end if;
  gaussdb$# end;
  gaussdb$# /
  INFO:  va count:<NULL>
  INFO:   1 > null is false
  ANONYMOUS BLOCK EXECUTE

search_path_behavior_optimization

启用/关闭存储过程搜索路径增强功能。

• 新安装的数据库默认关闭该参数。
• 开启该选项后，选项包含bind_procedure_searchpath选项能力。存储过程中会绑定会话级别search_path设置中的Schema，形成一份Schema列表。存储过程内未显式指定Schema的对象，会在这份Schema列表中按照顺序依次查找。如果同时开启bind_procedure_searchpath和search_path_behavior_optimization选项，默认使用search_path_behavior_optimization选项。
• 开启该选项后，与单独开启bind_procedure_searchpath选项的区别在于：搜索路径编译产物中$user的刷新逻辑变化，以及搜索路径编译产物中pg_temp schema的存在变化。
• 开启该选项后，具体行为变更如下：
  • 嵌套调用SECURITY DEFINER函数刷新搜索路径编译产物中的$user为嵌套最内层的函数owner。
  • 本地临时表的namespace不加入搜索路径编译产物。
  • 不支持存储过程/函数使用本地临时表%type、%rowtype写法（该限制不适用于本地临时表%type、%rowtype作为入参、出参场景）。例如：

    gaussdb=# SET behavior_compat_options='search_path_behavior_optimization';
    SET
    
    -- 创建本地临时表temp_table
    gaussdb=# CREATE TEMP TABLE tmp_table(c1 int);
    CREATE TABLE
    
    -- 存储过程内使用本地临时表%rowtype写法，报错
    gaussdb=# CREATE or REPLACE PROCEDURE test_temp_tab_proc AS
    gaussdb$# a tmp_table%ROWTYPE;
    gaussdb$# BEGIN
    gaussdb$# NULL;
    gaussdb$# END;
    gaussdb$# /
    ERROR:  UNSUPPORTED FEATURE with temporary table when setting behavior_compat_options: search_path_behavior_optimization.
    CONTEXT:  compilation of PL/pgSQL function "test_temp_tab_proc" near line 2

enable_ora_joinop_in_updatestmt

用于控制在UPDATE语句中SET子句带子查询时，子查询是否支持“+”操作符。

开启该参数后，子查询返回的是带“+”的结果：

gaussdb=# CREATE DATABASE a_db dbcompatibility = 'ora';
CREATE DATABASE
gaussdb=# \c a_db
a_db=# CREATE TABLE t1(a1 int, b int);
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'a1' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
a_db=# CREATE TABLE t2(c1 int, d int);
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'c1' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
a_db=# CREATE TABLE t3(a2 int, c2 int, e int);
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'a2' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
a_db=# INSERT INTO t1 VALUES(1, 11),(2, 12);
INSERT 0 2
a_db=# INSERT INTO t2 VALUES(3, 23),(4, 24);
INSERT 0 2
a_db=# INSERT INTO t3 VALUES(1, 3, 31),(5, 6, 32);
INSERT 0 2
a_db=# CREATE TABLE result(col1 int, col2 int, col3 int, col4 int, col5 int,col6 int, col7 int);
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'col1' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
a_db=# INSERT INTO result SELECT * FROM t1, t2, t3 WHERE t1.a1=t3.a2 AND t2.c1=t3.c2;
INSERT 0 1
a_db=# UPDATE  result SET (col2, col3, col4 ,col5,col6,col7) = ( SELECT b,c1,d,a2,c2,e FROM t1, t2, t3 WHERE t1.a1=t3.a2(+) AND t3.c2=t2.c1(+));
ERROR:  The subquery in the expression returns more than one row of result.
CONTEXT:  referenced column: col2

disable_insert_void_value

用于控制void类型的返回值能否执行INSERT或UPDATE，ORA兼容性下生效。

开启该参数后void类型执行INSERT或UPDATE失败，关闭时允许执行INSERT或UPDATE。

gaussdb=# SELECT pg_typeof(dbe_application_info.set_action(''::text));
 pg_typeof
-----------
 void
(1 row)
gaussdb=# SET behavior_compat_options = 'disable_insert_void_value';
gaussdb=# CREATE TABLE insert_void (id int,col text) DISTRIBUTE BY HASH(id);
gaussdb=# INSERT INTO insert_void (id,col) VALUES(1,dbe_application_info.set_client_info(''::text));
ERROR:  column "col" is of type text but expression is of type void
LINE 1: INSERT INTO insert_void (id,col) VALUES(1,dbe_application_in...
                                                  ^
HINT:  You will need to rewrite or cast the expression.
CONTEXT:  referenced column: col
gaussdb=# UPDATE insert_void SET col  = dbe_application_info.set_client_info(''::text);
ERROR:  column "col" is of type text but expression is of type void
LINE 1: UPDATE insert_void SET col  = dbe_application_info.set_clie...
                                       ^
HINT:  You will need to rewrite or cast the expression.
CONTEXT:  referenced column: col

ignore_like_default_escape

用于LIKE模糊匹配时，控制模式串中的反斜杠'\'是否被视为转义字符。

该参数仅在standard_conforming_strings为on时才可以被设置。

• 开启参数后，LIKE模糊匹配中，支持将模式串中的反斜杠字符'\'视为普通字符进行匹配，'\'不起转义作用，无法消除通配符的特殊含义。

  gaussdb=# CREATE DATABASE ora_db DBCOMPATIBILITY = 'ORA';
  CREATE DATABASE
  gaussdb=# \c ora_db
  ora_db=# SET standard_conforming_strings = on;
  SET
  ora_db=# SET behavior_compat_options = 'ignore_like_default_escape';
  SET
  ora_db=# CREATE TABLE test(c1 text) DISTRIBUTE BY HASH(c1);
  CREATE TABLE
  ora_db=# INSERT INTO test VALUES('aa\a');
  INSERT 0 1
  ora_db=# SELECT * FROM test WHERE c1 LIKE 'aa\a';
    c1  
  ------
   aa\a
  (1 row)
  
  ora_db=# DROP TABLE test;
  DROP TABLE
  ora_db=# \c postgres
  gaussdb=# DROP DATABASE ora_db;

• 关闭参数后，LIKE模糊匹配中，模式串中的反斜杠字符'\'视为转义字符，'\'起转义作用，可以消除通配符的特殊含义。

  gaussdb=# CREATE DATABASE ora_db DBCOMPATIBILITY = 'ORA';
  CREATE DATABASE
  gaussdb=# \c ora_db
  ora_db=# SET behavior_compat_options = '';
  SET
  ora_db=# CREATE TABLE test(c1 text) DISTRIBUTE BY HASH(c1);
  CREATE TABLE
  ora_db=# INSERT INTO test VALUES('aaa');
  INSERT 0 1
  ora_db=# SELECT * FROM test WHERE c1 LIKE 'aa\a';
    c1  
  ------
   aaa
  (1 row)
  
  ora_db=# DROP TABLE test;
  DROP TABLE
  ora_db=# \c postgres
  gaussdb=# DROP DATABASE ora_db;

forbid_update_multi_same_tables

分布式场景不生效。

disable_rewrite_nesttable

分布式场景不生效。

aformat_null_test

分布式场景不生效。

10c

ORA平台兼容10C版本。由于a_format_version和a_format_dev_version一起使用，详细的行为控制见表6。

s1

• ORA平台兼容迭代小版本，影响函数（round(date, fmt),nvl2,lpad,rpad,add_months,months_between,regexp_replace,regexp_count,empty_clob,instrb,trunc(numeric, int),greatest,least,mod,round(number,int),cast,to_date,to_timestamp,chr,to_char,to_number，to_timestamp_tz）。
  • round(date, fmt)：此函数的入参为timestamp without time zone时，在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下有效。
  • nvl2：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下有效。
  • lpad：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下：
    • 参数length表示字符串显示长度，单个字符的显示长度按照ORA兼容处理。
    • 函数执行过程中出现length剩余长度为1且下一个字符显示长度为2，在字符串左侧添加一个空格字符。
    • 参数length入参若为小数则不会被四舍五入，而是被截断。
    • 参数string与fill不支持不符合编码规范的输入。
  • rpad：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下：
    • 参数length表示字符串显示长度，单个字符的显示长度按照ORA兼容处理。
    • 函数执行过程中出现length剩余长度为1且下一个字符显示长度为2，在字符串右侧添加一个空格字符。
    • 参数length入参若为小数则不会被四舍五入，而是被截断。
    • 参数string与fill不支持不符合编码规范的输入。
    • 参数string有长度限制，若填充后大小超出1G会报错。
  • add_months：此函数在GUC参数mapping_date_to_datea值为off的情况下，数据库会将入参中的date类型解析为timestamp(0) without time zone类型，此时返回值为timestamp类型。当该函数入参类型被解析为timestamp(0) without time zone时，此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下：
    • 当计算结果大于公元9999年时会报错。
    • 参数n入参若为小数则不会被四舍五入，而是被截断。
  • months_between：此函数在GUC参数mapping_date_to_datea值为off的情况下，数据库会将入参中的date类型解析为timestamp(0) without time zone类型。当该函数入参类型被解析为timestamp(0) without time zone时，此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下有效。
  • regexp_replace：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下，occurrence参数默认值为0，表示替换所有匹配到的子串。并且以'\'字符结尾的pattern参数为合法的。
  • regexp_count：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下，以'\'字符为结尾的pattern参数为合法的。
  • empty_clob：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下有效。
  • instrb：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下有效。
  • trunc(numeric, int)：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1时，参数s若入参为小数则不会被四舍五入，而是被截断。
  • greatest：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下：
    • 如果参数中有任意一个参数的值为NULL，函数返回NULL。
    • 如果第一个参数是数值类型，函数将第一个参数和其他参数都转换为numeric类型，然后进行比较，对于不能转换的，提示出错信息；第一个参数是其他类型的，函数将其他参数都转换为第一个参数的类型进行比较，对于不能转换的，提示出错信息。
  • least：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s1的情况下：
    • 如果参数中有任意一个参数的值为NULL，函数返回NULL。
    • 如果第一个参数是数值类型，函数将第一个参数和其他参数都转换为numeric类型，然后进行比较，对于不能转换的，提示出错信息；第一个参数是其他类型的，函数将其他参数都转换为第一个参数的类型进行比较，对于不能转换的，提示出错信息。
  • mod：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s6的情况下，支持mod(text, int)重载，在以(text, int)为入参类型调用mod函数时，会优先选择mod(text, int)。
  • round(numeric, int)：
    • 控制参数s输入为小数时：在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下s截断为整数，否则s四舍五入为整数。
    • 在参数a_format_version值为10c和a_format_dev_version值为s1的情况下，round函数支持round(timestamp, text)重载，在以(text, text)或(text, '')为入参调用round函数时会优先选择round(timestamp, text)。
  • cast：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s1的情况下，支持DEFAULT z ON CONVERSION ERROR的可选语法及fmt可选参数
  • to_date：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s1的情况下，年份的输入超过9999时，系统可能不报错。如to_date('99999-12-12', 'yyyy-mm-dd hh24:mi:ss')结果为9999-09-12 12:00:00。年输入超过9999时，超过4位后面的数字会解析为下一个fmt。
  • to_timestamp：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s1的情况下，fmt支持FF[7-9]，在FF[7-9]的情况下允许转换string中的对应位置长度小于等于FF紧跟的数字，但最终转换结果长度最大保留6位。
  • chr：此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下：参数integer入参若为小数则不会被四舍五入，而是被截断。
  • to_char(numeric/smallint/integer/bigint/double precision/real[, fmt])：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s1的情况下，支持$、C、TM、TM9、TME、U格式。同时在该参数下，不支持TH、PL、SG格式的fmt。
  • to_number：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s1的情况下，to_number函数的格式fmt详情可参考《开发指南》中的to_number函数介绍。
  • to_timestamp_tz：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s1的情况下有效。
• 数据类型转换：小数字符串转换成整数类型（int1/int2/int4/int8/int16）时进行四舍五入。
• 数据类型转换：支持timestamp with time zone到timestamp without time zone和datea，以及timestamp到datea的隐式转换。

s2

• ORA平台兼容迭代小版本，影响函数（dump, to_single_byte, to_multi_byte, nls_upper, nls_lower, initcap, ascii2, asciistr, unistr, vsize, cosh, remainder, sinh, tanh, nanvl, current_date, current_timestamp, dbtimezone, numtodsinterval, numtoyminterval, new_time, sessiontimezone, sys_extract_utc, tz_offset, to_binary_double, to_binary_float, to_dsinterval, to_yminterval, lnnvl, ora_hash）。
  • dump：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • to_single_byte：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • to_multi_byte：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • nls_upper：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下支持使用。
  • nls_lower：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下支持使用。
  • initcap：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下，如中文等无大小写区分的字符后接区分大小写的字符首字母会转换为大写，其他字母转换为小写。因此建议开启参数a_format_version值为10c和a_format_dev_version值为s2。
  • ascii2：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • asciistr：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • unistr：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • vsize：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • cosh：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • remainder：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • sinh：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • tanh：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • nanvl：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • current_date：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下返回值类型为timestamp。
  • current_timestamp：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2时，precision参数支持numeric类型的整值，否则仅支持int输入。
  • dbtimezone：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • numtodsinterval：此函数在ORA兼容模式下，_format_version值为10c和a_format_dev_version值为s2的情况下：当参数interval_unit为 'DAY' 时，参数num超过1000000000会报错。
  • numtoyminterval：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • new_time：此函数GUC参数mapping_date_to_datea值为off的情况下，数据库会将入参中的date类型解析为timestamp(0) without time zone类型，此时返回值为timestamp类型。当该函数入参类型被解析为timestamp(0) without time zone时，此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • sessiontimezone：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • sys_extract_utc：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • tz_offset：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • to_binary_double：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s2的情况下有效。
  • to_binary_float：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s2的情况下有效。
  • to_dsinterval：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s2的情况下有效。
  • to_yminterval：此函数在ORA兼容模式下，a_format_version值为10c且a_format_dev_version值为s2的情况下有效。
  • lnnvl：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下有效。
  • ora_hash：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s2的情况下才能有效。
• 兼容配置项为s1时的所有行为。

s3

• ORA平台兼容迭代小版本，开启参数，支持无参函数嵌套调用。
• 兼容配置项为s2时的所有行为。

s4

• ORA平台兼容迭代小版本，影响函数nchr(cvalue int|bigint)、to_timestamp_tz、getclobval(xml)、getstringval(xml)。
  • nchr(cvalue int|bigint)：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s4的情况下有效。
  • to_timestamp_tz(string [DEFAULT return_value ON CONVERSION ERROR], fmt, nlsparam)：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s4的情况下有效。
  • getclobval(xml)：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s4的情况下有效。
  • getstringval(cml)：此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s4的情况下有效。
• 兼容配置项为s3时的所有行为。

s5

• ORA平台兼容迭代小版本，开启参数，支持复合类型与函数同名，优先解析为复合类型，影响函数sys_guid()。
  • 此函数在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s5的情况下才能生效。
• 兼容配置项为s4时的所有行为。

s6

• ORA平台兼容迭代小版本，开启参数，影响函数mod(text, int)。
  • mod(text, int)：在ORA兼容模式下，a_format_version值为10c和a_format_dev_version值为s6的情况下，mod函数支持mod(text, int)重载，在以(text, int)为入参类型调用mod函数时，会优先选择mod(text, int)。
• 兼容配置项为s5时的所有行为。

s7

• ORA平台兼容迭代小版本，开启参数。
• 当开启该参数时，存在以下行为兼容：
  1. 兼容GUC参数配置为behavior_compat_options='display_leading_zero, end_month_calculate, plstmt_implicit_savepoint, truncate_numeric_tail_zero, char_coerce_compat, aformat_regexp_match, compat_cursor, plsql_security_definer, proc_outparam_override, dynamic_sql_compat, proc_outparam_transfer_length, tableof_elem_constraints, current_sysdate, plsql_rollback_keep_user, enable_bpcharlikebpchar_compare, show_full_error_lineno, enable_crosstype_integer_operator, forbid_package_function_with_prefix, enable_case_when_alias, time_constexpr_compact, enable_use_ora_timestamptz, forbid_skip_tableof_empty_str_elem, sys_function_without_brackets'的所有行为。
  2. 兼容GUC参数配置为a_format_date_timestamp=on的所有行为。
• 兼容配置项为s6时的所有行为。
• JDBC驱动连接数据库的场景，若需要设置该参数，需同步更新JDBC驱动。

s1

1. 影响如下参数：

   参数打开会将disable_keyword_options参数中的datetime选项去除，表示datetime作为非保留关键字使用。datetime可以作为表名、列名、别名使用，但不能作为函数名、存储过程名、函数或存储过程的参数名使用。

2. 影响如下函数：

   curdate，from_days，date_format，str_to_date，current_date，datediff，timestampdiff，date_add，subtime，month，time_to_sec，to_days，to_seconds，dayname，monthname，convert_tz，sec_to_time，addtime，adddate，date_sub，timediff，last_day，weekday，from_unixtime，unix_timestamp，subdate，day，year，weekofyear，dayofmonth，dayofyear，week，yearweek，dayofweek，time_format，hour，minute，second，microsecond，quarter，utc_date，get_format，extract，makedate，period_add，timestamppadd，period_diff，utc_time，utc_timestamp，sysdate，current_timestamp，maketime，curtime，current_time，localtime，localtimestamp，now，lc_time_names，default_week_format，json_object，substring。

3. 影响如下类型：
   1. 兼容整型类型tinyint，范围变更为-128 ~ 127。
   2. 兼容字符串类型char、varchar、char(n)和varchar(n)的精度n由字节长度变为字符长度。
   3. 兼容文本类型tinytext、mediumtext和longtext。这些类型在开启参数后会被映射为text类型。
   4. 兼容二进制类型tinyblob、blob、mediumblob和longblob。这些类型在开启参数后会被映射为bytea类型。
   5. 兼容浮点类型double、float和real。double映射为float8类型，double(p, s)映射为numeric类型，float(p, s)映射为numeric类型，real映射为float8，real(p, s)映射为numeric类型。
   6. 兼容高精度类型numeric、dec和decimal。未指定精度和标度时变更默认精度为10，标度为0。
   7. 兼容时间类型datetime、timestamp、time和date。datetime[(p)]替换成timestamp without time zone[(p)]类型。timestamp[(p)] 替换成timestamp with time zone[(p)]类型。这些类型的输入输出、范围、精度等规格有变更，具体请参见数据类型章节下的相关章节。
   8. 兼容整型类型tinyint、smallint、int、bigint，这些类型在开启参数后显示宽度和ZEROFILL属性功能生效。
4. 影响如下语法：

   支持指定列约束ON UPDATE update_expr。

5. 影响如下操作符：
   1. 使用bytea类型间的||操作符报错。
   2. 支持REGEXP操作符。
6. 影响如下GUC参数：

   参数bytea_output='escape'时，处理逻辑发生变化，具体请参见bytea_output参数内容。

s2

包含s1控制的兼容性行为，此外还包含以下影响：

1. 影响如下参数：
   1. 此选项打开时，standard_conforming_strings、escape_string_warning参数被置为off。
   2. 此选项打开时，collation_connection、character_set_connection参数功能才会生效。
2. 影响如下功能：
   1. like操作符对于匹配串末尾是转义符的场景不再报错。
   2. 字符集、字符序的排序规则优先级将发生变更，详细信息请参见字符集和字符序合并规则。
   3. 打开参数后，不支持外键字符序和列上字符序不一致。
3. 影响如下语法：
   1. 支持“CREATE TABLE table_name LIKE source_table”语法。
   2. “CREATE TABLE table_name LIKE source_table”和“CREATE TABLE table_name (LIKE source_table)”语法不支持指定INCLUDING和EXCLUDING选项，缺省等同于指定INCLUDING ALL。
   3. 支持LOAD DATA语法。
   4. 涉及ALTER TABLE，RENAME TABLE等更改表名的语法，影响场景如下：

      新表名对应字符串开头为“#MySQL50#”，且其后有其他字符，“#MySQL50#”将被忽略；如果新旧表名一致，不会报错。

   5. 支持set names指定collate子句。

s1

strict_trans_tables

当前仅支持对MYSQL兼容数据库和M-Compatibility数据库数据类型及系统函数做校验。

设置时，对输入的参数格式和范围做严格校验。无效值输入或者超过范围时，解析报error。

不设置时，对输入的参数格式和范围做宽松校验，无效值输入或者超过范围时，解析报warning，返回对应数据宽松处理后的值。

处理方法：

1、异常数据

字符串插入数值类型时，从第一个非数字开始截断，如'1a'->1。

目标类型为时间类型时，返回对应数据的0值。

2、超出最大范围

返回对应数据的最大/最小值。

可独立设置和取消。

可独立设置和取消。

only_full_group_by

不允许出现非GROUP BY的key值、且不是常量和聚集函数的投影列。

可独立设置和取消。

可独立设置和取消。

no_zero_in_date

不允许日期中的年、月、日是0值。

可独立设置和取消，但无实际作用。

可独立设置和取消。

no_zero_date

不允许日期是0值（0000-00-00）。

可独立设置和取消，但无实际作用。

可独立设置和取消。

error_for_division_by_zero

不允许被0除。

可独立设置和取消，但无实际作用。

可独立设置和取消。

no_auto_create_user

无实际作用，仅用作SET SQL_MODE语句包含此选项时不报错的兼容作用。

可独立设置和取消。

可独立设置和取消。

no_engine_substitution

无实际作用，仅用作SET SQL_MODE语句包含此选项时不报错的兼容作用。

可独立设置和取消。

可独立设置和取消。

pad_char_to_full_length

用于表中的char类型列格式化输出，包含时输出带有尾部空格的字符串，否则输出不带尾部空格字符串。

可独立设置和取消。

可独立设置和取消。

no_auto_value_on_zero

包含此选项后，向AUTO_INCREMENT自动增长列插入0值将不会自增。

可独立设置和取消。

可独立设置和取消。

no_unsigned_subtraction

禁止无符号数减法，如果使用无符号整数进行减法操作，且结果为负数，则会返回一个错误。

可独立设置和取消，但无实际作用。

可独立设置和取消。

ansi_quotes

启用ANSI_QUOTES模式，该模式下双引号被视为标识符引用符号，而不是字符串引用符号。

可独立设置和取消，但无实际作用。双引号总被视为标识符引用符号。

可独立设置和取消。

allow_invalid_dates

允许插入无效日期，如果启用该选项，则MySQL将允许插入无效的日期，例如'0000-00-00'。

可独立设置和取消，但无实际作用。

可独立设置和取消。

real_as_float

默认将REAL类型视为DOUBLE类型，如果启用该选项，则将REAL类型视为FLOAT类型。

可独立设置和取消，但无实际作用。

可独立设置和取消。

strict_all_tables

与strict_trans_tables效果一致。

可独立设置和取消。

可独立设置和取消。

traditional

与同时设置strict_trans_tables、strict_all_tables、no_zero_in_date、no_zero_date、error_for_division_by_zero、no_auto_create_user和no_engine_substitution效果一致。

可独立设置和取消。

可独立设置和取消。

absolute

支持

不支持

不支持

access

支持

不支持

支持

account

支持

不支持

不支持

action

支持

不支持

不支持

active

不支持

不支持

支持

add

支持

不支持

不支持

adddate

不支持

支持

不支持

admin

不支持

不支持

支持

advanced

支持

支持

不支持

algorithm

支持

不支持

不支持

always

支持

不支持

不支持

app

支持

不支持

不支持

append

支持

不支持

不支持

archive

支持

不支持

不支持

array

不支持

不支持

支持

assertion

支持

不支持

不支持

assignment

支持

不支持

不支持

async

支持

不支持

不支持

at

支持

不支持

不支持

audit

支持

不支持

不支持

authentication

不支持

不支持

支持

authid

不支持

不支持

支持

auto

支持

支持

不支持

auto_increment

支持

支持

不支持

autoextend

支持

不支持

不支持

autohint

支持

支持

支持

automapped

支持

不支持

不支持

automatic

支持

支持

不支持

backward

支持

不支持

不支持

bad_path

支持

不支持

不支持

barrier

支持

不支持

不支持

before

支持

不支持

不支持

begin_non_anoyblock

支持

不支持

不支持

blanks

支持

不支持

不支持

blockchain

支持

不支持

不支持

body

支持

不支持

不支持

buckets

不支持

不支持

支持

bulk

不支持

不支持

支持

byte

支持

支持

不支持

byteawithoutorder

支持

不支持

不支持

byteawithoutorderwithequal

支持

不支持

不支持

cache

支持

不支持

不支持

called

支持

不支持

支持

cancelable

支持

不支持

支持

catalog

支持

不支持

不支持

chain

支持

不支持

不支持

challenge_response

不支持

不支持

支持

change

支持

支持

不支持

characteristics

支持

不支持

不支持

charset

支持

支持

不支持

class

支持

不支持

不支持

clean

支持

不支持

不支持

clone

不支持

不支持

支持

client

支持

不支持

不支持

client_master_key

支持

不支持

不支持

client_master_keys

支持

不支持

不支持

columns

支持

支持

不支持

column_encryption_key

支持

不支持

不支持

column_encryption_keys

支持

不支持

不支持

colview

支持

支持

不支持

comment

支持

不支持

不支持

comments

支持

不支持

不支持

compact

支持

不支持

不支持

compatible_illegal_chars

支持

不支持

不支持

compile

支持

支持

不支持

complete

支持

不支持

不支持

completion

支持

支持

不支持

component

不支持

不支持

支持

concurrently

支持

不支持

不支持

condition

支持

不支持

不支持

configuration

支持

不支持

不支持

conflict

不支持

支持

不支持

connection

支持

不支持

不支持

constant

支持

不支持

不支持

containing

支持

支持

不支持

content

支持

不支持

支持

conversion

支持

不支持

不支持

convert

不支持

支持

不支持

coordinator

支持

不支持

不支持

coordinators

支持

不支持

不支持

copy_custom_id

支持

支持

不支持

cost

支持

不支持

不支持

crossbucket

支持

支持

不支持

csn

支持

支持

不支持

csv

支持

不支持

不支持

cube

支持

不支持

不支持

current

支持

不支持

不支持

current_schema

支持

不支持

不支持

cume_dist

不支持

不支持

支持

cycle

支持

不支持

不支持

data

支持

不支持

不支持

datatype_cl

支持

不支持

不支持

datafiles

支持

支持

不支持

date_add

不支持

支持

不支持

date_format

支持

不支持

不支持

date_sub

不支持

支持

不支持

datetime

支持

支持

不支持

day

支持

不支持

不支持

day_hour

支持

支持

不支持

day_microsecond

支持

支持

不支持

day_minute

支持

支持

不支持

day_second

支持

支持

不支持

days

支持

支持

不支持

db4aishot

支持

支持

不支持

dbcompatibility

支持

不支持

不支持

dbtimezone

支持

支持

不支持

deallocate

支持

不支持

不支持

decode

支持

不支持

不支持

deferred

支持

不支持

不支持

definer

支持

不支持

不支持

definition

不支持

不支持

支持

delete_all

支持

支持

不支持

delimiter

支持

不支持

不支持

delimiters

支持

不支持

不支持

delta

支持

不支持

不支持

deltamerge

支持

不支持

不支持

dense_rank

支持

支持

支持

description

不支持

不支持

支持

deterministic

支持

不支持

不支持

dictionary

支持

不支持

不支持

direct

支持

不支持

不支持

directory

支持

不支持

不支持

disable_all

支持

支持

不支持

discard

支持

不支持

不支持

discard_path

支持

支持

不支持

disconnect

支持

不支持

不支持

distribute

支持

不支持

不支持

distributed

支持

支持

不支持

distribution

支持

不支持

不支持

document

不支持

不支持

支持

dumpfile

支持

支持

不支持

duplicate

支持

不支持

不支持

each

支持

不支持

不支持

elastic

支持

不支持

不支持

empty

支持

支持

支持

enable_all

支持

支持

不支持

enclosed

支持

不支持

不支持

encoding

支持

不支持

支持

encrypted

支持

不支持

不支持

encrypted_value

支持

不支持

不支持

encryption

支持

不支持

不支持

encryption_type

支持

不支持

不支持

ends

支持

支持

不支持

enforced

支持

不支持

支持

engine

支持

支持

不支持

engine_attribute

不支持

不支持

支持

entityescaping

支持

支持

不支持

eol

支持

不支持

不支持

errors

支持

不支持

不支持

escaped

支持

支持

不支持

escaping

支持

不支持

不支持

evalname

支持

支持

不支持

event

支持

支持

不支持

events

支持

支持

不支持

every

支持

不支持

不支持

exchange

支持

不支持

不支持

except

不支持

不支持

支持

exclude

支持

不支持

支持

excluding

支持

不支持

不支持

execute

支持

不支持

不支持

exclusive

不支持

不支持

支持

expdp

支持

支持

不支持

expire

支持

支持

不支持

expired

支持

不支持

不支持

extend

支持

支持

不支持

external

支持

不支持

不支持

family

支持

不支持

不支持

fast

支持

不支持

不支持

features

支持

不支持

不支持

factor

不支持

不支持

支持

failed_login_attempts

不支持

不支持

支持

fenced

不支持

不支持

支持

fields

支持

不支持

不支持

fileheader

支持

不支持

不支持

fill_missing_fields

支持

不支持

不支持

filler

支持

不支持

不支持

filter

支持

不支持

不支持

finish

支持

支持

支持

first

支持

不支持

不支持

first_value

不支持

不支持

支持

fixed

支持

不支持

不支持

following

支持

不支持

支持

force

不支持

不支持

支持

formatter

支持

不支持

不支持

forward

支持

不支持

不支持

freeze

支持

不支持

不支持

functions

支持

不支持

不支持

generated

支持

不支持

不支持

generate

不支持

不支持

支持

geomcollection

不支持

不支持

支持

get_format

不支持

支持

不支持

get_master_public_key

不支持

不支持

支持

get_source_public_key

不支持

不支持

支持

granted

支持

不支持

不支持

greatest

支持

不支持

不支持

grouping

支持

不支持

支持

groups

不支持

不支持

支持

gsidead

支持

支持

不支持

gsigetxid

支持

支持

不支持

gsimerge

支持

支持

不支持

gsiready

支持

支持

不支持

gsiswitch

支持

支持

不支持

gsiusable

支持

支持

不支持

gsivalid

支持

支持

不支持

gsiwaitall

支持

支持

不支持

gtid_only

不支持

不支持

支持

hdfsdirectory

支持

不支持

不支持

header

支持

不支持

不支持

high

支持

支持

不支持

hold

支持

不支持

不支持

histogram

不支持

不支持

支持

history

不支持

不支持

支持

hour

支持

不支持

不支持

hour_microsecond

支持

支持

不支持

hour_minute

支持

支持

不支持

hour_second

支持

支持

不支持

hours

支持

支持

不支持

identity

支持

不支持

不支持

ifnull

不支持

支持

不支持

ignore

支持

支持

不支持

ignore_extra_data

支持

不支持

不支持

ilm

支持

支持

不支持

ilm_pidx_list

支持

支持

不支持

imcvtable

支持

支持

不支持

immediate

支持

不支持

不支持

immutable

支持

不支持

不支持

impdp

支持

支持

不支持

implicit

支持

不支持

不支持

inactive

不支持

不支持

支持

include

支持

不支持

不支持

including

支持

不支持

不支持

increment

支持

不支持

不支持

incremental

支持

不支持

不支持

indexes

支持

不支持

不支持

infile

支持

不支持

不支持

inherit

支持

不支持

不支持

inherits

支持

不支持

不支持

initial

支持

不支持

支持

initrans

支持

不支持

不支持

initiate

不支持

不支持

支持

inline

支持

不支持

不支持

inner

支持

不支持

不支持

inout

支持

不支持

不支持

input

支持

不支持

不支持

insensitive

支持

不支持

不支持

instead

支持

不支持

不支持

intersect

不支持

不支持

支持

internal

支持

不支持

不支持

interval

支持

支持

不支持

invisible

支持

支持

支持

invoker

支持

不支持

不支持

isnull

支持

不支持

不支持

json_object

不支持

支持

不支持

json_table

不支持

不支持

支持

json_value

不支持

不支持

支持

keep

支持

支持

不支持

key_path

支持

不支持

不支持

key_store

支持

不支持

不支持

kill

支持

不支持

不支持

keyring

不支持

不支持

支持

label

支持

不支持

不支持

large

支持

不支持

不支持

lag

不支持

不支持

支持

last

支持

不支持

不支持

last_day

不支持

支持

不支持

last_value

不支持

不支持

支持

lateral

不支持

不支持

支持

lc_collate

不支持

不支持

支持

lead

不支持

不支持

支持

leakproof

支持

不支持

支持

least

支持

不支持

不支持

left

支持

不支持

不支持

lines

支持

支持

不支持

link

支持

支持

不支持

listen

支持

不支持

不支持

lnnvl

支持

支持

不支持

load_bad

支持

不支持

支持

load_discard

支持

支持

支持

load_integer_len

支持

支持

不支持

load_session_id

支持

支持

不支持

load_smallint_len

支持

支持

不支持

load_unfixed_len

支持

支持

不支持

load_unfixed_start_pos

支持

支持

不支持

local

支持

不支持

不支持

location

支持

不支持

支持

locked

支持

支持

支持

logging

支持

不支持

不支持

login_any

支持

不支持

不支持

login_failure

支持

不支持

不支持

login_success

支持

不支持

不支持

logout

支持

不支持

不支持

loop

支持

不支持

不支持

low

支持

支持

不支持

manual

支持

支持

不支持

mapping

支持

不支持

不支持

mark

支持

支持

不支持

masking

支持

不支持

不支持

master

支持

不支持

不支持

master_compression_algorithms

不支持

不支持

支持

master_public_key_path

不支持

不支持

支持

master_tls_ciphersuites

不支持

不支持

支持

master_zstd_compression_level

不支持

不支持

支持

match

支持

不支持

支持

matched

支持

不支持

不支持

materialized

支持

不支持

不支持

maxextents

支持

不支持

不支持

maxsize

支持

不支持