平台和客户端兼容性

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字符序。
• 若设置此配置项，当表级字符序不为空时，字符类型字段的字符序继承表级字符序，当表级字符序为空时，字符类型字段的字符序设置为数据库编码对应的默认字符序。

all

打开所有语法控制开关。

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

enable_escape_string

转义符控制开关。

• 不设置此配置项时，转义符行为受GaussDB转义符相关的GUC参数standard_conforming_strings、escape_string_warning和backslash_quote控制。
• 设置此配置项时，默认支持除'\0'外的所有MySQL转义符，且gsql客户端中'\b', '\r'和'\Z'回显行为会发生改变，与MySQL客户端保持一致。

enable_conflict_funcs

冲突函数控制开关。

• 不设置此配置项时，ceil、format、instr、position、row_number、regexp_instr、regexp_like、regexp_replace及regexp_substr函数保持GaussDB原生系统函数行为。
• 设置此配置项，且参数m_format_dev_version值为's2'或以上版本时，ceil、format、instr、position及row_number函数为M-Compatibility兼容模式数据局库实现行为。使用regexp_instr、regexp_like、regexp_replace及regexp_substr函数时会报错，提示M-Compatibility兼容模式数据库不支持。

select_column_name

列名回显控制开关。目前只有M兼容模式下支持，在B模式下是不支持的。需要设置m_format_behavior_compat_options ='select_column_name'，特性开关为用户级，缺省关闭。

• 不设置此配置项时：
  • SELECT 系统函数：回显为系统函数名。
  • SELECT 表达式：回显为?column?。
  • SELECT 布尔值：回显为bool。
• 设置此配置项时，列名回显为全部的函数或表达式输入。
  • 仅支持集中式，使用商用客户端测试。
  • 如果显示的列名字符串中含有转义字符，只有在设置了m_format_behavior_compat_options ='enable_escape_string';后才会显示转义后的字符，否则会显示转义字符本身。比如SELECT"abc\tdef";M兼容在未开启上述设置时显示为abc\tdef。

    m_db=# set m_format_behavior_compat_options='select_column_name,enable_escape_string';
    SET
    m_db=# select "abc\tdef";
     abc     def 
    -------------
     abc     def
    (1 row)
    
    m_db=# set m_format_behavior_compat_options='select_column_name';
    SET
    m_db=# select "abc\tdef";
     abc\tdef 
    ----------
     abc\tdef
    (1 row)

  • 列名超过63个字符时，会截断后面部分。
  • 表达式最后的部分为注释时，则不会显示最后的注释以及与注释相连的空格。

    m_db=# SELECT 123        /* 456 */;
     123 
    -----
     123
    (1 row)

  • 表达式为布尔值时，无论输入大小写，回显为TRUE或FALSE。

    m_db=# SELECT true;
     TRUE 
    ------
     t
    (1 row)

  • 表达式为null时，无论输入大小写，回显为NULL。

    m_db=# SELECT null;
     NULL 
    ------
    
    (1 row)

  • 表达式包含-时，会将全部的输入作为列名输出。

    m_db=# SELECT (+-+1);
     (+-+1) 
    --------
         -1
    (1 row)
    
    m_db=# SELECT -true;
     -true 
    -------
        -1
    (1 row)
    
    m_db=# SELECT -null;
     -null 
    -------
    
    (1 row)

enable_precision_decimal

支持数据类型精度。

• 不设置此配置项时：
  • CREATE TABLE SELECT语句只支持SELECT表的列，不支持表达式、函数、常量，以及union场景（因为涉及结果类型推导）。
• 设置此配置项时：
  • CREATE TABLE SELECT语句不受限制上面描述的场景限制。

enable_load_data_remote_transmission

LOAD DATA支持从客户端导入数据。

不设置此项时：LOAD DATA指定local参数后将从服务端所在环境导入文件；

设置此配置项时：LOAD DATA指定local参数后将从客户端所在环境导入数据。

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时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()函数结果默认与A数据库保持一致。

  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类型结果兼容性的配置项。由于B数据库无variadic类型，所以该选项对B数据库无影响。

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

  1 2 3 4 5

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

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

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

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

merge_update_multi

控制在使用MERGE INTO ... WHEN MATCHED THEN UPDATE（参考《开发指南》的“SQL参考 > SQL语法 > MERGE INTO”章节）和INSERT ... ON DUPLICATE KEY UPDATE（参考《开发指南》的“SQL参考 > SQL语法 > 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参数的值为A时生效，并且开启该参数后无论是隐式转换、显式转换还是通过调用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;

rownum_type_compat

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

gaussdb=# set behavior_compat_options='';
gaussdb=# create table tb_test(c1 int,c2 varchar2,c3 varchar2);
gaussdb=# insert into tb_test values(1,'a','b');
gaussdb=# create or replace view v_test as select rownum from tb_test;
gaussdb=# \d+ v_test
                View "public.v_test"
 Column |  Type  | Modifiers | Storage | Description 
--------+--------+-----------+---------+-------------
 rownum | bigint |           | plain   | 
View definition:
 SELECT ROWNUM AS "rownum"
   FROM tb_test;

gaussdb=# set behavior_compat_options = 'rownum_type_compat';
gaussdb=# create or replace view v_test1 as select rownum from tb_test;
gaussdb=# \d+ v_test1
                View "public.v_test1"
 Column |  Type   | Modifiers | Storage | Description 
--------+---------+-----------+---------+-------------
 rownum | numeric |           | main    | 
View definition:
 SELECT ROWNUM AS "rownum"
   FROM tb_test;

gaussdb=# drop view v_test;
gaussdb=# drop view v_test1;
gaussdb=# drop table tb_test;

aformat_null_test

控制rowtype类型判空逻辑。

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

设置此项时，对于rowtype is not null的判断逻辑为当一行数据有一列不为空的时候返回true；不设置此项时，对于rowtype is not null的判断逻辑为当一行数据所有列不为空的时候返回true。该参数不影响rowtype is null的判断。

gaussdb=# set behavior_compat_options='aformat_null_test';
gaussdb=# select r, r is null as isnull, r is not null as isnotnull from (values (1,row(1,2)), (1,row(null,null)), (1,null), (null,row(1,2)), (null,row(null,null)), (null,null) ) r(a,b);
      r      | isnull | isnotnull 
-------------+--------+-----------
 (1,"(1,2)") | f      | t
 (1,"(,)")   | f      | t
 (1,)        | f      | t
 (,"(1,2)")  | f      | t
 (,"(,)")    | f      | t
 (,)         | t      | f
(6 rows)
gaussdb=# set behavior_compat_options='';
gaussdb=# select r, r is null as isnull, r is not null as isnotnull from (values (1,row(1,2)), (1,row(null,null)), (1,null), (null,row(1,2)), (null,row(null,null)), (null,null) ) r(a,b);
      r      | isnull | isnotnull 
-------------+--------+-----------
 (1,"(1,2)") | f      | t
 (1,"(,)")   | f      | t
 (1,)        | f      | f
 (,"(1,2)")  | f      | f
 (,"(,)")    | f      | f
 (,)         | t      | f
(6 rows)

aformat_regexp_match

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

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

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

disable_rewrite_nesttable

开启此参数后，针对pg_type表中tableof类型相关字段的重写会被禁用。即读取pg_type表时，会显示tableof类型实际存储的值。

disable_emptystr2null

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

compat_cursor

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

allow_procedure_compile_check

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

注意：创建密态函数时，需要将allow_procedure_compile_check关闭。

skip_insert_gs_source

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

select_into_return_null

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

plsql_security_definer

开启此参数后，创建存储过程时默认为定义者权限。

proc_outparam_override

控制存储过程出参的重载行为，打开该参数后，对于存储过程只有out出参部分不同的情况，也可以正常创建和调用。目前只有gsql与jdbc连接数据库时可以使用该参数，对于其他工具打开该参数连接数据库时无法正常调用带有out的存储过程。

支持带有out出参的函数返回record类型，且out出参正常赋值。

proc_implicit_for_loop_variable

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

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类型仅支持字符类型、数值类型、列名、函数。函数名支持带有schema、包名。不支持参数带有其他子句（如order by子句）、不支持参数为表达式、仅支持参数带有DISTINCT关键字，不支持带有其他关键字时显示完整函数。
  • 一些特殊函数不支持投影别名显示完整函数。
    • 在非M-Compatibility模式数据库下，包括以下函数：collation for、current_date、current_time、current_timestamp、dbtimezone、localtime、localtimestamp、sysdate、sessiontimezone、rownum、current_role、current_user、session_user、user、current_catalog、current_schema、cast、extract、timestampdiff、overlay、position、substring、treat、trim、nullif、nvl、nvl2、coalesce、greatest、least、lnnvl、regexp_like以及xml函数。
    • 在M-Compatibility模式数据库下，包括以下函数：count、convert、get_format、date、time、timetsamp、date_add、date_sub、adddate、subdate、timestampadd、current_date、repeat、curdate、curtime、current_time、current_timestamp、utc_date、utc_time、utc_timestamp、localtime、localtimestamp、now、sysdate、interval、cast、extract、substr、mid、year、timestampdiff、substring、trim、coalesce、if、char、position、reverse以及default函数。
    • 在M-Compatibility模式数据库下，若同时设置此参数和m_format_behavior_compat_options = 'select_column_name'时，select_column_name优先生效。
  • 一些安全加解密函数、脱敏函数，投影别名显示完整函数可能存在安全问题，在这里就还是仅显示函数名。包括函数：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、dblink_connect、creditcardmasking、basicemailmasking、fullemailmasking、alldigitsmasking、shufflemasking、randommasking、regexpmasking、gs_digest。
  • 不支持=>传参方式调用函数是投影别名显示完整函数，不支持投影别名显示""，如：select "power"(2,3)。
  • 为了让投影别名显示完整函数，本功能不受去除末尾0等参数影响。

proc_outparam_transfer_length

varray_compat

行为差异详情和示例具体可参考《开发指南》中“存储过程 > 数组，集合和record > 数组”章节。

tableof_elem_constraints

开启此参数后：

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

行为差异详情和示例具体可参考《开发指南》中“存储过程 > 数组，集合和record > 集合”章节。

元素合法性校验示例：

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

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时，会获取当前操作系统时间。

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

allow_function_procedure_replace

默认场景下，对于A和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_backcompa

控制在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是否修改当前用户。当开启此参数时，PL/SQL中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

用于游标数据敏感行为的前向兼容，集中式暂不支持该选项。

show_full_error_lineno

用于显示包含存储过程头部信息的行号，创建存储过程打印编译报错信息时，显示从CREATE语句开始的行号；调用有编译问题的语句时，对于非失效重编译场景，显示从CREATE语句开始的行号，失效重编译报错按照原有逻辑显示行号，调用编译显示报错信息需要开启gs_source且该表中存在存储过程的原始定义，否则按照原有逻辑显示报错行号；执行存储过程时报错，设置该参数后，显示从CREATE语句开始的行号。该参数仅在集中式下生效。

gaussdb=# set behavior_compat_options='show_full_error_lineno'; 
gaussdb=# set plsql_compile_check_options='plsql_expression_check';
gaussdb=# CREATE OR REPLACE function proclex1(type1 int) return int 
    is
      var1 int;
      var2 int;
    begin
      var3 := 30; --- var3未定义
    return type1;
    end;
    /
WARNING:  "var3" is not a known variable
DETAIL:  N/A
CONTEXT:  compilation of PL/pgSQL function "proclex1" near line 6
WARNING:  Function created with compilation errors.

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

gaussdb=# CREATE TABLE implicit_index(c1 int1);
CREATE TABLE
gaussdb=# CREATE INDEX idx1 ON implicit_index(c1);
CREATE INDEX
gaussdb=# SET behavior_compat_options='enable_crosstype_integer_operator';
SET
gaussdb=# EXPLAIN SELECT * FROM implicit_index WHERE c1 = 1::int2;
                                   QUERY PLAN                                    
---------------------------------------------------------------------------------
 [Bypass]
 Index Only Scan using idx1 on implicit_index  (cost=0.00..4.48 rows=13 width=1)
   Index Cond: (c1 = 1::smallint)
(3 rows)

gaussdb=# SET behavior_compat_options='';
SET
gaussdb=# EXPLAIN SELECT * FROM implicit_index WHERE c1 = 1::int2;
                           QUERY PLAN                           
----------------------------------------------------------------
 Seq Scan on implicit_index  (cost=0.00..49.52 rows=13 width=1)
   Filter: ((c1)::bigint = 1::smallint)
(2 rows)

gaussdb=# DROP TABLE implicit_index;
DROP TABLE

forbid_package_function_with_prefix

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

例如：

--打开参数
gaussdb=# SET behavior_compat_options='forbid_package_function_with_prefix';
SET

--创建SCHEMA sch1
gaussdb=# CREATE SCHEMA sch1;

--创建PACKAGE后报错
gaussdb=# CREATE PACKAGE pck1
          IS 
          PROCEDURE sch1.pck1();
          END pck1;
          /
ERROR:  not support procedure name use *.* format in package at or near ";"
CONTEXT:  compilation of PL/pgSQL package near line 1

--删除SCHEMA sch1
gaussdb=# DROP SCHEMA sch1;

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语法得到的日期时间跟A数据库保持一致。由于GaussDB只能显示session时区，A可以显示输入的时区，当时区不一致时显示的结果不同，将日期时间转换到相同时区后是同一时间点。

--打开参数前
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

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

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)

10c

A平台兼容版本。

s1

• A平台兼容迭代小版本，影响函数（TRUNC(date, fmt),ROUND(date, fmt),NVL2,LPAD,RPAD,ADD_MONTHS,MONTHS_BETWEEN,REGEXP_REPLACE,REGEXP_COUNT,TREAT,EMPTY_CLOB,INSTRB,trunc(number),greatest,least,mod,round(number),cast,to_date,to_timestamp,chr,rtrim,translate,to_char,to_number，to_timestamp_tz）。
• 数据类型转换：小数字符串转换成整数类型（int1/int2/int4/int8/int16）时进行四舍五入。
• 数据类型转换：支持timestamp with time zone到timestamp without time zone的隐式转换。

s2

• A平台兼容迭代小版本，影响函数（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, rawtohex2, bit2coding, bit4coding）。
• 兼容配置项为s1时的所有行为。

s3

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

s4

• A平台兼容迭代小版本，影响函数nchr(cvalue int|bigint)、to_timestamp_tz、getclobval(xml)、getstringval(xml)。
• 兼容配置项为s3时的所有行为。

s5

• A平台兼容迭代小版本，开启参数，支持复合类型与函数同名，优先解析为复合类型，影响函数sys_guid()。
• 兼容配置项为s4时的所有行为。

s6

• A平台兼容迭代小版本，开启参数，影响函数mod(text, int)。
• 兼容配置项为s5时的所有行为。

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。

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)]类型。这些类型的输入输出、范围、精度等规格有变更，具体见《开发指南》中“SQL参考 > 数据类型”相关章节。
   8. 兼容整型类型tinyint、smallint、int、bigint，这些类型在开启参数后显示宽度和ZEROFILL属性功能生效。
4. 影响如下语法：

   支持指定列约束ON UPDATE update_expr。

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

s2

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

1. 影响如下参数：
   1. 此选项打开时，auto_increment_cache参数功能才会生效。
   2. 此选项打开时，multi_insert_min_rows参数功能对自动增长列生效。
   3. 此选项打开时，standard_conforming_strings、escape_string_warning参数被置为off。
   4. 此选项打开时，collation_connection、character_set_connection参数功能才会生效。
2. 影响如下功能：
   1. AUTO_INCREMENT自动增长列在导入数据或者进行BATCH INSERT执行计划的插入操作时，对于混合0、NULL和确定值的场景，确定值插入时会立即更新自增计数，后续的0/NULL将在确定值的基础上自增。
   2. like操作符对于匹配串末尾是转义符的场景不再报错。
   3. 字符集、字符序的排序规则优先级将发生变更，详见《开发指南》中“SQL参考 > 字符集与字符序 > 字符集和字符序合并规则”章节。
   4. 打开参数后，不支持外键字符序和列上字符序不一致。
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语法，gs_loader中部分与LOAD DATA语法一致的语法功能会发生变化。
   4. 支持set names指定collate子句。
   5. 涉及ALTER TABLE，RENAME TABLE等更改表名的语法，影响场景如下：

      新表名对应字符串开头为“#MySQL50#"，且其后有其他字符，“#MySQL50#"将被忽略。

      如果新旧表名一致，不会报错。

s1

s2

影响如下操作符：

1. ::操作符的转换规则变更为默认隐式转换规则。

影响如下视图：

1. information_schema.statistics视图内INDEX_NAME字段在主键场景由显示primary改为显示PRIMARY；COLUMN_NAME和SUB_PART字段补充了前缀索引场景的支持；临时表索引由显示改为不显示;系统列的索引由部分场景可能会显示改为不显示。
2. information_schema.global_variables视图内数据由显示pg_settings表里面所有数据缩小为pg_settings表里context字段是“internal”、“postmaster”、“backend”、“sighup”数据。
3. information_schema.columns视图内COLUMN_KEY字段补充了前缀索引场景的支持。
4. information_schema.table_constraints视图内CONSTRAINT_NAME字段在主键约束场景由显示约束名改为显示PRIMARY。
5. information_schema.character_sets视图可以查询所有可用字符集信息。
6. information_schema.collations视图可以查询所有可用字符排序规则信息。
7. information_schema.collation_character_set_applicability视图可以查询所有可用排序规则和字符集的对应关系。
8. information_schema.character_sets、information_schema.collations、information_schema.collation_character_set_applicability视图中的CHARACTER_SET_NAME改成小写，查询显示根据字符序细分utf8mb4和utf8。

影响如下语法：

1. 以下事务语法语义改变，改为设置下一个事务特性：
   1. set @@transaction_isolation = value
   2. set @@transaction_read_only = value
   3. set transaction isolation level
   4. set transaction {read write | read only}
2. set transaction 语法语义改变，改为设置会话级事务特性：
   1. set [local|session|@@session.] transaction_isolation = value
   2. set [local|session|@@session.] transaction_read_only = value
3. show transaction_isolation显示为带中划线的隔离级别。
4. 创建生成列不指定STORED和VIRTUAL关键字，默认创建虚拟生成列。
5. SHOW CREATE TABLE语法返回结果集变更，包括：
   1. 列/表注释位置变更，从以COMMENT ON语句形式返回改为在CREATE TABLE语句以COMMENT子句形式中返回；
   2. 主键与唯一约束位置变更，从以ALTER TABLE ADD CONSTRAINT语句形式返回改为在CREATE TABLE语句以CONSTRAINT子句形式作为表约束中返回；
   3. 主键与唯一约束中的USING INDEX TABLESPACE选项不再显示，该选项在设置兼容版本控制开关为s1后被禁用；
   4. 索引注释位置变更，从以COMMENT ON语句形式返回改为在CREATE INDEX语句以COMMENT子句形式返回；
   5. 全局临时表ON COMMIT选项位置变更，从以CREATE TABLE语句WITH子句中on_commit_delete_rows参数形式返回改为在CREATE TABLE语句以ON COMMIT子句形式返回。
6. SHOW CHARACTER SET语法查询使用视图information_schema.character_sets，查询结果随该视图内容的变化而变化。
7. SHOW COLLATION语法查询使用视图information_schema.collations，查询结果随该视图内容的变化而变化。

影响以下GUC参数：

1. 增加transaction_isolation的参数范围。

影响如下功能：

1. 删除生成列的基列需要先删除对应的生成列。
2. 存储生成列的基列不支持指定SET NULL、SET DEFAULT、CASCADE关键字关联 ON UPDATED和ON DELETE动作。
3. ALTER TABLE修改表涉及存储生成列时，生成列的CHECK约束检查生效。

strict_trans_tables

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

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

可独立设置和取消。

可独立设置和取消。

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效果一致。

可独立设置和取消。

可独立设置和取消。

INSERT

on

无需检查，插入成功。

检查完整性，与完整性冲突时，则插入失败。

外键字段无法插入非空值。

off

无需检查，插入成功。

跳过检查，插入成功。

跳过检查，插入成功。

DELETE

on

检查完整性，与完整性冲突时，根据ACTION操作报错或级联修改。

无需检查，删除成功。

无需检查，删除成功。

off

跳过检查，删除成功。

无需检查，删除成功。

无需检查，删除成功。

UPDATE

on

检查完整性，与完整性冲突时，根据ACTION操作报错或级联修改。

检查完整性，与完整性冲突时，则更新失败。

外键字段无法更新为非空值。

off

跳过检查，更新成功。

跳过检查，更新成功。

跳过检查，更新成功。

REPLACE INTO

on

检查完整性，与完整性冲突时，根据ACTION操作报错或级联修改。

检查完整性，与完整性冲突时，则操作失败。

外键字段无法新增或被更新为非空值。

off

跳过检查，操作成功。

跳过检查，操作成功。

跳过检查，操作成功。

s1

设置gs_loader在导入过程中数据文件存在nul字符处理方式。当数据文件中存在nul字符时，会根据nul字符的位置对数据进行截断，nul字符前的数据会被导入到表中，nul字符后的数据会被截断丢弃，用作功能的前向兼容。

s2

设置gs_loader在导入过程中数据文件存在nul字符处理方式。当数据文件中存在nul字符时，会先将nul字符转换成为空格字符" "(0x20)，再进行加工，判断和导入。

空值

参数默认配置，不影响任何功能使用。

s1

• 支持gs_loader指定数据类型（CHAR[(length)]/INTEGER external[(length)]/FLOAT external[(length)]/DECIMAL external[(length)]/TIMESTAMP/DATE/DATE EXTERNAL/INTEGER/SMALLINT/RAW[(length)]）导入数据。
• 支持gs_loader列表达式使用场景扩展。
• gs_loader导入数据的CSV模式下，会跳过字段开头空格。并且当某个字段第一个非空格字符不是enclosed字符时，忽略enclosed设置。当未匹配到关闭enclosed字符，先匹配到行末时，会进行报错。

1

bit_length(string)

2

btrim(string text [, characters text])

3

char_length(string)

character_length(string)

4

chr(cvalue int|bigint)

chr(integer)

5

concat(str1,str2)

6

concat_ws(sep text, str"any" [, str"any" [, ...] ])

7

decode(string text, format text)

8

dump(expr[, return_fmt [, start_position [, length ] ] ])

9

encode(data bytea, format text)

10

find_in_set(text, set)

11

format(formatstr text [, str"any" [, ...] ])

12

left(str text, n int)

13

length(string)

14

lengthb(text/bpchar)

15

ltrim(string [, characters])

16

md5(string)

17

notlike(x bytea name text, y bytea text)

18

octet_length(string)

19

overlay(string placing string FROM int [for int])

20

quote_ident(string text)

21

quote_literal(string text)

22

quote_nullable(string text)

23

rawcat(raw,raw)

24

regexp_count(string text, pattern text [, position int [, flags text]])

25

regexp_instr(string text, pattern text [, position int [, occurrence int [, return_opt int [, flags text]]]])

26

regexp_like(source_string, pattern [, match_parameter])

regexp_like(text,text,text)

27

regexp_matches(string text, pattern text [, flags text])

28

regexp_replace(string, pattern, replacement [,flags ])

29

regexp_split_to_array(string text, pattern text [, flags text ])

30

regexp_split_to_table(string text, pattern text [, flags text])

31

regexp_substr(source_char, pattern)

regexp_substr(string text, pattern text [, position int [, occurrence int [, flags text]]])

32

repeat(string text, number int )

33

repexp_replace(string text, pattern text [, replacement text [, position int [, occurrence int [, flags text]]]])

34

replace(string text, from text, to text)

35

replace(string, substring)

36

reverse(str)

37

right(str text, n int)

38

rtrim(string [, characters])

39

sha(string)

40

sha1(string)

41

sha2(string，hash_length)

42

split_part(string text, delimiter text, field int)

43

substring(string [from int] [for int])

substring(string from pattern for escape)

substring(string from pattern)

44

substring_inner(string [from int] [for int])

45

tconvert(key text, value text)

46

to_single_byte(char)

47

translate(string text, from text, to text)

48

trim([leading |trailing |both] [characters] from string)

49

unistr(string)

50

vsize(expr)

51

PKG_UTIL.RAW_CAST_FROM_VARCHAR2

52

PKG_UTIL.LOB_CONVERTTOCLOB

53

PKG_UTIL.LOB_RAWTOTEXT

54

PKG_UTIL.LOB_TEXTTORAW

55

PKG_UTIL.RAW_CAST_TO_VARCHAR2

56

DBE_OUTPUT.PUT

57

DBE_OUTPUT.PUT_LINE

sqrt_karatsuba

• 设置此参数：表示在调用sqrt平方根函数时使用Karatsuba平方根算法，karatsuba算法性能更高但是在极少数情况下精度可能会和牛顿迭代算法不一致。
• 不设置此参数：在计算sqrt平方根算法时会使用默认的牛顿迭代算法进行平方根的计算。

allow_textconcat_null

• 设置此参数：在PG兼容模式下字符串和null值拼接会返回对应的字符串的值。

  -- 在PG兼容模式下执行
  gaussdb=# set gs_format_behavior_compat_options='allow_textconcat_null';
  SET
  gaussdb=# select 'a' || null || 'b';
   ?column?
  ----------
   ab
  (1 row)
  

• 不设置此参数：在PG兼容模式下字符串和null值拼接会返回NULL。

1

btrim(string text [, characters text])

2

char_length(string) 或 character_length(string)

3

chr(cvalue int|bigint)

4

chr(integer)

5

coalesce(expr1, expr2, ..., exprn)

6

concat(str1,str2)

7

concat_ws(sep text, str"any" [, str"any" [, ...] ])

8

convert(string bytea, src_encoding name, dest_encoding name)

9

convert_from(string bytea, src_encoding name)

10

convert_to(string text, dest_encoding name)

11

decode(base_expr, compare1, value1, Compare2,value2, … default)

12

dump(expr[, return_fmt [, start_position [, length ] ] ])

13

encode(data bytea, format text)

14

format(formatstr text [, str"any" [, ...] ])

15

greatest(expr1 [, ...])

16

group_concat([DISTINCT | ALL] expression [,expression ...] [ORDER BY { expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ] } [,...]] [SEPARATOR str_val])

17

initcap(string)

18

instr(string,substring[,position,occurrence])

instr(text,text,int,int)

19

instrb(text,text,int,int)

20

least(expr1 [, ...])

21

left(str text, n int)

22

length(string)

length(string bytea, encoding name )

23

lengthb(text/bpchar)

24

listagg(expression [, delimiter]) WITHIN GROUP(ORDER BY order-list)

25

lower(string)

26

lpad(string text, length int [, fill text])

27

ltrim(string [, characters])

28

nls_lower(string [, nlsparam])

29

nls_upper(string [, nlsparam])

30

nullif(expr1, expr2)

31

nvl( expr1 , expr2 )

32

nvl2( expr1 , expr2，expr3 )

33

overlay(string placing string FROM int [for int])

34

position(substring in string)

35

quote_nullable(string text)

36

regexp_count(string text, pattern text [, position int [, flags text]])

37

regexp_instr(string text, pattern text [, position int [, occurrence int [, return_opt int [, flags text]]]])

38

regexp_like(text,text,text)

regexp_like(source_string, pattern [, match_parameter])

39

regexp_matches(string text, pattern text [, flags text])

40

regexp_replace(string, pattern, replacement [,flags ])

41

regexp_split_to_array(string text, pattern text [, flags text ])

42

regexp_split_to_table(string text, pattern text [, flags text])

43

regexp_substr(source_char, pattern)

regexp_substr(string text, pattern text [, position int [, occurrence int [, flags text]]])

44

repeat(string text, number int )

45

replace(string text, from text, to text)

replace(string, substring)

46

reverse(str)

47

right(str text, n int)

48

rpad(string text, length int [, fill text])

49

rtrim(string [, characters])

50

similar_escape(pat text, esc text)

51

split_part(string text, delimiter text, field int)

52

string [NOT] LIKE pattern [ESCAPE escape-character]

53

string || string 或 string || non-string 或 non-string || string

54

string_agg(expression, delimiter)

55

strpos(string, substring)

56

substr(string,from)

substr(bytea,from,count)

substr(string,from,count)

57

substrb(text,int)

substrb(text,int,int)

58

substring(string [from int] [for int])

substring(string from pattern for escape)

substring(string from pattern)

substring_inner(string [from int] [for int])

59

translate(string text, from text, to text)

60

trim([leading |trailing |both] [characters] from string)

61

unistr(string)

62

upper(string)

63

PKG_UTIL.LOB_GET_LENGTH

64

PKG_UTIL.LOB_READ

65

PKG_UTIL.LOB_WRITE

66

PKG_UTIL.LOB_APPEND

67

PKG_UTIL.LOB_COMPARE

68

PKG_UTIL.LOB_MATCH

69

PKG_UTIL.LOB_READ_HUGE

70

PKG_UTIL.LOB_WRITEAPPEND_HUGE

71

PKG_UTIL.LOB_APPEND_HUGE

72

PKG_UTIL.LOB_COPY_HUGE

73

PKG_UTIL.LOB_CONVERTTOBLOB_HUGE

74

PKG_UTIL.IO_PRINT

75

PKG_UTIL.RAW_CAST_FROM_VARCHAR2

76

PKG_UTIL.FILE_READ

77

PKG_UTIL.FILE_READLINE

78

PKG_UTIL.APP_READ_CLIENT_INFO

79

PKG_UTIL.APP_SET_CLIENT_INFO

80

PKG_UTIL.LOB_CONVERTTOBLOB

81

PKG_UTIL.LOB_CONVERTTOCLOB

82

PKG_UTIL.MATCH_EDIT_DISTANCE_SIMILARITY

83

PKG_UTIL.RAW_CAST_TO_VARCHAR2

84

PKG_UTIL.APP_SET_MODULE

85

PKG_UTIL.APP_READ_MODULE

86

PKG_UTIL.APP_SET_ACTION

87

PKG_UTIL.APP_READ_ACTION

88

DBE_OUTPUT.PRINT_LINE

89

DBE_OUTPUT.PRINT

90

DBE_OUTPUT.GET_LINE

91

DBE_OUTPUT.GET_LINES

92

DBE_OUTPUT.PUT

93

DBE_OUTPUT.PUT_LINE

94

DBE_UTILITY.CANONICALIZE

95

DBE_UTILITY.COMMA_TO_TABLE

96

DBE_UTILITY.NAME_TOKENIZE

97

DBE_UTILITY.TABLE_TO_COMMA

98

DBE_UTILITY.CANONICALIZE_RET

99

DBE_UTILITY.COMMA_TO_TABLE_FUNC

100

DBE_UTILITY.NAME_SEPARATE

101

DBE_UTILITY.NAME_TOKENIZE_FUNC

102

DBE_UTILITY.NAME_TOKENIZE_LOWER

103

DBE_UTILITY.NAME_TOKENIZE_LOWER_FUNC

104

DBE_UTILITY.TABLE_TO_COMMA_FUNC

1

PKG_UTIL.SESSION_SET_CONTEXT

2

PKG_UTIL.UTILITY_COMPILE_SCHEMA

3

PKG_UTIL.GS_COMPILE_SCHEMA

4

DBE_UTILITY.NAME_RESOLVE

5

DBE_UTILITY.COMPILE_SCHEMA

6

DBE_UTILITY.SEARCH_CLASS_WITH_NSPOID_ONAME_TYPE

7

DBE_UTILITY.SEARCH_OBJECTS

8

DBE_UTILITY.SEARCH_OBJECTS_SYNONYM_FILL_SCHEMA

9

DBE_UTILITY.SEARCH_PROCEDURE_WITH_NSPOID_ONAME

10

DBE_UTILITY.SEARCH_SYNONYM_WITH_NSPOID_ONAME

SSSSS与时间冲突

保留时间（分钟，小时）中的值以及SSSSS中的秒数部分的值。

W，J与时间日期冲突

优先级：J，W，mmdd按顺序进行覆盖。

W：未指定时，默认为星期三。

默认行为：W覆盖mmdd。

SSSSS与SS冲突

保留SS，舍弃SSSSS。

DDD与日期冲突

舍弃DDD。