gbase数据、南大通用产品文档：GBase8c创建目录

在部署机上创建GBase 8c 数据库的安装目录。
配置文件中pkg_path 参数值需与安装目录保持一致。建议设置为
/home/gbase/gbase_package，即yml 文件中pkg_path 参数默认值。
限制

确保上级目录的所有者（owner）为gbase 用户，且具有读写权限。若gbase 在上级目录
不具有创建权限，可使用sudo 授予权限。
例如，创建/mnt/sdb/data 目录，但/mnt 所有者为root。可执行以下命令：
[gbase@gbase8c ~]$ sudo mkdir -p /mnt/sdb/data
[gbase@gbase8c ~]$ sudo chown -R gbase:gbase /mnt/sdb/

安装包及解压文件均在该安装目录下即可。
例如，数据库安装目录为/home/gbase/gbase_package，则具体操作如下：
[root@gbase8c ~]$ su gbase
[gbase@gbase8c ~]$ mkdir -p /home/gbase/gbase_package
[gbase@gbase8c ~]$ cd /home/gbase/
[gbase@gbase8c ~]$ ll
drwxxrwxr-x 9 gbase gbase 4096 Ort 22 14:15 gbase_package

值
一个或多个 TLS 版本。以逗号分隔多个版本。
 1.0 = TLS 版本 1.0。
 1.1 = TLS 版本 1.1。
 1.2 = TLS 版本 1.2。

生效
编辑 onconfig 文件并重启数据库服务器之后。

用法

TLS 是“安全套接字层”（SSL）的后继者，提供客户端/服务器连接
的密码协议。为了计算机的通信，它们必须有一个共同的 TLS 版本，
与那个 TLS 级别的一个有效数字证书在一起。 例如，如果两台计算
机启用 TLS 1.0、1.1 和 1.2，但其中一台计算机的数字证书仅支持
TLS 1.0，则该连接将在 TLS 1.0 一级。
TXTIMEOUT 配置参数
使用 TXTIMEOUT 配置参数来指定在开始参与者恢复之前，在两阶
段提交中一个参与者等待的时间量。这个参数仅用于涉及远程数据库
服务器的分布查询。非分布查询不使用这个参数。

onconfig.std 值
TXTIMEOUT 300
值
正整数
单位
秒
生效

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 235
编辑 onconfig 文件并重启数据库服务器之后。

当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值
时。

当您通过运行 onmode -wm 命令重置内存中的该值时。
UNSECURE_ONSTAT 配置参数
使用 UNSECURE_ONSTAT 配置参数来移除数据库系统管理员
（DBSA）用户 onstat 命令的访问限制。

onconfig.std 值
未设置。
值
1 = 所有用户可运行 onstat 命令来查看正在运行的 SQL 语句
生效
编辑 onconfig 文件并重启数据库服务器之后。

用法

缺省情况下，
限制 DBSA 用户从活动的会话使用显示 SQL 语句文本的
onstat 命令。要移除这个限制，请设置 UNSECURE_ONSTAT 配置参数
为 1。显示 SQL 语句的 onstat 命令包括 onstat
-g
his、onstat
-g
ses、onstat -g stm、onstat -g ssc 和 onstat -g sql。
UPDATABLE_SECONDARY 配置参数
使用 UPDATABLE_SECONDARY 配置参数来设置在主服务器与辅
助服务器之间要建立的连接数。设置这个配置参数使得客户端应用能
够在一台高可用性辅助服务器上执行更新、插入和删除操作。

onconfig.std 值
UPDATABLE_SECONDARY 0
值

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 236
从零（缺省值）直到两倍于 CPU
VP 数目的任何数。设置该值为 0 配
置辅助服务器为只读。设置该值为从 1 值 CPU
VP 数目的两倍，使得
辅助服务器可更新并配置连接线程。
单位
在一给定的辅助服务器与其主服务器之间的网络连接数目
生效
编辑 onconfig 文件并重启数据库服务器之后。

“辅助数据复制服务器”的隔离级别

如果 UPDATABLE_SECONDARY 配置参数未设置或设置为零，
则辅助数据
复制服务器为只读。
在这种情况下，
在辅助服务器上仅 DIRTY
READ 或
READ UNCOMMITTED 事务隔离级别可用。

如果 UPDATABLE_SECONDARY 参数设置为一个大于零的有效连接数，
则
辅助数据复制服务器可支持 COMMITTED READ、COMMITTED READ LAST
COMMITTED 或 COMMITTED READ 事务隔离级别，或者
USELASTCOMMITTED 会话环境变量。仅 SQL DML 语句，诸如 INSERT、
UPDATE、MERGE 和 DELETE 和 dbexport 实用程序，可支持在可更新
的辅助服务器上写操作。
（除了 UPDATABLE_SECONDARY 之外，
还必须
设置 STOP_APPLY 和 USELASTCOMMITTED 配置参数通过在辅助数据复
制服务器上的 dbexport 来启用写操作。）
USELASTCOMMITTED 配置参数
使用 USELASTCOMMITTED 配置参数来指定隔离级别，
COMMITTED READ 隔离级别的 LAST COMMITTED 特征是隐含
有效的。

onconfig.std 值
USELASTCOMMITTED "NONE"
缺省值
"NONE"
值

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 237
"NONE"
= 未标识隔离级别。当尝试在 Committed
Read、Dirty
Read、
Read
Committed 或 Read
UncommittedNo 隔离级别中读一行时，如果
您的会话遇到排他锁，则您的事务不可读那一行，直到持有该排他锁
的并发事务提交或回滚。

"COMMITTED
READ"
= 所有来自 Committed
Read 隔离级别的事务都视
为最后提交事务。当数据库服务器在试图读一个 Committed Read 或
Read
Committed 隔离级别中的行时遇到一个排他锁，
数据库服务器读
该数据的最近提交版本。

"DIRTY
READ"
= 所有来自 Dirty
Read 隔离级别的事务都视为最后提
交事务。如果数据库服务器在试图读一个 Dirty Read 或 Read
Uncommitted 隔离级别中的行时遇到一个排他锁，则数据库服务器读
该数据的最近提交版本。

"ALL" = 所有来自 Committed Read 和 Dirty Read 两个隔离级别的
事务都视为最后提交事务。如果数据库服务器在试图读一个
Committed
Read、Dirty
Read、Read
Committed 或 Read
Uncommitted
隔离级别中的行时遇到一个排他锁，则数据库服务器读该数据的最近
提交版本。
生效
编辑 onconfig 文件并重启数据库服务器之后。

当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值
时。

当您通过运行 onmode -wm 命令重置内存中的该值时。

用法

LAST COMMITTED 特征可减小在有排他行锁的表上并发事务之间发生
锁定冲突的风险。USELASTCOMMITTED 配置参数还可为 SET
TRANSACTION 语句的 READ COMMITTED 和 READ UNCOMMITTED 隔离级
别启用 LAST COMMITTED 语义。


GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 238
USELASTCOMMITTED 配置参数仅与那些已经创建或更改为锁定颗粒度
的 ROW 级别的表一起工作。没有以任何锁模式设置创建的表使用
DEF_TABLE_LOCKMODE 中的缺省设置。
如果 DEF_TABLE_LOCKMODE 设置
为 PAGE，
则 USELASTCOMMITTED 配置参数不可访问表中的最近提交数
据，未提交的事务在这些表上持有排他锁，除非这些表明确地变更为
锁定颗粒度的 ROW 级别。

与共享磁盘辅助数据库服务器一起使用

在“共享磁盘”
（SD）辅助数据库服务器上，USELASTCOMMITTED 配置
参数也有效。下列表显示 SD 辅助服务器上 USELASTCOMMITTED 配置
参数的有效值及其描述。

表 71. 有效的辅助服务器 USELASTCOMMITTED 值
USELASTCOMMITTE
D 值
描述
NONE
COMMITTED READ LAST COMMITTED 不是会话的
缺省隔离级别
COMMITTED READ
COMMITTED READ LAST COMMITTED 是所有带有
Committed Read 隔离的会话的缺省隔离级别
DIRTY READ
COMMITTED READ LAST COMMITTED 是所有带有
Dirty Read 隔离的会话的缺省隔离级别
ALL
COMMITTED READ LAST COMMITTED 是所有带有
Committed
Read 或 Dirty
Read 隔离的会话的
缺省隔离级别

USEOSTIME 配置参数
onconfig.std 值
USEOSTIME 0
值
0 = 关
1 = 开

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 239

生效
初始化期间
参考

 GBase 8s 性能指南
 使用 CURRENT 函数来返回 datetime 值，在 GBase 8s
SQL 指南：语法 中

用法

设置 USEOSTIME 为 1 指定当数据库服务器从操作系统为 SQL 语句
获取当前时间时，数据库服务器要使用亚秒精度。下列示例显示
datetime 值中的亚秒：
2001-09-29 12:50:04.612

如果不需要亚秒精度，则数据库服务器每秒从操作系统检索当前时间
一次，
使得客户端应用的时间精度为一秒。
如果设置 USEOSTIME 为 0，
则当前函数为该年向分数域返回零（.000）。

当数据库服务器的主机计算机有亚秒精度时钟时，
其 SQL 语句依赖于
亚秒精确度的应用应设置 USEOSTIME 为 1。

与关闭 USEOSTIME 运行的系统相比，
USEOSTIME 设置为非零的系统注
意到性能下降达 4% 至 5%。

从应用程序到 GBase 8s 内嵌语言库函数，这个设置不影响任何关
于时间的调用。
USERMAPPING 配置参数（UNIX(TM)，Linux(TM)）
使用 USERMAPPING 配置参数来设置数据库服务器是否接受来自
映射用户的连接。

缺省值

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 240
OFF
值
OFF = 仅在有登录服务的 GBase 8s 主机计算机 OS 中注册的那些用
户可连接到数据库服务器。在 GBase 8s 主机计算机上没有 OS 账
号的外部认证的用户不可连接到数据库服务器资源。
BASIC = 没有 OS 账户的用户可连接到 GBase
8s 。即使没有 OS 账
户的用户映射到服务器管理员用户或组 ID，
该用户也不可在数据库服
务器上执行有权限的用户操作。

ADMIN = 没有 OS 账户的用户可连接到 GBase
8s 。如果用户以一个
有权限的用户身份得到认证，
且映射到正确的服务器管理员组 ID，
则
该用户可在数据库服务器上执行 DBSA、DBSSO 或 AAO 的工作。

生效
编辑 onconfig 文件并重启数据库服务器之后。

当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值
时。

当您通过运行 onmode -wm 命令重置内存中的该值时。

用法

当通过设置带有 BASIC 或 ADMIN 值的参数开启 USERMAPPING 时，
在
GBase 8s 主机计算机上没有操作系统（OS）账户的外部认证的用户
可访问数据库服务器资源。
BASIC 或 ADMIN 的设置还确定映射用户能
否获得管理权限。

重要： 在为映射的用户建立 GBase 8s 中，将 USERMAPPING 配置
参数从 OFF 更改为 ADMIN 或 BASIC 不是唯一的步骤。 要以适当的
用户属性映射用户，您还必须使用诸如 CREATE USER 和 ALTER USER
这样的 DLL 语句，
在 SYSUSER 数据库的适当系统表中来注册这些值。

依赖于使用的 DDL 语句和定义的表映射，将更新或填入下列表：
 SYSINTAUTHUSERS
 SYSUSERMAP

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 241
 SYSSURORGATES
 SYSSURROGATEGROUPS
USRC_HASHSIZE 配置参数
USRC_HASHSIZE 配置参数指定 LBAC 凭证内存高速缓存中散列
存储区的数目。
这个内存高速缓存持有关于用户 LBAC 凭证的信息。


onconfig.std 值
USRC_HASHSIZE 31
值
任何正整数
单位
KB
生效
编辑 onconfig 文件并重启数据库服务器之后。
USRC_POOLSIZE 配置参数
USRC_POOLSIZE 配置参数指定在 LBAC 凭证内存高速缓存的每
一散列存储区中条目的最大数。这个内存高速缓存持有关于用户
LBAC 凭证的信息。

onconfig.std 值
USRC_POOLSIZE 127
值
正值 127 或更大，
表示高速缓存中条目的初始最大数目的一半。
该最
大值依赖于共享内存配置和服务器实例的可用共享内存。
生效
编辑 onconfig 文件并重启数据库服务器之后。

当您通过运行 onmode -wm 命令增加内存中的该值时。

当您通过运行 onmode -wm 命令重置内存中的该值时。


GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 242
高速缓存中条目的初始数目是 USRC_POOLSIZE 配置参数值的两倍。
例
如，
如果 USRC_POOLSIZE 配置参数设置为 127，
则该高速缓存中允许
254 个条目。
如果高速缓存中的所有条目填满，
则高速缓存大小自动
地增长 10%。要减小高速缓存的大小，请降低 onconfig 文件中
USRC_POOLSIZE 配置参数的值并重启服务器。
USTLOW_SAMPLE 配置参数
当您在 LOW 模式中运行 UPDATE STATISTICS 语句时，使用
USTLOW_SAMPLE 配置参数来根据样例启用索引统计信息的生成。

对于有多于 100 K 叶子页的索引，使用样例收集统计信息可提高
UPDATE STATISTICS 操作的速度。

onconfig.std 值
USTLOW_SAMPLE 1
值
0 = 禁用样例
1 = 启用样例

生效
编辑 onconfig 文件并重启数据库服务器之后。

当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值
时。

当您通过运行 onmode -wm 命令重置内存中的该值时。
VP_MEMORY_CACHE_KB 配置参数
使用 VP_MEMORY_CACHE_KB 参数来为每一 CPU 虚拟处理器
创建私有内存高速缓存。

onconfig.std 值
VP_MEMORY_CACHE_KB 0
值

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 243
0 = 关

所有私有内存高速缓存的合计大小，可选地后跟逗号和高速缓存的模
式。
大小，以 KB 为单位：
 SHMTOTAL 配置参数指定从 800 到等于内存限制的 40%
的一个数目。

模式：
 STATIC = 缺省。指定的大小是结合了所有私有内存高速
缓存大小的最大值。
 DYNAMIC
= 指定的大小是所有私有内存高速缓存的初始大
小。高速缓存大小动态地变更，但不能超过 SHMTOTAL 配
置参数的值。

生效
编辑 onconfig 文件并重启数据库服务器。

当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值
时。

当您通过运行 onmode -wm 命令重置内存中的该值时。

用法

在 GBase 8s 服务器中，私有内存高速缓存可提高线程分配的内存
性能。私有内存高速缓存不影响分配给缓冲池或共享内存通信使用的
内存。

当您将 VP_MEMORY_CACHE_KB 配置参数的值设置为非零数目时，为每
一 CPU 虚拟处理器创建一个私有内存高速缓存。
缺省情况下，
所有私
有内存高速缓存相结合的大小限定在指定的 KB 数。

如果您想要根据需要自动地增加或减少每一私有内存高速缓存的大
小，则请在大小之后包括一个逗号和词 DYNAMIC，例如，

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 244
VP_MEMORY_CACHE_KB
1000,DYNAMIC。
虽然所有私有内存高速缓存相结
合的最大初始大小不可超过 SHMTOTAL 配置参数值的 40%，带有
DYNAMIC 模式设置，但高速缓存的大小可扩展超出初始的限制。高速
缓存的合计大小不可超过 SHMTOTAL 配置参数的值。

注意： 在繁忙系统上的动态内存高速缓存可快速地增长，并使用大
量可用内存。
为此，
如果您设置模式为 DYNAMIC，
则请设置 SHMTOTAL
配置参数为一特定限制，
而不是缺省值 0，
设置为 0 不限制内存的数
量。

如果您重置 VP_MEMORY_CACHE_KB 配置参数为 0，则内存高速缓存被
清空并禁用。

onstat -g vpcache 命令返回关于私有内存高速缓存的统计信息。
VPCLASS 配置参数
使用 VPCLASS 配置参数来创建和配置虚拟处理器。

onconfig.std 值

UNIX
(TM): VPCLASS cpu,num=1,noage

Windows
(TM):VPCLASS cpu,num=1,noage#VPCLASS aio,num=1#VPCLASS
jvp,num=1

值
最多 128 字节字符。每一 VPCLASS 配置参数值必须是唯一的，以一
个字母或下划线开头，且仅包含数字、字母、下划线或 $ 字符。不包
括空格。请参阅“用法”部分。
分隔符
以逗号分隔每一域。
生效
编辑 onconfig 文件并重启数据库服务器之后。


GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 245
用法

您可在 onconfig 文件中添加多个 VPCLASS 配置参数条目。每一
VPCLASS 配置参数必须描述一个不同的虚拟处理器类。每一定义置于
单独的行上。

VPCLASS 配置参数的语法


CPU CLASS


表 72. VPCLASS 配置参数值的选项
域
值
class
class 值是虚拟处理器类的名称。数据库服务器
根据需要启动大多数虚拟处理器。典型地，您可
能为 CPU、AIO、JVP 和用户定义的虚拟处理器类
设置 VPCLASS 配置参数。
虚拟处理器类名不区分大小写。

要查看类名称的列表，
请参阅虚拟处理器的类型。



GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 246
域
值
user_defined
user_defined 值是您为用户定义的例程创建的
虚拟处理器类名称。
请确保 SINGLE_CPU_VP 配置参数设置为 0。

autotune
指定数据库服务器是否根据需要为指定的类添加
虚拟处理器来提高性能，如果包括 max 选项，则
最多达 max 选项的值。
autotune=0 防止自动添加虚拟处理器
autotune=1 启用虚拟处理器的自动添加

如果该类是 cpu，
则自动地添加的任何 CPU 虚拟
处理器都没有 affinity。忽略 aff 选项。

cpu
指定 CPU 虚拟处理器类。
num
number_vps 值设置指定类的虚拟处理器数目，
当
数据库服务器启动时数据库服务器启动这个类。
缺省值是 1。
cpu 和 aio 虚拟处理器类的值域是
1 - 10000。所有其他虚拟处理器类的值域是 0 -
10000。
您可使用 onmode
-p 命令来为当前会话的类添加
虚拟处理器。

max
maximum 值指定数据库服务器可为该类启动的虚
拟处理器的最大数目。
该值可为大于 0 的任何整
数。缺省情况下，该数目是无限制的。
aff
在支持处理器 affinity 的多处理器计算机上，
aff 选项指定数据库服务器绑定 CPU 虚拟处理
器的那些 CPU。操作系统将这些 CPU 编号，从 0
至小于 CPU 数目的一个数。缺省情况下，以轮转
法方式将CPU 虚拟处理器分派到可用处理器。
aff
选项为一个或多个整数：
processor = 将 CPU 虚拟处理器绑定到得那个
CPU 编号。CPU 编号可以任何顺序罗列。
start = CPU 编号范围的起始。

GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 247
域
值
end = CPU 编号范围的终止。
increment = 指定在一个使用的范围中 CPU 编号
的因子。
例如，
aff=(1-5/2) 指定使用 CPU 编
号 1、3 和 5。

noage
如果操作系统实现优先级 aging，
则对于 CPU 虚
拟处理器禁用优先级 aging。缺省情况下，优先
级 aging 有效。
noyield
指定用户定义的虚拟处理器类不 yield，允许 C
UDR yield 给其他需要访问用户定义的虚拟处理
器类的线程。缺省情况下，用户定义的虚拟处理
器的线程 yield。
非 yielding 用户定义的虚拟处理器类以一种方
式运行用户定义的线程，即给线程排他使用虚拟
处理器类。
使用非 yield 虚拟处理器类的用户定
义的线程串行地运行，且从不将该虚拟处理器
yield 给另一个线程。

因为 UDR 运行在单个虚拟处理器上直到完成，
且
任何附加的虚拟处理器都会空闲，所以在非
yielding 用户定义的虚拟处理器类中仅指定一
个虚拟处理器。


这些选项可以任何顺序出现，以逗号分隔。

使用 onmode -p 命令来动态地添加或移除当前数据库会话的虚拟处
理器。onmode -p 命令不更新 onconfig 文件。

CPU 虚拟处理器


GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 248
在单处理器计算机上，
仅分配一个 CPU 虚拟处理器。
在多处理器计算
机上，
分配的 CPU 虚拟处理器加上用户定义的虚拟处理器的总数目最
多达到计算机上的 CPU 数。

当数据库服务器启动时，CPU 虚拟处理器的数目自动地增加到数据库
服务器计算机上 CPU 处理器数目的一半，除非启用 SINGLE_CPU_VP
配置参数。

如果包括 autotune 选项，
则数据库服务器根据需要添加 CPU 虚拟处
理器来提高性能，最多达到计算机上的 CPU 数。

当数据库服务器自动地添加 CPU 虚拟处理器时，不更新 CPU 类
VPCLASS 配置参数的 num 选项。

您可配置处理器 affinity 和是否允许 aging。例如，下列条目创建
绑定到 CPU 编号 7、
8、
9 和 10 的四个 CPU 虚拟处理器，
且不受优
先级 aging 的影响：

VPCLASS CPU,num=4,aff=(7-10),noage

AIO 虚拟处理器

使用 AIO 虚拟处理器类的 VPCLASS 配置参数条目来指定 AIO 虚拟
处理器的确切数目，
或启用数据库服务器来根据需要添加 AIO 虚拟处
理器。

当没有为 AIO 虚拟处理器类设置 VPCLASS 配置参数条目时，由
AUTO_AIOVPS 配置参数的设置确定 AIO 虚拟处理器的数目，
且限定到
128：
 如果 AUTO_AIOVPS 设置为 1
（开）
，
则初始启动的 AIO 虚
拟处理器数目等于 AIO chunk 的数目。
 如果 AUTO_AIOVPS 设置为 0（关），则启动的 AIO 虚拟
处理器数目等于 6 或 AIO chunk 的数目之中较大的一
个。


GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 249
Java
(TM) 虚拟处理器

如果您使用 Java
(TM) 用户定义的例程或 Java
(TM) 应用，则通过为 JVP
虚拟处理器类添加 VPCLASS 配置参数条目，
创建至少一个 Java
(TM) 虚
拟处理器。如果您设置 JVP 的数目为零，或如果没有 JVP 类的
VPCLASS 参数，则您不可运行 Java
(TM) UDR。
WSTATS 配置参数
使用 WSTATS 配置参数来指定 onstat -g wst 命令是否显示系统内
线程的等待统计信息。

注意： 由于收集统计信息的成本，您应预期产生小的性能影响。不
建议为生产系统启用 WSTATS 配置参数。

onconfig.std 值
WSTATS 0
值域
0 = 禁用等待统计信息
1 = 启用等待统计信息

生效
编辑 onconfig 文件并重启数据库服务器之后。

当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值
时。

当您通过运行 onmode -wm 命令重置内存中的该值时。


GBase 8s 数据库配置参数参考
南大通用数据技术股份有限公司 250

功能
这个参数用于设置是否记录express.log。
参数取值含义说明

如果这个参数设为1，则记录日志，日志路径为：
$GBASE_BASE/log/$GBASE_SID；

如果这个参数设为0，则不记录日志。

GBase 8a MPP Cluster 产品手册
6 附录
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
1582
该参数默认值是1。
表6- 59 参数值范围说明表
默认值
最小值
最大值
1
0
1