华为云首页用户手册

云数据库 GAUSSDB-平台和客户端兼容性:behavior_compat_options

时间：2024-11-02 18:48:57

云数据库 GAUSSDB

behavior_compat_options

参数说明：数据库兼容性行为配置项，该参数的值由若干个配置项用逗号隔开构成。

该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

取值范围：字符串

默认值：""

当前只支持平台和客户端兼容性。
配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set behavior_compat_options='end_month_calculate,display_leading_zero';

表1 兼容性配置项

兼容性配置项

兼容性行为控制

display_leading_zero

浮点数显示配置项。

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

end_month_calculate

add_months函数计算逻辑配置项。

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

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

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

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

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

compat_analyze_sample

analyze采样行为配置项。

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

bind_schema_tablespace

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

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

bind_procedure_searchpath

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

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

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

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

correct_to_number

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

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

unbind_divide_bound

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

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

convert_string_digit_to_numeric

控制是否将表中字符串类型字段和数字类型做比较时统一都转换为numeric类型再进行比较。

return_null_string

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

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

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

(1 row)

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

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

compat_concat_variadic

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

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

merge_update_multi

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

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

plstmt_implicit_savepoint

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

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

hide_tailing_zero

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

例如：

set behavior_compat_options='hide_tailing_zero';
select cast(123.123 as numeric(15,10));
numeric
---------
123.123
(1 row)

plsql_security_definer

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

char_coerce_compat

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

truncate_numeric_tail_zero

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

array_count_compat

控制array.count函数，参数开启时，函数返回0，否则返回null。

aformat_regexp_match

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

设置此项，且sql_compatibility参数的值为A或B时，正则表达式的 flags 参数支持的选项含义有变更：

. 默认不能匹配 '\n' 字符。
flags 中包含n选项时， . 能够匹配 '\n' 字符。
regexp_replace(source, pattern replacement) 函数替换所有匹配的子串。
regexp_replace(source, pattern, replacement, flags) 在 flags值为'' 或者null时，返回值为null。

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

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

disable_emptystr2null

关闭text、clob、blob、raw字符串类型默认将空串转换为null功能。

上一篇：云数据库 GAUSSDB-平台和客户端兼容性:sql_compatibility

下一篇：云数据库 GAUSSDB-平台和客户端兼容性:sql_compatibility