gbase数据、南大通用产品文档：GBase8a管理DBLink

对DBLink 的管理，包括配置gbGateway 信息、创建、删除、查询DBLink。
配置gbGateway 信息

配置GBase 8a MPP Cluster（local）要使用的gbGateway 信息。

GBase 8a 集群（local）使用的gbGateway 对外部数据源的名称和gbGateway
的对应关系。
说明
包含的内容如下：外部数据源的名称，gbGateway 的IP ，gbGateway 的端口号。
创建DBLink
在GBase 8a MPP Cluster(local) 上创建指向gbGateway 的DBLink。
Admin 可以通过
任何GBase 8a MPP Cluster（local）的应用程序，指向创建DBLink 的SQL 语句。
语法格式
CREATE
DATABASE LINK dblink_name CONNECT TO username IDENTIFIED BY
password USING ‘TG_config_name’;
说明
当前数据库服务下所有用户都可使用、删除该DB-Link；

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
601

dblink_name：要创建的DB-Link 的名称；

username：该DB-Link 要连接的数据库服务中的用户名；

password：该DB-Link 要连接的数据库服务中的用户名密码；

TG_config_name：透明网关配置文件名称。
示例
create database link dblink_pub
connect to sysdba identified by sys
using 'tg_config1';
删除DBLink
在GBase 8a MPP Cluster(local) 上删除指向gbGateway 的DBLink。
Admin 可以通过
任何GBase 8a MPP Cluster（local）的应用程序，指向删除DBLink 的SQL 语句。
语法格式
DROP DATABASE LINK dblink_name;
示例
drop database link dblink_pub;
查询DBLink
查看已经创建的所有dblink，每个dblink 的信息包含：

dblink_name：要创建的DB-Link 的名称

username：该DB-Link 要连接的数据库服务中的用户名

password：显示为NULL 值

TG_config_name：透明网关配置文件名称。

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™ 上的 $GBS_HOME/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 脚本位于 $GBS_HOME/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 实用程序
验证备份，并从归档恢复表级别数据。

创建和管理Consumer Group ................................... 475