更新日期：2024年09月11日
使用 onmode -wi 命令导出包含多个配置参数的新值的文件。如果参数视可调整的，那么
可以使用 onmode -wm 命令单独地更新，数据库服务器将应用这些新值。
语法:
元素
用途
关键注意事项
path_name 上一次导出的配置文件的
完整或相对路径
用法
使用 onmode -wi 导入配置文件比运行有关多个可调整配置参数的 onmode -wm 命令更加
快速和方便。
导入操作会忽略文件中不可调整的配置参数。该操作也会忽略与被当前实例使用所匹配的
新的参数的值。
导出文件之后，您可以修改此导出配置参数的值。
导入操作仅会更改内存中配置参数的值。
该操作不会影响 $GBS_HOME/etc/$ONCONFIG 文件
中的值。
onmode -wi 命令等同于带有 wi 参数或 import 参数的 onmode SQL 管理 API 命令。
示例
以下命令导出了 /tmp 目录下名为 onconfig3 文件中的配置参数：
onmode -wi /tmp/onconfig3
资源管理中静态池参数max_memory 的设置原
则
问题现象
静态池参数max_memory 的设置原则是什么？以一个静态池为例，期望最大化利
用内存（同时避免溢出风险），是否该参数设为节点物理内存的值，包括swap
吗?
解决方法
max_memory 值指Large 堆内存的分配上限。
其值不应超过gnode 进程的最大
可用内存；
默认情况下：gnode 的最大可用内存为(系统内存+swap)*0.8。其中比率0.8 可
由gbase_memory_pct_target 参数调整。无论是否开启资源管理，只要比率设
置合理，不会引发系统OOM（Out of Memory）；
两种机制同时存在，
max_memory 值应小于gnode 的最大可用内存限制时才会
生效，反之则体现为不生效或不限制。
或者，
代理允许 JDBC applet 和实用程序从 LDAP 服务器获得它们的数据库连接信息。
如
果您打算使用此特性，则需要安装 LDAP 服务器。关于随同 GBase 8s JDBC Driver 使用
LDAP 服务器的通用信息，请参阅 连接属性语法 开始的主题。
下图说明代理如何与 LDAP 服务器系统工作。该图还展示如何从 sqlhosts 文件查找。要获
取更多信息，请参阅 指定 sqlhosts 文件查找。
图: 通过代理查找
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 54 -
代理 LDAP 特性需要 JNDI 类库和 LDAP 服务提供商文件（jndi.jar、
ldap.jar 和 providerutil.jar）。可从 www.oracale.com 下载这些 JAR 文件。
在下载并安装文件之后，在 web 服务器上将它们的完全路径名称添加至 CLASSPATH 设
置。这些文件在安装目录之下的 lib 目录中。
指定 LDAP 查找发生的位置
当随同其他 LDAP 关键字使用时，SQLH_LOC 关键字指示 LDAP 查找发生的位置。
SQLH_LOC 可有值 CLIENT 或 PROXY。如果该值为 CLIENT，则驱动程序在客户机侧执
行 LDAP 查找。如果该值为 PROXY，则代理在服务器侧执行查找。如果未指定值，则驱
动程序使用 CLIENT 作为缺省值。
这里是带有指定服务器侧 LDAP 查找的 LDAP 关键字的 applet 或应用程序 URL 的格
式：
jdbc:gbasedbt-sqli:gbasedbtserver=gbasedbt-server-name;
PROXY=proxy-hostname-or-ip-address:proxy-port-no?
PROXYTIMEOUT=60;SQLH_TYPE=LDAP;LDAP_URL=ldap:
//ldap-hostname-or-ip-address:ldap-port-no;LDAP_IFXBASE=dc=mydomain,dc=com;
SQLH_LOC=PROXY;
此示例从 LDAP 服务器获取数据库服务器主机名称和端口：
jdbc:gbasedbt-sqli:gbasedbtserver=samsara;SQLH_TYPE=LDAP;
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 55 -
LDAP_URL=ldap://davinci:329;LDAP_IFXBASE=cn=gbasedbt,
o=kmart,c=US;LDAP_USER=abcd;LDAP_PASSWD=secret;SQLH_LOC=PROXY;
PROXY=webserver:1462
要获取使用带有代理的 LDAP 服务器的完整示例，
请参阅安装 JDBC 驱动程序的 demo 目
录中的 proxy applet 和应用程序。
指定 sqlhosts 文件查找
当您正在使用代理时，SQLH_LOC 关键字也适用于 sqlhosts 文件查找。如果 URL 包括
SQLH_LOC=PROXY，则驱动程序读取服务器上的 sqlhosts文件。如果未指定 SQLH_LOC
=PROXY，则驱动程序读取客户机上的文件。
此示例从服务器上的 sqlhosts 获取信息：
jdbc:gbasedbt-sqli:gbasedbtserver=samsara;SQLH_TYPE=FILE;
SQLH_FILE=/work/9.x/etc/sqlhosts;SQLH_LOC=PROXY;
PROXY=webserver:1462