更新日期：2024年09月11日
使用 onpsm 实用程序可管理 GBase 8s 主存储管理器 目录、设备、锁定和对象。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 179 -
先决条件：要运行 onpsm 实用程序，您必须是 root 用户或 gbasedbt，或者是 bargroup 组的
成员。
语法
目录选项
设备选项
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 180 -
对象选项
池选项
表 1. onpsm 实用程序目录选项
元素
用途
重要注意事项
- C check
检查存储管理器目录表，这
些表用于存储有关存储管理
器所管理的池和设备的元数
据
此命令可识别有问题的文件。
- C check
-l
检查目录表时显示索引键
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 181 -
元素
用途
重要注意事项
- 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
import 命令。
- C init
删除存储管理器的目录表
- C init -
d
删除文件设备中的存储管理
器目录表和备份对象
- C unlock 对存储管理器目录解锁
如果存储管理器因为发生故障而从备份或恢
复会话异常退出，那么存储管理器目录表可
能会保持锁定。如果目录表处于锁定状态，
您可以释放这些锁定。
-y
指定在删除目录表之前不要
求确认
表 2. onpsm 实用程序设备选项
元素
用途
重要注意事项
-D add
将设备添加到 -g 选项指定
的池中
在添加设备前，收集有关设备的信息。请
参阅收集有关文件目录和设备的信息。
-D del
除去设备：
如果使用 -g 选项删除设备，可以根据
需要复原对象。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 182 -
元素
用途
重要注意事项
•
如果使用 -g 选项，
将从 -g 选项指定的
池中除去设备，而保
留 GBase 8s Primary
Storage Manager 目
录中的设备对象。
•
如果使用 -d 选项，
将从所有池中除去设
备，并从该设备中的文
件系统中除去所有备份
对象
如果除去设备，存储管理器将无法向该设
备添加新对象。
-D list
显示系统中所有设备的列表
-D purge
从 GBase 8s Primary
Storage Manager 目录中除去
缺少的存储管理器对象
-D scan
扫描设备中的对象以验
证 GBase 8s Primary
Storage Manager 目录中是否
存在这些对象，以便可以根据
需要复原这些对象
如果对象不在目录中，此命令
将向目录添加该对象。
如果命令无法向目录添加对象，此命令将
忽略缺少的文件。
要能够向目录添加缺少的对象，必须满足
以下条件：
•
该对象标识不能分配给存储管理器
中的其他任何对象。
•
文件不能重命名或重定位到设备内
部的其他目录中
•
该对象版本不能分配给存储管理器
中的其他任何对象。
-D update
修改有关设备的信息
如果要修改有关多个设备的信息，请针对
每个设备运行独立的命令。
path
设备（针对 TAPE 设备）或目
录（针对 FILE 设备）的全名
和路径
路径的格式必须适合设备连接到的操作系
统。
设备的名称在池中必须唯一。
您可以在多个池中包含相同的设备。
如果要删除、列出、清除、扫描或更新信
息，路径必须是现有设备的路径。
-
b block_si
ze
（仅限磁带设备）向设备写入
数据前需要积累的数据的最小
字节数
块大小对于磁带设备是必需的。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 183 -
元素
用途
重要注意事项
-d
从所有池中删除池并删除备份
对象
块大小对于磁带设备是必需的。
-
g pool_nam
e
要将设备添加到的池，即
DBSPOOL、LOGPOOL 或 EXTPOOL
有关池的信息存储在 GBase 8s Primary
Storage Manager 目录中。
如果未提供池名称，命令将失败。
指定：
•
用于备份数据库空间、Blob 空间
和智能大对象空间的 DBSPOOL
•
用于备份逻辑日志的 LOGPOOL
•
用作登台区域的 EXTPOOL，从中可
以将特定备份或备份生成移至永久
存储器或移至其他计算机上。
-
l dev_def_
file.txt
从设备定义文件装入有关设备
的信息
-
p priority
设备的优先级，即 HIGHEST、
HIGH、LOW 或 READ-ONLY
存储管理器会先填满池中的高优先级设
备，然后再将数据放入该池中的低优先级
设备。 当存储管理器准备填充池时，如
果高优先级设备繁忙，那么存储管理器会
使用低优先级设备。
池中只能有一个设备的优先级可以为
HIGHEST。
如果在同一池中多个设备具有相同的优先
级，存储管理器将确定要首先使用的设
备。
设备变满时，存储管理器会将其优先级更
改为 READ-ONLY。 向设备添加更多空间
后，可以更改优先级。
-s size
（仅限磁带设备）设备的最大
存储容量（以千字节为单位）
该大小对于磁带设备是可选的。如果未指
定大小，或指定为 0，那么存储管理器
会将大小解释为无限制。当大小为无限制
时，只有设备返回错误以指定设备已满
时，才会将设备视为已满。
要指定大小，请输入大小的数字值，后跟
后缀 B、K、M、G、T 或 P（分别表示字
节、千字节、兆字节、千兆字节、太字节
或皮特字节）。后缀可以是大写，也可以
是小写。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 184 -
元素
用途
重要注意事项
- 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
显示池中的所有对象
对于每个对象，该列表包含创建对象的日
期和时间、对象的大小和对象的路径名。
-y
指定不要求确认完成请求的
操作。
表 4. onpsm 池选项
元素
用途
重要注意事项
-P
add pool_name
添加新池
P
del pool_name
删除指定的池
-P list
列出系统中的所有池
-y
指定不要求确认完成请求的
操作。
表 5. onpsm 实用程序一般选项
元素
用途
重要注意事项
-h
显示帮助信息
-V
显示软件版本号和序列号
有关标准 GBase 8s -V 和 -
version 选项的更多详细信息，请参阅
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 185 -
元素
用途
重要注意事项
《GBase 8s 管理员参考》中的获取实用程
序的版本信息。
-version
显示软件版本号、序列号和
其他信息，例如主机、操作
系统、构建日期和 Global
Language Support (GLS) 版
本
有关标准 GBase 8s -V 和 -
version 选项的更多详细信息，请参阅
《GBase 8s 管理员参考》中的获取实用程
序的版本信息。
-version
all
显示 onpsm 版本信息和有
关 PSM 共享库的信息
用途
当您运行 onpsm 命令来定义设备时，如果不存在存储管理器目录，那么存储管理器会自动
创建这些目录。
存储管理器的缺省设备为 $GBS_HOME/backups。此低优先级设备在创建目录时会自动创
建。您可以除去缺省设备。
创建设备时，如果该设备的目录不存在，存储管理器将自动创建该目录。存储管理器将使
用 onpsm -D add 命令中指定的目录路径。
可以使用单一命令来删除一个或多个对象，例如，通过运行以下格式的命令：
onpsm _O del -o obj_1 -o obj_2
还可以使用单一命令来转储一个或多个对象，例如，通过运行以下格式的命令：
onpsm _O dump -o obj_1 -o obj_2
如果不需要数据，请运行 onsmsync 实用程序来从 GBase 8s Primary Storage Manager 删除
备份对象。
有些第三方存储管理器不允许 onsmsync 实用程序从存储管理器删除备份对象。如果您有
第三方存储管理器，那么可能需要手动删除不再需要的备份对象。
示例
以下命令在 DBSPOOL 池中添加路径名为 $GBS_HOMEbackups 的文件设备：
onpsm -D add $GBS_HOME/backups -g DBSPOOL -t FILE -p HIGH
以下命令检查 GBase 8s Primary Storage Manager 目录表，并指示存储管理器不修正检查期
间发现的任何错误：
onpsm -C check -n
以下命令列出池中的对象，包含创建对象的日期和时间、对象的大小和对象的路径名。
onpsm -O list
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 186 -
取值：[0|3|5]
默认值：5
说明：老版参数，用于指定老版本的字符型压缩方法。
这个参数用于控制字符串类型（如：VARCHAR，CHAR...）的压缩方式。
可选的压缩方式有：
0 - 轻量级压缩；
3 - PPM 压缩（压缩速度快，解压速度慢）；
5 - RAPIDZ 压缩
（相对于31 算法而言，
可以提供更好的数据吞吐能力
（IO+
解压），适用于对性能要求较高的用户场合。）。
该参数的默认值是5。
修改方式：可在配置文件中修改值。适用于global 范围。
GBase 8a MPP Cluster 参数手册
文档版本2022-06-07
南大通用数据技术股份有限公司
91
GBase 8a MPP Cluster 参数手册
文档版本2022-06-07
南大通用数据技术股份有限公司
92
9 数据导出相关参数