gbase数据、南大通用产品文档：GBase8sPN_STAGEBLOB_THRESHOLD 配置参数

使用 PN_STAGEBLOB_THRESHOLD 配置参数来为轮转法分片中的 BYTE 和 TEXT 数据保留空
间。
onconfig.std 值
未设置。
如未出现
0
值
0 - 1000000
单位
KB
生效
编辑 onconfig 文件并重启数据库服务器之后。
当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值时。
当您通过运行 onmode -wm 命令重置内存中的该值时。
用法

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 120 -

设置这个配置参数为存储在表中的 BYTE 或 TEXT 数据的典型或平均大小。
限制： 如果 extent 的数目已经达到允许的最大 extent，或如果 dbspace 填满，则
PN_STAGEBLOB_THRESHOLD 配置参数没有影响。
当表达到一个分片的页的最大数目时，可通过添加新的分片来向表添加更多页。然而，如
果表中包含 BYTE 或 TEXT 列，且按轮转法分发方案分片表，则添加新分片不会自动地使
新行能够插入到新分片内。
例如，如果表中的分片之一达到了最大页数，则添加新分片不会扩展表来存储更多行。因
为 BYTE 和 TEXT 数据属于大型数据，所以在所有分片中平均地分发之前，该数据在其中
一个分片中 staged。 此 staging 分片必须有充足的空间来存储 BYTE 或 TEXT 数据。使
用 PN_STAGEBLOB_THRESHOLD 配置参数以便数据库服务器可在一个 staging 分片中临时
地 stage BYTE 或 TEXT 数据，直到 INSERT 操作完成且永久地将数据存储在表中。
在 UPDATE 操作期间，如果分片没有 PN_STAGEBLOB_THRESHOLD 配置参数中指定的空间，
则受更新处理影响的表行会移到另一分片内。

语法
gcadmin --help
功能

GBase UP 产品手册 4 管理员指南

文档版本04（2021-04-21） 南大通用数据技术股份有限公司 190
查看gcadmin 所有命令参数的帮助信息。

跟踪（SQL 管理 API）
随同 admin() 或 task() 函数，
使用 set sql tracing database 参数来启动或停止对数据库的跟
踪，或罗列哪些数据库正被跟踪。
语法

元素
描述
关键考虑
database_name 数据库名。 指定一个数据库名。

用法
使用 set sql tracing database add 参数来指定对一个或多个数据库的跟踪，而不是跟踪所有
数据库。缺省为所有数据库。在单个 admin() 或 task() 函数中指定至多六个参数。数据库
名的最大数目可设置为 16。
使用 set sql tracing database clear 参数来从正被跟踪的数据库列表清除所有数据库。跟踪返
回到缺省的全部数据库。
使用 set sql tracing database list 参数来罗列正被跟踪的数据库。

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 806 -
使用 set sql tracing database remove 参数来从正被跟踪的数据库列表移除单个数据库。
当您使用 set sql tracing database 参数时，
仅可指定一个数据库的名称。
在您可有最多 16 个
数据库名时，必须在分别的函数调用中指定每一附加的数据库。您每次调用该函数时，该
函数添加另一数据库到列表，直到列表包含 16 个数据库。
示例
下列示例设置对名为 db1、db2 和 db3的三个数据库设置 SQL 跟踪：
EXECUTE FUNCTION task("set sql tracing database add","db1");
EXECUTE FUNCTION task("set sql tracing database add","db2");
EXECUTE FUNCTION task("set sql tracing database add","db3");