[Bug]: DATA_BUFFER_SIZE参数无法在线配置，运行时值不更新，与文档动态生效描述不符，且默认值不为128mb-oGRAC-AtomGit

已关闭

[Bug]: DATA_BUFFER_SIZE参数无法在线配置，运行时值不更新，与文档动态生效描述不符，且默认值不为128mb #306

wuchenlong创建于 7月31日关闭于 23 天前

wuchenlong成员

7月31日创建

测试类型

SQL功能
资料

测试版本

7.0.0LTS

操作系统和硬件信息

openEuler release 24.03 (LTS) aarch64

测试环境

oGRAC双节点

操作步骤

-- 预置：oGRAC 7.0.0-RC3（实测 build c9914d4，2026-07-29），节点 20.20.20.104（node0）db=ONLINE
-- 1) 查看当前值
show parameters DATA_BUFFER_SIZE;
-- 2) 尝试在线调大（文档称支持动态生效/在线调大）
alter system set DATA_BUFFER_SIZE = '5G';
-- 3) 再次查看运行值
show parameters DATA_BUFFER_SIZE;

预期输出

按文档（oGRAC-docs database_reference.md 数据库参数配置说明 全局共享内存 DATA_BUFFER_SIZE）描述，该参数应「动态生效」「仅支持在线调大」，执行 alter system set DATA_BUFFER_SIZE='5G' 后，RUNTIME_VALUE（运行时值）应即时更新为 5G，EFFECTIVE 应为 immediate。
以及默认值并非为128MB

实际输出

SQL> show parameters DATA_BUFFER_SIZE;

NAME             DATATYPE          VALUE    RUNTIME_VALUE   EFFECTIVE
DATA_BUFFER_SIZE OG_TYPE_INTEGER   4G       4G              reboot

SQL> alter system set DATA_BUFFER_SIZE = '5G';
Succeed.

SQL> show parameters DATA_BUFFER_SIZE;

NAME             DATATYPE          VALUE    RUNTIME_VALUE   EFFECTIVE
DATA_BUFFER_SIZE OG_TYPE_INTEGER   5G       4G              reboot

-- 仅存储值(VALUE)变为 5G，运行时值(RUNTIME_VALUE)仍为 4G，EFFECTIVE=reboot
-- 追加测试：
SQL> alter system set DATA_BUFFER_SIZE = '5G' scope=memory;
Succeed.   -- 运行时值仍为 4G

SQL> alter system set DATA_BUFFER_SIZE = '5G' scope=spfile;
OG-00601, [1:48]Sql syntax error: invalid scope value

日志信息

oGRAC 双节点 20.20.20.104（node0 db=ONLINE）执行，节点 20.20.20.106（node1）当前 db=OFFLINE（环境维护中）。

资料出处：oGRAC-docs docs/zh/database_reference/database_reference.md「数据库参数配置说明 → 1. 全局共享内存 → DATA_BUFFER_SIZE」，其中明确写「动态生效」「仅支持在线调大；如需调小，需修改配置文件或使用 SCOPE=PFILE，并重启数据库生效」。

实测表现：DATA_BUFFER_SIZE 的 EFFECTIVE 为 reboot（与 SHARED_POOL_SIZE / TEMP_BUFFER_SIZE 等 SGA 共享内存参数一致），alter system set（含 scope=memory）只更新 VALUE，RUNTIME_VALUE 不变化，即无法在线调大，只能重启生效，与文档描述矛盾。

提单组织

测试团队

wuchenlong成员

7月31日添加了label：bug

opengauss_bot成员

7月31日评论：

This issue requires an assignee. Since you haven't specified one, we've assigned TestManager as the default assignee for this issue.

opengauss_bot成员

7月31日将 TestManager 设为负责人

opengauss_bot成员

7月31日添加了label：sig/StorageEngine

opengauss_bot成员

7月31日评论：

Welcome To openGauss Community

Hey @wuchenlong , thanks for your contribution to the community.

Bot Usage Manual

I'm the Bot here serving you. You can find the instructions on how to interact with me at Here . That means you can comment below every pull request or issue to trigger Bot Commands.

Contact Guide

If you have any questions, please contact the SIG: StorageEngine ,
and any of the maintainers: @CarrotGo, @chendong76, @chenxiaobin19, @congzhou2603, @dodders, @hwworkholic, @jemappellehc, @muyulinzhong, @quemingjian, @shenzheng4, @shirley_zhengx, @superlchf, @totaj, @wlff234, @wofanzheng, @ywzq1161327784 ,
and any of the committers: @CityYard, @libiao2024, @lijieac, @theothersideofsea, @wang_bowen, @weithu, @xiong_xjun, @yuanyazhi, @zhangzq131 .

wuchenlong成员

7月31日修改标题为 “[Bug]: DATA_BUFFER_SIZE参数无法在线配置，运行时值不更新，与文档动态生效描述不符，且默认值不为128mb”，原标题为“[Bug]: DATA_BUFFER_SIZE参数无法在线配置，运行时值不更新，与文档动态生效描述不符”

此处折叠了7条事件消息查看更多

leweiyang成员

28 天前关联了pull request：修复文档中对readline能力边界和 DATA_BUFFER_SIZE 生效条件的介绍 #293 #306

leweiyang成员

26 天前评论：

根据当前实际情况更新了文档

leweiyang成员

25 天前关联了pull request：在700分支上修复DATA_BUFFER_SIZE 生效条件的介绍

leweiyang成员

24 天前 issue状态由待办的改变为待回归

wuchenlong成员

23 天前评论：

回归版本：oGRAC Release 7.0.0-RC3 18ce0a2 build 2026-08-26 09:48:01
回归环境：oGRAC 双节点（20.20.20.104 / 20.20.20.106），db=ONLINE，节点 20.20.20.104 执行（106 仅 SHOW 对照）
结论：通过（行为仍为重启生效；文档已改为与实测一致，不再写「动态生效 / 仅支持在线调大」）

说明：本单为资料与行为不符。开发已更新 database_reference.md「DATA_BUFFER_SIZE」：重启生效、VALUE 可改、RUNTIME_VALUE 不变、EFFECTIVE=reboot；缺省值区分内核回退 128M、模板 2G、LUN 自动调优下限 4G。

完整回归 SQL

show parameters DATA_BUFFER_SIZE;
alter system set DATA_BUFFER_SIZE = '5G';
show parameters DATA_BUFFER_SIZE;
alter system set DATA_BUFFER_SIZE = '5G' scope=memory;
show parameters DATA_BUFFER_SIZE;
-- 回归后已还原
alter system set DATA_BUFFER_SIZE = '4G';

实际输出
安装后初始（LUN 自动调优，与文档「下限 4G」一致）：

NAME             VALUE  RUNTIME_VALUE  EFFECTIVE
DATA_BUFFER_SIZE 4G     4G             reboot

ALTER SYSTEM SET ... = '5G'（默认 scope）Succeed 后：

NAME             VALUE  RUNTIME_VALUE  EFFECTIVE
DATA_BUFFER_SIZE 5G     4G             reboot

scope=memory 同样 Succeed，RUNTIME_VALUE 仍为 4G。
节点 106 SHOW 结果同为 4G / 4G / reboot。
已将 VALUE 还原为 4G。

wuchenlong成员

23 天前 issue状态由待回归改变为已验收

wuchenlong成员

23 天前关闭了 issue