更新日期：2024年09月11日
使用 genoncfg 实用程序可加快根据您主机环境以及数据库服务器的预期用途对缺省的
GBase 8s 配置文件 (onconfig.std) 进行定制的过程。
语法
元素
用途
关键注意事项
input_file 包含参数设置的输入文件
的名称
gbs_home
您希望配置的 GBase 8s
安装路径
如果 GBS_HOME 环境变量已被设置，
那么您可以
省略安装路径。
如果已设置 GBS_HOME 变量并且
在命令行进入了该安装路径，
那么实用程序会在
此命令行的路径下运行 。
-h
有关 genoncfg 实用程序
的帮助信息
-V
显示短的版本信息并退出
命令行实用程序
-version
显示扩展的版本信息并退
出命令行实用程序
用法
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 300 -
在运行此实用程序前，请以 root 或用户 gbasedbt 的身份登入主机。
在您成功运行 genoncfg 实用程序之前，必须在输入文件中设置参数对主机环境是可用的。
对于所有的环境，disk 参数在输入文件中是必不可少的。也可以在输入文件中输入指令。
这些指令对于运行实用程序时是非必要的，但是它们在一些场景下会有帮助。
该实用程序不会读取和修改任何已存在的配置文件。如有您在主机环境里有一个预先存在
的 ONCONFIG 文件，当您运行该实用程序，此文件中的参数值不会发生改变。因此，在
将参数应用在数据库服务器实例中之前，可以查看这些建议的参数设置。
使用 genoncfg 实用程序的步骤：
1. 用文本编辑器创建包含 genoncfg 实用程序处理过程的参数值的输入文件。
2. 用输入文件运行该实用程序。该配置文件（名为onconfig）将生成并保存在该工作
目录下。
3. 可选: 重命名生成的配置文件。
4. 如果您想要使用已生成的配置文件运行数据库服务器实例，将该文件复制到
$GBS_HOME/etc。
genoncfg 实用程序的输入文件
使用输入文件来指定以下关于数据库服务器实例的信息：
l 预计联机事务处理系统（OLTP）的连接数
l 预计决策支持系统（DSS）的连接数
l 磁盘空间
l CPU 初始化
l 网络服务连接设置
l 恢复时间
输入文件是一个 ASCII 文本文件。对参数的排列顺序没有要求。 以下是一个输入文件的
样本：
cpus 1
memory 1024 m
connection name demo_on onsoctcp 9088
servernum 1
oltp_connections 10
dss_connections 2
disk /opt/gbs_server/data/storage/online_root 0 k 300 m
directive one_crit
directive debug
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 301 -
表 1. genoncfg 实用程序的输入文件的参数
元素
描述
connection
服务器连接参数：
l 名称 或者 别名 ，取决于连接器的功能。是特定的服务器
名（还是替代服务器名（。
l 连接器的名称
l 连接服务器的类型（在配置文集中等同于 NETTYPE ）
l 服务的端口号
例如：connection name demo_on onsoctcp 9088
cpus
分配给实例的中央处理单元数（CPUs） 例如： cpus 1
directive
genoncfg 实用程序可以使用的指令。
l one_crit: 配置数据库服务器只在 root dbspace 上存储物理
日志、逻辑日志和数据。
l debug: 实时显示有关主机环境和配置文件上操作的信息。
例如： directive one_crit
此信息在解决数据库服务器配置问题时会有帮助。 一种场景是，
调试指令可以导致节省时间。在该场景下，通过读取显示的信息
注意到该实用程序在创建您不想要或不起作用的 onconfig 文
件。您停止该实用程序（尽管它仍在运行），调整输入文件的设
置，然后用修改完成后的输入文件返回实用程序。
disk
为实例设置的磁盘存储空间：
l root dbspace 的位置
l 偏移量的大小,以兆字节（m）或千字节（k）为单位
l root dbspace 的大小，以兆字节（m）或千字节（k ）为单位
例如：
UNIX™: /opt/gbs_server/data/storage/rootdbs
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 302 -
元素
描述
Windows™: d:\INFXDATA\rootdbs
重要： 如果进入 root dbspace 工作实例的路径下，该实例将被覆盖，
并不能使用。
dss_connections
预估该实例的决策处理系统（DSS）的连接数。例如：一个查询客户
端或其它可以获得商业智能设置结果的应用程序可以是一个 DSS
连接。例如： dss_connections 2
memory
实例的内存量（兆字节）。例如 ： memory 1024 m
oltp_connections
估计该实例的联机处理系统（OLTP）的连接数。典型的是，在实例
中修改数据库状态的应用程序时一个 OLTP 连接。例如：
oltp_connections 10
rto_server_restart 指定在重启 GBase 8s 后，进入联机或静默方式，数据库服务器不
得不从一个问题中恢复的时间量
（以秒为单位）
。
该值可设置为 0 以
禁用配置参数，或设置为在 60 和 1800 中的任意一值以启用参数
并指示秒数。 例如： rto_server_restart 100 指定恢复时间对象
为 100 秒
servernum
数据库服务器实例的唯一 ID 例如： servernum 1
视图将包含本节点中每个数据库的统计信息。
名称
类型
描述
datid
oid
数据库的OID。
datname
name
此数据库的名称。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
974
名称
类型
描述
numbackend
s
integer
当前连接到该数据库的后端数。
这是在返回一个反
映目前状态值的视图中唯一的列；
自上次重置所有
其他列返回累积值。
xact_commit
bigint
此数据库中已经提交的事务数。
xact_rollbac
k
bigint
此数据库中已经回滚的事务数。
blks_read
bigint
在这个数据库中读取的磁盘块的数量。
blks_hit
bigint
高速缓存中已经发现的磁盘块的次数，
这样读取是
不必要的（这只包括PostgreSQL 缓冲区高速缓存，
没有操作系统的文件系统缓存）。
tup_returned
bigint
通过数据库查询返回的行数。
tup_fetched
bigint
通过数据库查询抓取的行数。
tup_inserted
bigint
通过数据库查询插入的行数。
tup_updated
bigint
通过数据库查询更新的行数。
tup_deleted
bigint
通过数据库查询删除的行数。
conflicts
bigint
由于数据库恢复冲突取消的查询数量
（只在备用服
务器发生的冲突）。请参见STAT_DATABASE_C
ONFLICTS 获取更多信息。
temp_files
bigint
通过数据库查询创建的临时文件数量。
计算所有临
时文件，不论为什么创建临时文件（比如排序或者
哈希），而且不管log_temp_files 设置。
temp_bytes
bigint
通过数据库查询写入临时文件的数据总量。
计算所
有临时文件，不论为什么创建临时文件，而且不管
log_temp_files 设置。
deadlocks
bigint
在该数据库中检索的死锁数。
blk_read_tim
e
double precision
通过数据库后端读取数据文件块花费的时间，
以毫
秒计算。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
975
名称
类型
描述
blk_write_ti
me
double precision
通过数据库后端写入数据文件块花费的时间，
以毫
秒计算。
stats_reset
timestamp with time
zone
重置当前状态统计的时间。