文档首页/ 云数据库 GaussDB/ 开发指南（分布式_8.x）/ 配置运行参数/ GUC参数说明/ GUC使用说明
更新时间：2024-08-20 GMT+08:00
查看PDF
分享

GUC使用说明

数据库提供了许多GUC参数，配置这些参数可以影响数据库系统的行为。在修改这些参数时请确保用户理解了这些参数对数据库的影响，否则可能会导致无法预料的结果。

注意事项

  • 升级场景下参数的默认值会优先保证兼容性，即升级后的默认值与老版本的取值一致。
  • 参数中如果取值范围为字符串，此字符串应遵循操作系统的路径和文件名命名规则。
  • 取值范围最大值为INT_MAX的参数，此选项最大值跟所在的操作系统有关。其值为数据类型INT的最大值，值为2147483647‬。
  • 取值范围最大值为DBL_MAX的参数，此选项最大值跟所在的操作系统有关。其值为数据类型FLOAT的最大值。
  • 部分GUC参数会影响函数/操作符的选择、存储过程的编译以及执行计划的生成，从而会影响到视图、函数参数默认值、存储过程编译产物以及计划缓存的行为。由于这些机制原因，后续GUC参数变更可能不会再影响这些行为。
    • 视图：数据库在视图定义时会根据当前GUC参数状态生成重写规则，后续对视图操作时直接使用对应重写规则而不再受GUC参数（会影响重写规则生成的参数）的影响。
    • 函数参数默认值：如果函数参数默认值使用了函数，数据库在创建该函数时会根据当前GUC参数状态为默认值参数选择对应的函数并记录选中的函数oid到对应系统表中（pg_proc），后续执行该函数时会使用系统表中记录的函数oid给默认值参数赋值而不再受GUC参数的影响。
    • 存储过程编译产物：数据库对存储过程进行编译时会根据当前GUC参数状态生成编译产物，执行存储过程时直接使用编译产物而不再受GUC参数（会影响编译产物生成的参数）的影响。
    • 计划缓存：数据库在执行SQL时会根据当前GUC参数状态生成对应的执行计划，如果将该计划缓存起来后，后续再执行该SQL将直接使用该计划而不再受GUC参数（会影响执行计划生成的参数）的影响。

    有影响GUC参数如下表（GUC参数具体功能详见对应GUC参数）：

    GUC参数

    打开参数

    关闭参数

    影响点

    示例

    convert_string_to_digit

    优先将字符串转为数字

    不支持打开参数时优先将字符串转为数字的行为。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    		 
    CREATE or REPLACE FUNCTION test(c numeric) RETURN text package
AS
BEGIN
RETURN 'test(c numeric)';
END;
/
CREATE or REPLACE FUNCTION test(c varchar2) RETURN text package
AS
BEGIN
RETURN 'test(c varchar2)';
END;
/

SET convert_string_to_digit=on;
CREATE or REPLACE VIEW test_view AS SELECT test('123'::text);

SELECT test('123'::text);
test
-----------------
test(c numeric)
(1 row)

SELECT * FROM test_view;
test
-----------------
test(c numeric)
(1 row)

--关闭参数
SET convert_string_to_digit=off;

SELECT test('123'::text);
test
------------------
test(c varchar2)
(1 row)

--视图行为和直接调用函数行为不一致
SELECT * FROM test_view;
test
-----------------
test(c numeric)
(1 row))

    set behavior_compat_options = 'current_sysdate';

    SYSDATE函数获取当前操作系统时间（底层使用current_sysdate函数）

    SYSDATE函数获取当前数据库时间（底层使用sysdate函数）。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    		 
    SET behavior_compat_options = 'current_sysdate';
CREATE or REPLACE VIEW test_view_SYSDATE AS SELECT SYSDATE AS test;
SELECT * FROM test_view_SYSDATE;--返回当前操作系统时间
SELECT SYSDATE;--返回当前操作系统时间
--关闭参数
SET behavior_compat_options = '';
--视图行为和直接调用函数行为不一致
SELECT * FROM test_view_SYSDATE;--返回当前操作系统时间
SELECT SYSDATE;--返回当前数据库时间

    set a_format_version='10c';

    set a_format_dev_version='s1';
    • 新增支持NVL2。
    • 新增部分系统函数：具体见a_format_disable_func参数支持的被禁用系统函数。
    • case when返回类型有变更。
    • 集合类型构造器优先级高于函数。
    • 支持timestamp到timestamptz的隐式转换。

    不支持打开参数时功能。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    		 
    SET a_format_version='10c';
SET a_format_dev_version='s1';

CREATE OR REPLACE VIEW test_view_nvl2 AS SELECT nvl2(1,2,3) AS test;
SELECT * FROM test_view_nvl2;
test
------
2
(1 row)

RESET a_format_dev_version;

SELECT * FROM test_view_nvl2;
test
------
2
(1 row)

    set a_format_version='10c';

    set a_format_dev_version='s2';
    • 新增支持CURRENT_TIMESTAMP '(' FCONST ')'。
    • 新增支持DBTIMEZONE。
    • 新增支持LNNVL。
    • CURRENT_DATE（a_format_date_timestamp =off 情况下）：返回日期+时间（timestamp）。
    • 新增部分系统函数：具体见a_format_disable_func参数支持的被禁用系统函数。

    不支持打开参数时功能。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    		 
    SET a_format_version='10c';
SET a_format_dev_version='s2';

CREATE or REPLACE VIEW test_view_LNNVL AS SELECT LNNVL(123=123) AS test;
SELECT * FROM test_view_LNNVL;

RESET a_format_dev_version;

SELECT * FROM test_view_LNNVL;

    set a_format_version='10c';

    set a_format_dev_version='s4';

    新增部分系统函数：具体见a_format_disable_func参数支持的被禁用系统函数。

    不支持打开参数时功能。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    -

    set a_format_version='10c';

    set a_format_dev_version='s5';
    • 新增部分系统函数：具体见a_format_disable_func参数支持的被禁用系统函数。
    • 复合类型构造器优先级高于函数。

    不支持打开参数时功能。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    		 
    --复合类型构造器优先级高于函数：
CREATE TYPE tt AS  (
val1 int,
val2 int
);
CREATE OR REPLACE FUNCTION tt(va int, vb int)
RETURN int IS
ret int;
BEGIN
ret := va;
RETURN ret;
END;
/

SET a_format_version='10c';
SET a_format_dev_version='s5';

--赋值给tt变量
CREATE OR REPLACE FUNCTION test0
RETURN int IS
va  tt;
ret int;
BEGIN
va := tt(1,2);
RAISE INFO 'tt: %' ,va;
ret := 9;
RETURN ret;
END;
/

SELECT test0();
INFO:  tt: (1,2)
test0
-------
9
(1 row)

SET a_format_version='';
SET a_format_dev_version='';

SELECT test0();
INFO:  tt: (1,2)
test0
-------
9
(1 row)

--赋值给tt变量
CREATE OR REPLACE FUNCTION test0
RETURN int IS
va  tt;
ret int;
BEGIN
va := tt(1,2);
RAISE INFO 'tt: %' ,va;
ret := 9;
RETURN ret;
END;
/

select test0();
ERROR:  cannot assign non-composite value to a row variable

    set behavior_compat_options = 'enable_bpcharlikebpchar_compare';

    启用bpcharlikebpchar和bpcharnlikebpchar操作符。

    关闭bpcharlikebpchar和bpcharnlikebpchar操作符。

    视图、存储过程编译产物、计划缓存

    		 
    CREATE TABLE op_test (
col BPCHAR(2) DEFAULT NULL
);
CREATE INDEX op_index ON op_test(col);

INSERT INTO op_test VALUES ('a');
INSERT INTO op_test VALUES ('1');
INSERT INTO op_test VALUES ('11');
INSERT INTO op_test VALUES ('12');
INSERT INTO op_test VALUES ('sd');
INSERT INTO op_test VALUES ('aa');

SET behavior_compat_options = 'enable_bpcharlikebpchar_compare';

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)

CREATE OR REPLACE VIEW test_view_bpchar AS SELECT * FROM op_test WHERE col LIKE col::BPCHAR ORDER BY col;

EXPLAIN SELECT * FROM test_view_bpchar;
QUERY PLAN
----------------------------------------------------------------
Sort  (cost=34.48..34.50 rows=10 width=12)
Sort Key: op_test.col
->  Seq Scan on op_test  (cost=0.00..34.31 rows=10 width=12)
Filter: (col OPERATOR(pg_catalog.~~) col)
(4 rows)

SET behavior_compat_options = '';

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)

EXPLAIN SELECT * FROM test_view_bpchar;
QUERY PLAN
----------------------------------------------------------------
Sort  (cost=34.48..34.50 rows=10 width=12)
Sort Key: op_test.col
->  Seq Scan on op_test  (cost=0.00..34.31 rows=10 width=12)
Filter: (col OPERATOR(pg_catalog.~~) col)
(4 rows)

--关闭开关的情况下重新创建视图：
CREATE OR REPLACE VIEW test_view_bpchar AS SELECT * FROM op_test WHERE col LIKE col::BPCHAR ORDER BY col;

explain select * from test_view_bpchar;
QUERY PLAN
----------------------------------------------------------------
Sort  (cost=39.34..39.37 rows=10 width=12)
Sort Key: op_test.col
->  Seq Scan on op_test  (cost=0.00..39.17 rows=10 width=12)
Filter: (col ~~ (col)::text)
(4 rows)

    set b_format_version='5.7';

    set b_format_dev_version='s1';
    • CURDATE、CURRENT_TIME、CURRENT_TIMESTAMP、LOCALTIME、LOCALTIMESTAMP NOW返回语句执行时间。
    • SYSDATE返回函数执行时间。

    函数返回事务开始时间。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    -

    set b_format_version='5.7';

    set b_format_dev_version='s1';

    DB_JSOBJ、LAST_DAY_FUNC、EXTRACT、TIMESTAMPDIFF、SUBSTRING函数行为变更为与MYSQL一致。

    恢复默认行为。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    -

    set behavior_compat_options = 'bind_procedure_searchpath';
    • 未指定模式名的存储过程中的数据库对象的搜索路径配置项。
    • 在存储过程中如果不显示指定模式名，会优先在存储过程所属的模式下搜索。

    恢复默认行为。

    存储过程编译产物

    -

    set behavior_compat_options = 'enable_out_param_override';

    控制存储过程出参的重载行为。

    恢复默认行为。

    存储过程编译产物

    -

    enable_bitmapscan

    scan算子选择bitmapscan。

    scan算子不选择bitmapscan。

    计划缓存

    		 
    SET enable_auto_explain=true;
SET auto_explain_level=notice;
CREATE TABLE t1( a int, b int, c int,d varchar)WITH(storage_type=ustore);
CREATE TABLE t2( a int, b int, c int,d varchar)WITH(storage_type=ustore);
INSERT INTO t1 SELECT i,10*random()*i,i%20,'atr'||i from generate_series(1,1000) i;
CREATE INDEX index1 ON t1(a);

SET enable_bitmapscan=on;
SET enable_seqscan=off;
SET enable_indexscan=off;
CREATE OR REPLACE PROCEDURE proc_while_loop()
AS
DECLARE
i int :=1;
BEGIN
WHILE i < 5 LOOP
INSERT INTO t2 SELECT * FROM t1 WHERE a = i ;
i:=i+1;
END LOOP;
END;
/
CALL proc_while_loop();
SET enable_bitmapscan=off;
CALL proc_while_loop();
SET enable_bitmapscan=on;
CALL proc_while_loop();

    enable_indexscan

    scan算子选择indexscan。

    scan算子不选择indexscan。

    计划缓存

    		 
    SET enable_auto_explain=true;
SET auto_explain_level=notice;
CREATE TABLE t1( a int, b int, c int,d varchar)WITH(storage_type=ustore);
CREATE TABLE t2( a int, b int, c int,d varchar)WITH(storage_type=ustore);
INSERT INTO t1 SELECT i,10*random()*i,i%20,'atr'||i from generate_series(1,1000) i;
CREATE INDEX index1 on t1(a);
SET enable_bitmapscan=off;
SET enable_seqscan=off;
CREATE OR REPLACE PROCEDURE proc_while_loop()
AS
DECLARE
i int :=1;
BEGIN
WHILE i < 5 LOOP
insert into t2 select * from t1 where a = i ;
i:=i+1;
END LOOP;
END;
/
CALL proc_while_loop();
SET enable_indexscan=off;
CALL proc_while_loop();

    query_Dop

    用户自定义的查询并行度。开启SMP功能，系统会使用设定的并行度执行。

    默认值为1，1表示关闭并行查询。

    计划缓存

    		 
    SET enable_auto_explain=true;
SET auto_explain_level=notice;
CREATE TABLE t1( a int, b int, c int,d varchar)WITH(storage_type=ustore);
CREATE TABLE t2( a int, b int, c int,d varchar)WITH(storage_type=ustore);
INSERT INTO t1 SELECT i,10*random()*i,i%20,'atr'||i from generate_series(1,1000) i;
CREATE INDEX index1 ON t1(a);
SET enable_bitmapscan=f;
CREATE OR REPLACE PROCEDURE proc_while_loop()
AS
DECLARE
i int :=1;
BEGIN
WHILE i < 5 LOOP
INSERT INTO t2 SELECT /*+ indexscan(t1 index1) */* FROM t1 WHERE a = i ;
i:=i+1;
END LOOP;
END;
/
SET enable_auto_explain=true;
SET auto_explain_level=notice;
SET client_min_messages=log;
SET query_dop=4;
SET sql_beta_feature='enable_plsql_smp';
CALL proc_while_loop();
SET enable_force_Smp=on;
CALL proc_while_loop();
SET query_Dop=6;
CALL proc_while_loop();

    set plan_cache_mode = force_generic_plan

    pbe情况下，强制执行gplan。

    pbe情况下，不强制执行gplan。

    计划缓存

    		 
    SET enable_auto_explain=true;
SET auto_explain_level=notice;
CREATE TABLE t1( a int, b int, c int,d varchar)WITH(storage_type=ustore);
CREATE TABLE t2( a int, b int, c int,d varchar)WITH(storage_type=ustore);
INSERT INTO t1 SELECT i,10*random()*i,i%20,'atr'||i from generate_series(1,1000) i;
CREATE INDEX index1 ON t1(a);
SET enable_bitmapscan=on;
SET enable_seqscan=off;
SET enable_indexscan=off;
CREATE OR REPLACE PROCEDURE proc_while_loop()
AS
DECLARE
i int :=1;
BEGIN
WHILE i < 5 LOOP
insert into t2 select * from t1 where a = i ;
i:=i+1;
END LOOP;
END;
/
CALL proc_while_loop();
SET plan_cache_mode = force_generic_plan;
PREPARE aa AS SELECT proc_while_loop();
EXECUTE aa;
SET enable_bitmapscan=off;
EXECUTE aa;

    a_format_date_timestamp

    CURRENT_DATE返回当前SQL启动的时间戳。

    CURRENT_DATE返回事务开启的日期或日期及时间。

    视图、函数参数默认值、存储过程编译产物、计划缓存

    		 
    SET a_format_date_timestamp=on;
CREATE OR REPLACE PROCEDURE proc_while_loop()
AS
DECLARE
i date;
BEGIN
i:=current_date;
raise info 'step2:%',TO_CHAR(current_date, 'MM-DD-YYYY HH24:MI:SS');
END;
/
CALL proc_while_loop();
SET a_format_date_timestamp=off;
CALL proc_while_loop();

    adjust_systemview_priority

    同名视图优先访问用户自定义视图。

    同名视图优先访问系统视图。

    视图参数默认值

    		 
    CREATE DATABASE database_test DBCOMPATIBILITY = 'ORA';
SELECT datname,datcompatibility,dattimezone FROM pg_database;
\c database_test
CREATE TABLE t1(c int);
CREATE VIEW dual AS SELECT * FROM t1;
SHOW adjust_systemview_priority;
SELECT * FROM dual;
SET adjust_systemview_priority = on;
SELECT * FROM dual;
父主题： GUC参数说明