更新日期：2024年09月11日
在 UNIX™，您可以使用 -FILE 选项运行 GBase 8s 中的某些实用程序 ，这些实用程序的
本地环境变量已设置在 onconfig 文件中。并且在运行命令去启动该实用程序时，不需设置
本地环境变量。
在启动以下实用程序时，您可以使用 -FILE 选项：oninit 、oncheck 、onclean 、onload 、
onunload 、onlog 、onmode 、onparams 、onspaces 、onstat 和 ontape 。
语法
-FILE 选项
元素
用途
关键注意事项
-FILE= file_name
指定包含环境信息的
-FILE=file_name 选项必须是该命令
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 340 -
元素
用途
关键注意事项
onconfig 文件的完整
路径或相对路径
的第一个参数
用法
在运行带有 -FILE 选项的命令之前，您必须在 onconfig 文件中按以下格式添加指令：
#$variable_name value
在 onconfig 文件中设置的环境变量优先于系统或 shell 中设置的相同的变量。
当启动带有 -FILE 选项的实用程序时，请指定 onconfig 文件的绝对路径或相对路径。例
如：以下示例都启动了环境信息在 serv1 的 onconfig 中的数据库服务器。
绝对路径
oninit -FILE=/opt/gbs_server/data/conf/onconfig
相对路径
oninit -FILE=conf/onconfig
如果 GBS_HOME 环境变量没有在用户的系统、shell 或 onconfig 文件中设置，GBS_HOME
的值将会设置到该执行程序的路径下（如果该执行程序在的 GBS_HOME 子目录下）。如果
您使用远程执行的形式（例如：ssh）， 请使用 -FILE 选项指定 onconfig 文件在远程电
脑上的路径。
示例
假设您在 onconfig 文件中为 js_3 实例指定了 DBDATE 和 SERVER_LOCALE 环境变量的
值：
#onconfig for js_3
#
# *** Start environment settings for js_3
#
#$DBDATE MDY4/
#$SERVER_LOCALE en_us.utf8
#
# *** End environment settings for js_3
其他有关运行该实用程序的重要的环境变量
（GBS_HOME）
在用户环境中被指定。
oninit 执
行程序的路径是用户环境的一部分并且 onconfig 文件也在当前目录下。
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 341 -
可以从当前目录下运行 oninit
-FILE=onconfig 命令去启动数据库服务器，它会自动设置
DBDATE 和 SERVER_LOCALE 环境变量的值。
功能描述
创建新的文本搜索配置。
一个文本搜索配置声明一个能将一个字符串划分成符号的文本
搜索解析器，加上可以用于确定搜索对哪些标记感兴趣的字典。
注意事项
若仅声明分析器，那么新的文本搜索配置初始没有从符号类型到词典的映射，因此会
忽略所有的单词。
后面必须调用ALTER TEXT SEARCH CONFIGURATION 命令创建映
射使配置生效。如果声明了COPY 选项，那么会自动拷贝指定的文本搜索配置的解析
器、映射、配置选项等信息。
若模式名称已给出，
那么文本搜索配置会在声明的模式中创建。
否则会在当前模式创建。
定义文本搜索配置的用户成为其所有者。
PARSER 和COPY 选项是互相排斥的，因为当一个现有配置被复制，其分析器配置也
被复制了。
若仅声明分析器，那么新的文本搜索配置初始没有从符号类型到词典的映射，因此会
忽略所有的单词。
语法格式
CREATE TEXT SEARCH CONFIGURATION name (
PARSER = parser_name |
COPY = source_config
) [ WITH ( {configuration_option = value} [, ...] )];
参数说明
name
要创建的文本搜索配置的名称。该名称可以有模式修饰。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1060
parser_name
用于该配置的文本搜索分析器的名称。
source_config
要复制的现有文本搜索配置的名称。
configuration_option
文本搜索配置的配置参数，
主要是针对parser_name 执行的解析器或者source_config 隐
含的解析器而言的。
取值范围：目前共支持default、ngram 两种类型的解析器，其中default 类型的解析器
没有对应的configuration_option、
ngram 类型解析器对应的configuration_option 如下表所示。
表14-1 ngram 类型解析器对应的配置参数
解析器
配置参数
参数描述
取值范围
ngram
gram_size
分词长度。
正整数，1~4
默认值：2
punctuation_ignore
是否忽略标点符号。
true（默认值）
：忽略
标点符号。
false：不忽略标点符
号。
grapsymbol_ignore
是否忽略图形化字
符。
true：忽略图形化字
符。
false（默认值）
：不忽
略图形化字符。
示例
--创建文本搜索配置。
gbase=#CREATE TEXT SEARCH CONFIGURATION ngram2 (parser=ngram) WITH (gram_size =
2, grapsymbol_ignore = false);
--创建文本搜索配置。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1061
gbase=#CREATE TEXT SEARCH CONFIGURATION ngram3 (copy=ngram2) WITH (gram_size =
2, grapsymbol_ignore = false);
--添加类型映射。
gbase=#ALTER TEXT SEARCH CONFIGURATION ngram2 ADD MAPPING FOR multisymbol WITH
simple;
--创建用户joe。
gbase=#CREATE USER joe IDENTIFIED BY 'xxxxxxxxx';
--修改文本搜索配置的所有者。
gbase=#ALTER TEXT SEARCH CONFIGURATION ngram2 OWNER TO joe;
--修改文本搜索配置的schema。
gbase=#ALTER TEXT SEARCH CONFIGURATION ngram2 SET SCHEMA joe;
--重命名文本搜索配置。
gbase=#ALTER TEXT SEARCH CONFIGURATION joe.ngram2 RENAME TO ngram_2;
--删除类型映射。
gbase=#ALTER TEXT SEARCH CONFIGURATION joe.ngram_2 DROP MAPPING IF EXISTS FOR
multisymbol;
--删除文本搜索配置。
gbase=#DROP TEXT SEARCH CONFIGURATION joe.ngram_2;
gbase=#DROP TEXT SEARCH CONFIGURATION ngram3;
--删除Schema 及用户joe。
gbase=#DROP SCHEMA IF EXISTS joe CASCADE;
gbase=#DROP ROLE IF EXISTS joe;
相关命令
ALTER TEXT SEARCH CONFIGURATION，DROP TEXT SEARCH CONFIGURATION