gbase数据、南大通用产品文档：GBase8s使用 ONBar 备份

您可以使用 ON-Bar 实用程序来备份并验证存储空间（数据库空间、Blob 空间和智能大对
象空间）以及逻辑日志文件。
要使用 ON-Bar 执行备份：
1. 准备备份。
2. 使用 ON-Bar 备份
3. 监视备份进度。
4. 验证备份。

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 36 -
5. 备份存储管理器信息。
您可以在 shell 或批处理脚本中定制 ON-Bar 和存储管理器命令。可以从作业调度程序调
用 ON-Bar。

该参数用于控制查看表结构或者导出表结构时，输出的列名大小写显示。
说明

默认值为0，列名输出格式与建表时的输入格式一致。

值为1 时，把列名转换成小写格式输出。

值为2 时，把列名转换成大写格式输出。

集群单机均适用。

支持的范围如下：
show create table/view
desc table_name
show column
show index
information_schema.columns 列名字段
gcdump 导出表结构。

GBase 8a MPP Cluster 产品手册
6 附录
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1596

用户自定义检查项
(1)
新增巡检项配置，修改script/gspylib/inspection/config/items.xml 文件，格式如下：



StandardCPUIdle=30;
StandardWIO=30



GBase 8c 工具参考手册
南大通用数据技术股份有限公司
89
如果idle 不足CPU 负载过高，请扩容CPU 节点，如果iowait 过高，则磁盘为瓶颈，
更换高性能磁盘


检查主机CPU 占用率，如果idle 大于30%并且iowait 小于30%，则检查项通过，否
则检查项不通过

os
user
all
default


id：巡检项id。

name：巡检项脚本名，和巡检项脚本文件名相同。

title: 巡检项描述名称（支持多语言）。

：中文版检查内容。

：英文版检查内容。

standard：巡检项标准说明（支持多语言）。

suggestion：巡检项修复建议说明（支持多语言）。

threshold：巡检项阈值定义，多值之间使用分号隔开，示例Key1=Value1;Key2=Value2。

category：巡检项分类，可选参数：os，device，network，cluster，database，other。

permission：巡检项需要的执行权限，可选参数：root，user 默认为user（普通用户）。

scope：巡检项执行的节点范围，可选参数：cn-仅在数据库主节点执行，local-仅在当前
节点执行，all-在GBase 8c 所有节点执行，默认为all。

analysis：巡检项执行结果分析方式，default-检查每个节点的结果，所有节点检查项通
过，
则最终检查通过，
consistent-openGauss 内所有节点一致性检查，
单节点仅返回结果，
各个节点结果一致则判定检查通过，custom-自定义结果分析方式，默认为default。

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
90

用户需自行保证自定义xml 的正确性
(2)
新建检查脚本，脚本名称格式遵循CheckXXXX.py，必须以Check 开头，脚本放置在
script/gspylib/inspection/items 目录下，该目录下脚本安装巡检项分类组织，每个分类一
个单独的文件夹，巡检项脚本放置在对应的分类文件夹中。格式如下：
class CheckCPU(BaseItem):
def __init__(self):
super(CheckCPU, self).__init__(self.__class__.__name__)
self.idle = None
self.wio = None
self.standard = None
def preCheck(self):
# check the threshold was set correctly
if (not self.threshold.has_key('StandardCPUIdle')
or not self.threshold.has_key('StandardWIO')):
raise Exception("threshold can not be empty")
self.idle = self.threshold['StandardCPUIdle']
self.wio = self.threshold['StandardWIO']
# format the standard by threshold
self.standard = self.standard.format(idle=self.idle, iowait=self.wio)
def doCheck(self):
cmd = "sar 1 5 2>&1"
output = SharedFuncs.runShellCmd(cmd)
self.result.raw = output
# check the result with threshold
d = next(n.split() for n in output.splitlines() if "Average" in n)
iowait = d[-3]
idle = d[-1]
rst = ResultStatus.OK
vals = []
if (iowait > self.wio):
rst = ResultStatus.NG
vals.append("The %s actual value %s is greater than expected value %s" % ("IOWait",
iowait, self.wio))
if (idle < self.idle):
rst = ResultStatus.NG

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
91
vals.append("The %s actual value %s is less than expected value %s" % ("Idle",
idle, self.idle))
self.result.rst = rst
if (vals):
self.result.val = "\n".join(vals)
所有脚本基于BaseItem 基类开发，基类定义的通用的检查流程，通用的检查结果分析
方法，默认的结果输出格式。可扩展方法：

doCheck: 该方法包含该检查项具体的检查方法，检查结果格式如下：
result.rst — 检查结果状态，可选参数:

OK -- 检查项完成，结果通过。

NA -- 当前节点不涉及该检查项。

NG -- 检查项完成，结果不通过。

WARNING -- 检查项完成，结果警告。

ERROR -- 检查项发生内部错误，未完成检查。

preCheck: 检查前条件判定，内置两种实现：

cnPreCheck -- 用于检查当前执行节点是否包含数据库主节点实例，

localPreCheck -- 用于检查当前执行节点是否指定节点。可通过巡检项配置文件中
的scope 参数进行配置。可重载该方法实现自定义的前置检查

postAnalysis：检查结果分析方法，内置两种实现：default、consistent。可通过巡检项配
置文件中的analysis 参数进行配置。可重载该方法实现自定义的结果分析。

用户自定义的检查项名称不得与已有检查项名称相同，
同时用户需保证自定义检查
项脚本的规范性。
(3)
将此脚本分发至所有的执行节点。
(4)
以gbase 用户登录，执行以下命令，查看结果。

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
92
本地执行：
gs_check -i CheckXXX
-L
非本地执行：
gs_check
-i
CheckXXX