更新日期：2024年09月11日
ON-Bar 组件包含命令行实用程序、目录表、活动日志和紧急引导文件。请将 ON-Bar 与存
储管理器及其 XBSA 共享库一起使用。
下图显示了 ON-Bar 和数据库服务器组件：
数据库服务器中的存储空间（数据库空间、Blob 空间和智能大对象空间）以及逻
辑日志
sysutils 数据库，其中包含 ON-Bar 目录表
onbar 和 onbar-d 命令行实用程序
系统上存储管理器的 XBSA 共享库
用于存储备份的存储介质
ON-Bar 活动日志
ON-Bar 紧急引导文件
图: GBase 8s 的 ON-Bar 组件
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 19 -
ON-Bar 与数据库服务器和存储管理器进行通信。请使用 onbar 命令启动备份或恢复操作。
缺省情况下，ON-Bar 以并行方式备份和恢复存储空间。ON-Bar 始终以串行方式处理日志
文件。
对于备份会话，ON-Bar 从数据库服务器请求存储空间和逻辑日志的内容，并将它们传递到
存储管理器。存储管理器将数据存储在存储介质上。对于恢复会话，ON-Bar 从存储管理器
请求已备份的数据，然后在数据库服务器上恢复该数据。
ON-Bar 首先备份关键数据库空间，接着是剩余存储空间，最后备份逻辑日志。关键数据库
空间是 rootdbs 以及包含逻辑日志和物理日志的数据库空间。
ON-Bar 还会在备份期间将以下关键文件放到归档中：
onconfig 文件
sqlhosts 文件
oncfg_servername.servernum 文件
ON-Bar 紧急引导文件：ixbar.servernum
您可以恢复存储在原始文件和格式化文件中的存储空间。如果系统包含主存储空间和镜像
存储空间，那么恢复（外部恢复除外）期间 ON-Bar 将同时写入主块和镜像块。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 20 -
ON-Bar 状态和错误消息将写入活动日志文件 bar_act.log 中。
备份服务 API (XBSA)
ON-Bar 和存储管理器通过“备份服务应用程序编程接口 (XBSA)”通信，该接口支持存储
管理器为数据库服务器管理介质。
通过使用存储管理器的开放式系统接口，
ON-Bar 可以与
各种同样使用 XBSA 的存储管理器一起工作。
每个存储管理器建立并分配一个唯一版本的 XBSA 共享库。必须使用随存储管理器提供
的 XBSA 共享库版本。
例如，
如果使用 GBase 8s 主存储管理器，
那么还必须使用 ON-Bar
提供的 XBSA 共享库。ON-Bar 和 XBSA 共享库必须以相同方式（32 位或 64 位）进行
编译。例如，如果使用 Storage Manager，那么还要使用 ON-Bar 提供的 XBSA 共享库。
ON-Bar 和 XBSA 共享库必须以相同方式（32 位或 64 位）进行编译。
ON-Bar 使用 XBSA 与存储管理器交换以下类型的信息：
控制数据
ON-Bar 与存储管理器交换控制数据以验证 ON-Bar 和 XBSA 是否兼容，
并确保以正
确顺序将对象恢复到数据库服务器的正确实例，以及跟踪备份对象的历史记录。
备份或恢复数据
在备份与恢复期间，ON-Bar 和存储管理器使用 XBSA 交换来自指定存储空间或逻辑
日志文件的数据。
ON-Bar 使用 XBSA 事务来确保数据的一致性。包含在一个事务中的所有操作被看作是一
个单元。一个事务中的所有操作必须成功，才能恢复传送给存储管理器的对象。
ON-Bar 目录表
ON-Bar 使用 sysutils 数据库中的目录表来跟踪备份与恢复操作。 onsmsync 实用程序使
用其他目录表来跟踪其操作。
ON-Bar 在 sysutils 数据库中使用以下目录表来跟踪备份与恢复操作：
bar_server 表跟踪数据库服务器的实例。
bar_object 表跟踪备份对象。 备份对象是数据库空间、Blob 空间、智能大对象空
间或逻辑日志文件的备份。
bar_action 表跟踪所有对每个备份对象进行的备份与恢复尝试，
除了某些日志回收
和冷恢复事件以外。
bar_instance 表描述在成功的备份尝试中备份的每个对象。
onsmsync 实用程序使用并维护以下各表来跟踪其操作：
bar_ixbar 表包含所有时间线中所有未到期的成功备份的历史记录。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 21 -
bar_syncdeltab 表通常为空，但 onsmsync 正在运行时除外。
有关这些表内容的描述，请参阅 ON-Bar 目录表。
ixbar 文件：ON-Bar 紧急引导文件
每次备份后会自动更新紧急引导文件。该文件包含 ON-Bar 执行冷恢复所需的信息。
重要： 请勿修改紧急引导文件。如果进行了修改，将可能导致 ON-Bar 选择错误的备份作为恢
复的一部分，这可能会引起数据损坏或系统故障。
引导文件的文件名是 ixbar.servernum，其中 servernum 是 SERVERNUM 配置参数的值。
ON-Bar 紧急引导文件位于 UNIX™ 上的 $GBASEDBTDIR/etc 目录中。您可以更改
BAR_IXBAR_PATH 配置参数中指定的信息，从而覆盖引导文件的缺省路径和名称。
bar_act.log 文件：ON-Bar 活动日志
ON-Bar 将参考、进度、警告、错误和调试消息写入 ON-Bar 活动日志 bar_act.log 中。
ON-Bar 备份和恢复错误不会出现在标准输出中。
如果在您备份和恢复数据时发生错误，
请
检查 ON-Bar 活动日志中的信息
还可以使用活动日志进行以下操作：
监视备份与恢复活动，例如，活动日志还将记录哪些存储空间和逻辑日志已备份或
已恢复、操作的进度以及大致花了多长时间。
验证备份或恢复是否成功。
跟踪 ondblog 实用程序中的错误。
跟踪 ON-Bar 性能统计信息
ON-Bar 活动日志位于 UNIX™ 上的 /tmp 目录中。使用 BAR_ACT_LOG 配置参数指定
ON-Bar 活动日志的位置。
ON-Bar 脚本
ON-Bar 实用程序在 UNIX™ 上包含一个 shell 脚本，用于定制备份与恢复操作。
当您随数据库服务器安装 ON-Bar 时，
将包含一个缺省脚本。
该脚本的名称和位置取决于操
作系统：
UNIX
onbar shell 脚本位于 $GBASEDBTDIR/bin 目录中。
当从命令行发出 ON-Bar 命令时，自变量会传递给脚本，然后传递给 onbar_d 实用程序。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 22 -
表 1. ON-Bar 实用程序
实用程序
描述
onbar_d 实用程序
在数据库服务器和存储管理器之间传输数据。
onbar 命令会调用 onbar_d 实用程序，以启
动 onbar-driver。 onbar-driver 启动并控制备份与恢复活
动。
onsmsync 实用程序
同步 sysutils 数据库、紧急引导文件和存储管理器目录的内
容。使用此实用程序以清除不再需要的备份。
ondblog 实用程序
更改数据库日志记录方式。ondblog 实用程序将其输出记录
到 ON-Bar 活动日志 bar_act.log 中。
archecker 实用程序
验证备份，并从归档恢复表级别数据。
SHOW CREATE SYNONYM
功能说明
显示给定的私有同义词的创建语句。
语法格式
SHOW CREATE SYNONYM [vc_name.][database_name.]syn_name;
表5- 130 参数说明
参数名称
说
明
vc_name
vc 名，可选项。
GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1124
参数名称
说
明
database_name
数据库名，可选项。
syn_name
同义词名。
示例
示例1：查看私有同义词s1 的创建语句：
gbase> create synonym s1 for demo.t1;
Query OK, 0 rows affected (Elapsed: 00:00:00.04)
gbase> show create synonym vc1.demo.s1;
+-------------+--------------------------------------------+
| Synonym
| Create synonym
|
+-------------+--------------------------------------------+
| vc1.demo.s1 | CREATE SYNONYM vc1.demo.s1 FOR vc1.demo.t1 |
+-------------+--------------------------------------------+
1 row in set (Elapsed: 00:00:00.00)