gbase数据、南大通用产品文档：GBase8c

主要功能
gs_dump 可以创建四种不同的导出文件格式，通过[-F 或者--format=]选项指定，具体如
表3-9 所示。
表3-9 导出文件格式
格式名
称
-F 的
参数值
说明
建议
对应导入工具
纯文本
格式
p
纯文本脚本文件包含
SQL 语句和命令。命令
可以由gsql 命令行终端
程序执行，用于重新创
建数据库对象并加载表
数据。
小型数据库，
一
般推荐纯文本
格式。
使用gsql 工具恢复数
据库对象前，可根据
需要使用文本编辑器
编辑纯文本导出文
件。
自定义
归档格
式
c
一种二进制文件。支持
从导出文件中恢复所有
或所选数据库对象。
中型或大型数
据库，
推荐自定
义归档格式。
使用gs_restore 可
以选择要从自定义归
档导出文件中导入相

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
129
格式名
称
-F 的
参数值
说明
建议
对应导入工具
应的数据库对象。
目录归
档格式
d
该格式会创建一个目
录，该目录包含两类文
件，一类是目录文件，
另一类是每个表和blob
对象对应的数据文件。
——
tar 归档
格式
t
tar 归档文件支持从导出
文件中恢复所有或所选
数据库对象。tar 归档格
式不支持压缩且对于单
独表大小应小于8GB。
——

可以使用gs_dump 程序将文件压缩为目录归档或自定义归档导出文件，减少导出
文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。
gs_dump 程序无法压缩已归档导出文件。
注意事项

禁止修改导出的文件和内容，否则可能无法恢复成功。

为了保证数据一致性和完整性，
gs_dump 会对需要转储的表设置共享锁。
如果表在别的
事务中设置了共享锁，
gs_dump 会等待锁释放后锁定表。
如果无法在指定时间内锁定某
个表，转储会失败。用户可以通过指定--lock-wait-timeout 选项，自定义等待锁超时时
间。

不支持加密导出存储过程和函数。

db-link 查询的语法约束................................. 8


GBase 8a MPP Cluster 透明网关手册
南大通用数据技术股份有限公司
- 1 -
前言
手册简介
GBase 8a MPP Cluster 透明网关手册主要为用户介绍了透明网关的配置，
使用方法，通过阅读本手册，用户可以了解并掌握透明网关的安装、部署的操
作步骤。
第一章对透明网关工具进行了概要性描述。
第二章介绍了使用透明网关的前提条件和集群中配置透明网关。
第三章介绍了如何部署透明网关的相关内容。
第四章介绍了如何配置透明网关的相关内容。
第五章介绍了如何启停透明网关的相关内容。
第六章介绍了如何卸载透明网关的相关内容。
第七章通过一个实际案例，为用户演示透明网关的安装、部署。
公约
下面的文本约定用于本文档：
约
定
说
明
加粗字体
表示文档标题
大写英文（SELECT）
表示GBase 8a MPP Cluster 关键字
等宽字体
表示代码示例
…
表示被省略的内容。

GBase 8a MPP Cluster 透明网关手册
- 2 -
南大通用数据技术股份有限公司
1 GBase 集群透明网关简介
GBase 集群透明网关的主要作用是在GBase 集群里直接访问其它GBase 集
群或者oracle 数据库。GBase 集群透明网关服务获取db-link 的请求信息，根
据请求将数据抽取到GBase 集群中。

使用 onpsm 实用程序可管理 GBase 8s 主存储管理器 目录、设备、锁定和对象。
先决条件：要运行 onpsm 实用程序，您必须是 root 用户或 gbasedbt，或者是 bargroup 组的
成员。
语法

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 178 -

目录选项

设备选项

对象选项

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 179 -

池选项

表 1. onpsm 实用程序目录选项
元素
用途
重要注意事项
- C check
检查存储管理器目录表，这些
表用于存储有关存储管理器
所管理的池和设备的元数据
此命令可识别有问题的文件。
- C check
-l
检查目录表时显示索引键

- C check
-n
指示存储管理器不修正发现
的错误

- C detail 显示有关存储管理器目录表
的详细信息

- C export 将 GBase 8s Primary
Storage Manager 目录表导
出到名
为 psm_catalog.exp 的目
录

- C import 将当前 GBase 8s Primary
Storage Manager 目录替换
为从 psm_catalog.exp 目
录中的文件重新创建的目录。
仅当发生系统问题、丢失当前目录以及需要
还原到导出的目录时，
才应导入目录。
如果
需要导入目录，请先运行 onpsm -C
init 命令，然后再运行onpsm -C

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 180 -
元素
用途
重要注意事项
import 命令。
- C init
删除存储管理器的目录表

- C
init
-d 删除文件设备中的存储管理
器目录表和备份对象

- C unlock 对存储管理器目录解锁
如果存储管理器因为发生故障而从备份或恢
复会话异常退出，那么存储管理器目录表可
能会保持锁定。如果目录表处于锁定状态，
您可以释放这些锁定。
-y
指定在删除目录表之前不要
求确认

表 2. onpsm 实用程序设备选项
元素
用途
重要注意事项
-D add
将设备添加到 -g 选项指定
的池中
在添加设备前，收集有关设备的信息。请
参阅收集有关文件目录和设备的信息。
-D del
除去设备：

如果使用 -g 选项，
将从 -g 选项指定的
池中除去设备，而保
留 GBase 8s Primary
Storage Manager 目录
中的设备对象。

如果使用 -d 选项，
将从所有池中除去设
备，并从该设备中的文
件系统中除去所有备份
对象
如果使用 -g 选项删除设备，可以根据
需要复原对象。
如果除去设备，存储管理器将无法向该设
备添加新对象。
-D list
显示系统中所有设备的列表

-D purge
从 GBase 8s Primary Storage
Manager 目录中除去缺少的存
储管理器对象

-D scan
扫描设备中的对象以验
证 GBase 8s Primary Storage
Manager 目录中是否存在这些
对象，以便可以根据需要复原这
如果命令无法向目录添加对象，此命令将
忽略缺少的文件。
要能够向目录添加缺少的对象，必须满足

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 181 -
元素
用途
重要注意事项
些对象
如果对象不在目录中，此命令将
向目录添加该对象。
以下条件：

该对象标识不能分配给存储管理器
中的其他任何对象。

文件不能重命名或重定位到设备内
部的其他目录中

该对象版本不能分配给存储管理器
中的其他任何对象。
-D update
修改有关设备的信息
如果要修改有关多个设备的信息，请针对
每个设备运行独立的命令。
path
设备（针对 TAPE 设备）或目录
（针对 FILE 设备）的全名和路
径
路径的格式必须适合设备连接到的操作系
统。
设备的名称在池中必须唯一。
您可以在多个池中包含相同的设备。
如果要删除、列出、清除、扫描或更新信
息，路径必须是现有设备的路径。
-b block_s
ize
（仅限磁带设备）向设备写入数
据前需要积累的数据的最小字
节数
块大小对于磁带设备是必需的。
-d
从所有池中删除池并删除备份
对象
块大小对于磁带设备是必需的。
-g pool_na
me
要将设备添加到的池，即
DBSPOOL、LOGPOOL 或 EXTPOOL
有关池的信息存储在 GBase 8s Primary
Storage Manager 目录中。
如果未提供池名称，命令将失败。
指定：

用于备份数据库空间、
Blob 空间和
智能大对象空间的 DBSPOOL

用于备份逻辑日志的 LOGPOOL

用作登台区域的 EXTPOOL，从中可
以将特定备份或备份生成移至永久
存储器或移至其他计算机上。
-l dev_def
_file.txt
从设备定义文件装入有关设备
的信息

-p priorit
y
设备的优先级，即 HIGHEST、
HIGH、LOW 或 READ-ONLY
存储管理器会先填满池中的高优先级设
备，然后再将数据放入该池中的低优先级
设备。 当存储管理器准备填充池时，如果

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 182 -
元素
用途
重要注意事项
高优先级设备繁忙，那么存储管理器会使
用低优先级设备。
池中只能有一个设备的优先级可以为
HIGHEST。
如果在同一池中多个设备具有相同的优先
级，存储管理器将确定要首先使用的设备。

设备变满时，存储管理器会将其优先级更
改为 READ-ONLY。 向设备添加更多空间
后，可以更改优先级。
-s size
（仅限磁带设备）设备的最大存
储容量（以千字节为单位）
该大小对于磁带设备是可选的。如果未指
定大小，或指定为 0，那么存储管理器会
将大小解释为无限制。当大小为无限制时，
只有设备返回错误以指定设备已满时，才
会将设备视为已满。
要指定大小，请输入大小的数字值，后跟
后缀 B、K、M、G、T 或 P（分别表示字节、
千字节、兆字节、千兆字节、太字节或皮
特字节）。后缀可以是大写，也可以是小
写。
- t type
设备的类型，可以是 FILE 或
TAPE
有关设备的信息存储在 GBase 8s
Primary Storage Manager 目录中。
-u
将有关设备的信息卸载到设备
定义文件
设备定义文件是一个具有特定格式的文本
文件。使用装入选项运行 onpsm命令时，
存储管理器会使用该文件重新创建信息。
-y
指定不要求确认完成请求的操
作

表 3. onpsm 对象选项
元素
用途
重要注意事项
-O del
从池删除物理对象

-O detail
显示有关指定对象的详细信
息。详细信息包括对象的位
置。

-O dump
将对象数据抽取到当前目录
中的某个文件

- o object_id 标识特定对象
可以使用单一命令来删除或转储一个或多
个对象，如用途中所示。
-O list
显示池中的所有对象
对于每个对象，该列表包含创建对象的日

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 183 -
元素
用途
重要注意事项
期和时间、对象的大小和对象的路径名。
-y
指定不要求确认完成请求的
操作。

表 4. onpsm 池选项
元素
用途
重要注意事项
-P
add pool_name
添加新池

P
del pool_name
删除指定的池

-P list
列出系统中的所有池

-y
指定不要求确认完成请求的
操作。

表 5. onpsm 实用程序一般选项
元素
用途
重要注意事项
-h
显示帮助信息

-V
显示软件版本号和序列号
有关标准 GBase
8s -V 和 -version 选项的更多详细
信息，请参阅《GBase
8s 管理员参考》中的
获取实用程序的版本信息。
-version
显示软件版本号、序列号和其
他信息，
例如主机、
操作系统、
构建日期和 Global Language
Support (GLS) 版本
有关标准 GBase
8s -V 和 -version 选项的更多详细
信息，请参阅《GBase
8s 管理员参考》中的
获取实用程序的版本信息。
-version
all
显示 onpsm 版本信息和有
关 PSM 共享库的信息

用途
当您运行 onpsm 命令来定义设备时，如果不存在存储管理器目录，那么存储管理器会自动
创建这些目录。
存储管理器的缺省设备为 $GBASEDBTDIR/backups。此低优先级设备在创建目录时会自动
创建。您可以除去缺省设备。
创建设备时，如果该设备的目录不存在，存储管理器将自动创建该目录。存储管理器将使
用 onpsm -D add 命令中指定的目录路径。
可以使用单一命令来删除一个或多个对象，例如，通过运行以下格式的命令：
onpsm _O del -o obj_1 -o obj_2
还可以使用单一命令来转储一个或多个对象，例如，通过运行以下格式的命令：

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 184 -
onpsm _O dump -o obj_1 -o obj_2
如果不需要数据，请运行 onsmsync 实用程序来从 GBase 8s Primary Storage Manager 删除备
份对象。
有些第三方存储管理器不允许 onsmsync 实用程序从存储管理器删除备份对象。
如果您有第
三方存储管理器，那么可能需要手动删除不再需要的备份对象。

示例
以下命令在 DBSPOOL 池中添加路径名为 $INFOMRIXDIR/backups 的文件设备：
onpsm -D add $GBASEDBTDIR/backups -g DBSPOOL -t FILE -p HIGH
以下命令检查 GBase 8s Primary Storage Manager 目录表，并指示存储管理器不修正检查期
间发现的任何错误：
onpsm -C check -n
以下命令列出池中的对象，包含创建对象的日期和时间、对象的大小和对象的路径名。
onpsm -O list